Everything搜索MCP服务器

这是一个跨平台（Windows、macOS和Linux）提供快速文件搜索功能的MCP服务器。在Windows上使用EverythingSDK，在macOS上使用内置的mdfind命令，在Linux上使用locate/plocate命令。

工具

搜索

在整个系统中搜索文件和文件夹。搜索功能和语法支持因平台而异：

• Windows：完整支持Everything SDK功能（见下方语法指南）
• macOS：基于Spotlight数据库的基本文件名和内容搜索
• Linux：基于locate数据库的基本文件名搜索

参数：

• query（必需）：搜索查询字符串。具体语法见下方平台说明
• max_results（可选）：返回的最大结果数（默认：100，最大：1000）
• match_path（可选）：匹配完整路径而非仅文件名（默认：false）
• match_case（可选）：启用区分大小写的搜索（默认：false）
• match_whole_word（可选）：仅匹配完整单词（默认：false）
• match_regex（可选）：启用正则表达式搜索（默认：false）
• sort_by（可选）：结果排序方式（默认：1）。可用选项：

  - 1：按文件名升序（A到Z）
  - 2：按文件名降序（Z到A）
  - 3：按路径升序（A到Z）
  - 4：按路径降序（Z到A）
  - 5：按大小升序（从小到大）
  - 6：按大小降序（从大到小）
  - 7：按扩展名升序（A到Z）
  - 8：按扩展名降序（Z到A）
  - 11：按创建日期升序（从旧到新）
  - 12：按创建日期降序（从新到旧）
  - 13：按修改日期升序（从旧到新）
  - 14：按修改日期降序（从新到旧）

示例：

{
  "query": "*.py",
  "max_results": 50,
  "sort_by": 6
}

{
  "query": "ext:py datemodified:today",
  "max_results": 10
}

响应包含：

• 文件/文件夹路径
• 文件大小（字节）
• 最后修改日期

搜索语法指南

有关各平台（Windows、macOS和Linux）支持的搜索语法的详细信息，请参阅SEARCH_SYNTAX.md。

前提条件

Windows

1. Everything搜索工具：
   • 从https://www.voidtools.com/下载并安装
   • 确保Everything服务正在运行
2. Everything SDK：
   • 从https://www.voidtools.com/support/everything/sdk/下载
   • 将SDK文件解压到系统中的某个位置

Linux

1. 安装并初始化locate或plocate命令：
   • Ubuntu/Debian：sudo apt-get install plocate或sudo apt-get install mlocate
   • Fedora：sudo dnf install mlocate
2. 安装后更新数据库：
   • 对于plocate：sudo updatedb
   • 对于mlocate：sudo /etc/cron.daily/mlocate

macOS

无需额外设置。服务器使用内置的mdfind命令。

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Everything Search：

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

配置

Windows

服务器需要Everything SDK DLL可用：

环境变量：

EVERYTHING_SDK_PATH=path\to\Everything-SDK\dll\Everything64.dll

Linux和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"]
  }
}

"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*.log

Windows（PowerShell）：

Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

开发

如果你正在进行本地开发，有两种方法测试你的更改：

1. 运行MCP检查器测试你的更改。运行说明见调试。

2. 使用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。