Huoshui File Search
Give your agent fast macOS Spotlight search so it can find project files without you pasting paths.
Overview
huoshui-file-search is a MCP server for the Build phase that provides fast macOS Spotlight file search to coding agents.
What is this MCP server?
- Fast Spotlight-backed file search for macOS via MCP
- PyPI package huoshui-file-search with stdio transport
- Version 1.0.0 in server.json schema metadata
- Reduces manual path hunting during agent-led coding sessions
- PyPI identifier huoshui-file-search version 1.0.0
- stdio transport declared in server manifest
- macOS Spotlight search capability stated in server description
What problem does it solve?
Agents cannot see your Mac filesystem layout, so you keep copying paths manually when files live outside the open workspace.
Who is it for?
Mac-based solo builders who want OS-wide file discovery inside MCP without building custom AppleScript glue.
Skip if: Windows or Linux developers, or teams that only need in-repo search and never index local files outside the project.
What do I get? / Deliverables
Your agent can query Spotlight from MCP sessions and jump to the right files faster during build and debug work.
- Spotlight query results returned inside agent chats
- Faster resolution of file paths on the local Mac
- Less context switching to Finder during implementation
Recommended MCP Servers
Journey fit
Canonical shelf is Build → agent-tooling because the server extends what your coding agent can do on the developer machine. Agent-tooling is the right facet for OS-level search hooks that speed implementation and debugging on Mac.
How it compares
macOS Spotlight MCP bridge, not a cross-platform ripgrep or cloud drive search integration.
Common Questions / FAQ
Who is huoshui-file-search for?
Indie developers on macOS using MCP agents who need quick discovery of files across the machine, not only the open repo.
When should I use huoshui-file-search?
Use it during Build when configs, downloads, or assets live outside your workspace and Spotlight knows their names or metadata.
How do I add huoshui-file-search to my agent?
Install huoshui-file-search from PyPI, register the stdio MCP server in your client, and run on a Mac with Spotlight indexing enabled.