mamertofabian/mcp-everything-search
Free在 Windows 上使用 Everything SDK 快速搜索文件。 (Awesome列表更通用)
FreeFree tier
About mamertofabian/mcp-everything-search
An MCP server that provides fast, cross-platform file searching capabilities. On Windows, it leverages the Everything SDK for instant searches with advanced syntax support. On macOS, it uses the built-in mdfind command to query the Spotlight database. On Linux, it relies on the locate/plocate command. The server exposes a single search tool with configurable parameters such as query string, maximum results, match options (path, case, whole word, regex), and sort order. Responses include file/folder path, file size in bytes, and last modified date.
Key Features
Search files and folders across Windows, macOS, and Linux
Windows: Full Everything SDK search syntax support (regex, ext:, datemodified:, etc.)
macOS: Uses built-in mdfind Spotlight search
Linux: Uses locate/plocate command
Configurable search parameters: max_results, match_path, match_case, match_whole_word, match_regex
Sort results by filename, path, size, extension, creation date, or modification date in ascending or descending order
Returns file path, file size (bytes), and last modified date
Install via uvx (no installation needed), pip, or Smithery for Claude Desktop
Open source (MIT license implied by public repo)
Pros & Cons
Pros
- Cross-platform support covering Windows, macOS, and Linux
- On Windows, uses the powerful Everything SDK for near-instant searches
- No additional setup required on macOS
- Supports advanced search syntax (regex, date filters, ext filters) on Windows
- Flexible sorting and filtering options (match path, case, whole word)
- Easy to install and run with uv or pip
- Open source and free
Cons
- On Linux, requires locate/plocate to be installed and database updated (may not be real-time)
- On macOS, relies on Spotlight index which may not include all locations
- Limited to file/folder search only; no content indexing beyond filename/path on Linux
- On Windows, requires the Everything service to be running and SDK installed
- Search syntax capabilities vary significantly by platform
Best For
Finding recently modified Python files across a Windows systemLocating large files on macOS using Spotlight searchSearching for configuration files by full path on LinuxAutomated file discovery in CI/CD pipelines or development workflowsBuilding AI agents that need to locate files on the local filesystem
FAQ
What is mcp-everything-search?
It is an MCP server that provides fast file searching across Windows (using Everything SDK), macOS (using mdfind), and Linux (using locate/plocate).
What parameters does the search tool support?
The search tool accepts: query (required), max_results (optional, default 100, max 1000), match_path (match full path), match_case, match_whole_word, match_regex (all boolean), and sort_by (numeric code for sort order).
How do I install it?
You can install via uvx (no installation needed): `uvx mcp-server-everything-search`, via pip: `pip install mcp-server-everything-search`, or via Smithery for Claude Desktop.
What are the prerequisites on Windows?
You need to have the Everything search utility installed and running, and the Everything SDK downloaded from voidtools.com.
Does it work on macOS?
Yes, it uses the built-in mdfind command and requires no additional setup.
What search syntax is supported?
The syntax varies by platform. Windows supports full Everything SDK syntax (e.g., ext:py, datemodified:today, regex). macOS supports Spotlight syntax. Linux supports basic filename searches with locate. See SEARCH_SYNTAX.md for details.
What information does the search return?
Each result includes the file/folder path, file size in bytes, and last modified date.