Huoshui MCP Server

An MCP server that provides fast Spotlight file search capabilities for macOS. The huoshui mcp server wraps that behind the Model Context Protocol, so an assistant can use it rather than through you.

What it actually does

A Desktop Extension (DXT) that provides fast file search capabilities for macOS using the native mdfind command (Spotlight search).

• Fast file search using macOS Spotlight index
• Multiple filtering options:
• Path-based search restrictions
• Case-sensitive/insensitive search
• Regular expression matching
• Sort results by name, size, or date

Adding it to your client

The server ships on PyPI as huoshui-file-search, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Caveats

• It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
• MCP clients confirm each tool call by default. Leave that on until you have watched what the huoshui mcp server does with a few real requests.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by huoshuiai42; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Huoshui's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.