Everything Search MCP Server

简介

一个跨平台文件搜索服务器，为 Claude Desktop 等应用提供快速文件搜索功能：

• Windows：使用 Everything SDK
• macOS：使用内置 mdfind(Spotlight)
• Linux：使用 locate/plocate

安装前准备

Windows

1. 安装 Everything 搜索工具
2. 下载 Everything SDK
3. 确保 Everything 服务正在运行

Linux

安装并初始化 locate/plocate：

# Debian/Ubuntu
sudo apt-get install plocate
sudo updatedb

# Fedora
sudo dnf install mlocate
sudo /etc/cron.daily/mlocate

macOS

无需额外设置

安装方法

通过 Smithery 安装（最简单）

npx -y @smithery/cli install mcp-server-everything-search --client claude

使用 uv（推荐）

直接使用 uvx 运行，无需安装

使用 pip

pip install mcp-server-everything-search

配置 Claude Desktop

在 claude_desktop_config.json 中添加：

Windows

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}

Linux/macOS

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"]
  }
}

基本搜索示例

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

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

搜索参数

• query：搜索查询字符串（必需）
• max_results：返回结果数（默认100，最大1000）
• match_path：匹配完整路径（默认false）
• match_case：区分大小写（默认false）
• match_whole_word：仅匹配完整单词（默认false）
• match_regex：启用正则表达式（默认false）
• sort_by：结果排序方式（默认1-按文件名A-Z）

调试

使用 MCP 检查器：

npx @modelcontextprotocol/inspector uvx mcp-server-everything-search

查看日志：

• Linux/macOS: tail -f ~/.config/Claude/logs/mcp*.log
• Windows: Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

许可证

MIT 许可证