mcp-everything-search

一切搜索 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）。可用选项：

例子：

响应包括：

• 文件/文件夹路径
• 文件大小（以字节为单位）
• 上次修改日期

搜索语法指南

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

先决条件

视窗

1. 一切搜索实用程序：
   • 从https://www.voidtools.com/下载并安装
   • 确保 Everything 服务正在运行
2. 一切 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自动安装 Everything Search for Claude Desktop：

使用 uv（推荐）

使用uv时无需特殊安装。我们将使用uvx直接运行mcp-server-everything-search 。

使用 PIP

或者，您可以通过 pip 安装mcp-server-everything-search ：

安装后，您可以使用以下命令将其作为脚本运行：

配置

视窗

服务器需要 Everything SDK DLL 可用：

环境变量：

Linux 和 macOS

无需额外配置。

与 Claude Desktop 一起使用

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

或者如果使用 pip 安装：

调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

或者，如果您已将软件包安装在特定目录中或正在其上进行开发：

查看服务器日志：

Linux/macOS：

Windows（PowerShell）：

发展

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

1. 运行 MCP 检查器来测试你的更改。请参阅“调试”了解运行说明。
2. 使用 Claude 桌面应用进行测试。将以下内容添加到claude_desktop_config.json中：

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。

免责声明

本项目与 voidtools（Everything 搜索工具的开发者）没有任何关联，亦未获得其认可或赞助。本项目是一个独立项目，使用公开的 Everything SDK。