HelloWorld
登录
E

Everything搜索

该服务器提供： * 使用Everything SDK的快速文件搜索功能 * 针对Windows的具体实现 * 通过专用搜索功能补充现有的文件系统服务器

file-systemssearch

1.4w 查看 · 2026-07-07 更新

简介

该服务器提供：

  • 使用Everything SDK的快速文件搜索功能
  • 针对Windows的具体实现
  • 通过专用搜索功能补充现有的文件系统服务器

简介

该服务器提供：

  • 使用Everything SDK的快速文件搜索功能
  • 针对Windows的具体实现
  • 通过专用搜索功能补充现有的文件系统服务器

Everything Search MCP Server

smithery badge

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

工具

search

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

  • 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: 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。

先决条件

Windows

  1. Everything 搜索工具：
  2. Everything 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 桌面版一起使用

根据您的平台，将以下配置之一添加到 claude_desktop_config.json 中：

Windows（使用 uvx） 
"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "path/to/Everything-SDK/dll/Everything64.dll"
    }
  }
}
Windows（使用 pip 安装） 
"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "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"]
  }
}

或者如果您使用的是 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*.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。

来源