Huoshui File Search

Wraps macOS Spotlight's mdfind command to let Claude search your filesystem with the same power you'd get from the terminal. Exposes a single search_files tool that takes queries in Spotlight syntax (kind:pdf, kMDItemFSName wildcards, date filters) and returns JSON results. You can scope searches to specific directories, sort by name/size/date, apply regex filters to filenames, and limit result counts up to 1000. Built on FastMCP and only works on macOS 10.15 or later. Useful when you need Claude to locate files by content, metadata, or patterns without writing custom filesystem traversal code. The mdfind backend means searches are fast and leverage your existing Spotlight index.