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.
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.
Search for files and folders across your system. The search capabilities and syntax support vary by platform:
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: - 1: Sort by filename (A to Z)
- 2: Sort by filename (Z to A)
- 3: Sort by path (A to Z)
- 4: Sort by path (Z to A)
- 5: Sort by size (smallest first)
- 6: Sort by size (largest first)
- 7: Sort by extension (A to Z)
- 8: Sort by extension (Z to A)
- 11: Sort by creation date (oldest first)
- 12: Sort by creation date (newest first)
- 13: Sort by modification date (oldest first)
- 14: Sort by modification date (newest first)
Examples:
{
"query": "*.py",
"max_results": 50,
"sort_by": 6
}
{
"query": "ext:py datemodified:today",
"max_results": 10
}
Response includes:
For detailed information about the search syntax supported on each platform (Windows, macOS, and Linux), please see SEARCH_SYNTAX.md.
locate or plocate command:
sudo apt-get install plocate or sudo apt-get install mlocatesudo dnf install mlocatesudo updatedbsudo /etc/cron.daily/mlocateNo additional setup required. The server uses the built-in mdfind command.
To install Everything Search for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-server-everything-search --client claude
When using uv no specific installation is needed. We will
use uvx to directly run mcp-server-everything-search.
Alternatively you can install mcp-server-everything-search via pip:
pip install mcp-server-everything-search
After installation, you can run it as a script using:
python -m mcp_server_everything_search
The server requires the Everything SDK DLL to be available:
Environment variable:
EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll
No additional configuration required.
Add one of these configurations to your claude_desktop_config.json based on your platform:
"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-server-everything-search"],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}
}
"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_server_everything_search"],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}
}
"mcpServers": {
"everything-search": {
"command": "uvx",
"args": ["mcp-server-everything-search"]
}
}
Or if using pip installation:
"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_server_everything_search"]
}
}
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx mcp-server-everything-search
Or if you've installed the package in a specific directory or are developing on it:
git clone https://github.com/mamertofabian/mcp-everything-search.git
cd mcp-everything-search/src/mcp_server_everything_search
npx @modelcontextprotocol/inspector uv run mcp-server-everything-search
To view server logs:
Linux/macOS:
tail -f ~/.config/Claude/logs/mcp*.log
Windows (PowerShell):
Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait
If you are doing local development, there are two ways to test your changes:
Run the MCP inspector to test your changes. See Debugging for run instructions.
Test using the Claude desktop app. Add the following to your claude_desktop_config.json:
"everything-search": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-everything-search/src/mcp_server_everything_search",
"run",
"mcp-server-everything-search"
],
"env": {
"EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
}
}
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
This project is not affiliated with, endorsed by, or sponsored by voidtools (the creators of Everything search utility). This is an independent project that utilizes the publicly available Everything SDK.