一切搜索 MCP 服务器
一款 MCP 服务器，提供跨 Windows、macOS 和 Linux 的快速文件搜索功能。在 Windows 上，它使用Everything SDK。在 macOS 上，它使用内置的mdfind命令。在 Linux 上，它使用locate / plocate命令。
工具
搜索
在您的系统中搜索文件和文件夹。搜索功能和语法支持因平台而异：
Windows：完整的 Everything SDK 功能（请参阅下面的语法指南）
macOS：使用 Spotlight 数据库进行基本文件名和内容搜索
Linux：使用定位数据库进行基本文件名搜索
参数：
query（必需）：搜索查询字符串。请参阅下文中平台相关的说明。max_results（可选）：返回的最大结果数（默认值：100，最大值：1000）match_path（可选）：匹配完整路径而不是仅匹配文件名（默认值：false）match_case（可选）：启用区分大小写的搜索（默认值：false）match_whole_word（可选）：仅匹配整个单词（默认值：false）match_regex（可选）：启用正则表达式搜索（默认值：false）sort_by（可选）：结果排序方式（默认值：1）。可用选项：
- 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)例子：
{
"query": "*.py",
"max_results": 50,
"sort_by": 6
}{
"query": "ext:py datemodified:today",
"max_results": 10
}响应包括：
文件/文件夹路径
文件大小（以字节为单位）
上次修改日期
搜索语法指南
有关每个平台（Windows、macOS 和 Linux）支持的搜索语法的详细信息，请参阅SEARCH_SYNTAX.md 。
Related MCP server: MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool
先决条件
视窗
一切搜索实用程序：
确保 Everything 服务正在运行
一切 SDK：
将 SDK 文件解压到系统上的某个位置
Linux
安装并初始化
locate或plocate命令：Ubuntu/Debian：
sudo apt-get install plocate或sudo apt-get install mlocateFedora：
sudo dnf install mlocate
安装完成后，更新数据库：
对于 plocate：
sudo updatedb对于 mlocate：
sudo /etc/cron.daily/mlocate
macOS
无需额外设置。服务器使用内置的mdfind命令。
安装
通过 Smithery 安装
要通过Smithery自动安装 Everything Search for Claude Desktop：
npx -y @smithery/cli install mcp-server-everything-search --client claude使用 uv（推荐）
使用uv时无需特殊安装。我们将使用uvx直接运行mcp-server-everything-search 。
使用 PIP
或者，您可以通过 pip 安装mcp-server-everything-search ：
pip install mcp-server-everything-search安装后，您可以使用以下命令将其作为脚本运行：
python -m mcp_server_everything_search配置
视窗
服务器需要 Everything SDK DLL 可用：
环境变量：
EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dllLinux 和 macOS
无需额外配置。
与 Claude Desktop 一起使用
根据您的平台，将以下配置之一添加到您的claude_desktop_config.json中：
"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"]
}
}或者如果使用 pip 安装：
"mcpServers": {
"everything-search": {
"command": "python",
"args": ["-m", "mcp_server_everything_search"]
}
}调试
您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：
npx @modelcontextprotocol/inspector uvx mcp-server-everything-search或者，如果您已将软件包安装在特定目录中或正在其上进行开发：
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查看服务器日志：
Linux/macOS：
tail -f ~/.config/Claude/logs/mcp*.logWindows（PowerShell）：
Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait发展
如果您正在进行本地开发，则有两种方法可以测试您的更改：
运行 MCP 检查器来测试你的更改。请参阅“调试”了解运行说明。
使用 Claude 桌面应用进行测试。将以下内容添加到
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"
}
}执照
此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。
免责声明
本项目与 voidtools（Everything 搜索工具的开发者）没有任何关联，亦未获得其认可或赞助。本项目是一个独立项目，使用公开的 Everything SDK。
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.