mamertofabian/mcp-everything-search

An MCP server that provides fast file searching capabilities across Windows, macOS, and Linux. On Windows, it uses the Everything SDK. On macOS, it uses the built-in mdfind command. On Linux, it uses the locate/plocate command.
Tools
search
Search for files and folders across your system. The search capabilities and syntax support vary by platform:
- Windows: Full Everything SDK features (see syntax guide below)
- macOS: Basic filename and content search using Spotlight database
- Linux: Basic filename search using locate database
Parameters:
- query (required): Search query string. See platform-specific notes below.
- max_results (optional): Maximum number of results to return (default: 100, max: 1000)
- match_path (optional): Match against full path instead of filename only (default: false)
- match_case (optional): Enable case-sensitive search (default: false)
- match_whole_word (optional): Match whole words only (default: false)
- match_regex (optional): Enable regex search (default: false)
- sort_by (optional): Sort order for results (default: 1). Available options:
Examples:
Response includes:
- File/folder path
- File size in bytes
- Last modified date
Search Syntax Guide
For detailed information about the search syntax supported on each platform (Windows, macOS, and Linux), please see SEARCH_SYNTAX.md.
Prerequisites
Windows
1. Everything search utility:
- Download and install from https://www.voidtools.com/
- **Make sure the Everything service is running**
2. Everything SDK:
- Download from https://www.voidtools.com/support/everything/sdk/
- Extract the SDK files to a location on your system
Linux
1. Install and initialize the locate or plocate command:
- Ubuntu/Debian: sudo apt-get install plocate or sudo apt-get install mlocate
- Fedora: sudo dnf install mlocate
2. After installation, update the database:
- For plocate: sudo updatedb
- For mlocate: sudo /etc/cron.daily/mlocate
macOS
No additional setup required. The server uses the built-in mdfind command.
Installation
Installing via Smithery
To install Everything Search for Claude Desktop automatically via Smithery:
Using uv (recommended)
When using uv no specific installation is needed. We will
use uvx to directly run _mcp-server-everything-search_.
Using PIP
Alternatively you can install mcp-server-everything-search via pip:
After installation, you can run it as a script using:
Configuration
Windows
The server requires the Everything SDK DLL to be available:
Environment variable:
Linux and macOS
No additional configuration required.
Usage with Claude Desktop
Add one of these configurations to your claude_desktop_config.json based on your platform:
Windows (using uvx)
Windows (using pip installation)
Linux and macOS
Or if using pip installation:
Debugging
You can use the MCP inspector to debug the server. For uvx installations: