Skip to main content
Glama
enesjakozh
mamertofabian

mcp-everything-search

by mamertofabian
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

一切搜索 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: everything-mcp

先决条件

视窗

  1. 一切搜索实用程序：

  2. 一切 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：

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.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"]
  }
}

或者如果使用 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。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • everything-mcp-server

    peterparker57
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables instant file searches on Windows using Everything's native SDK, supporting advanced filters, duplicate detection, and content search through MCP tools.
    5
    MIT

  • everything-mcp

    uwx
    A
    license
    A
    quality
    D
    maintenance
    MCP server that integrates Everything file search engine on Windows, enabling fast file and folder searches using Everything syntax, plus version and status checks.
    4
    9 npm
    MIT

  • @shxiaj/everything-mcp

    shxiaj
    A
    license
    A
    quality
    D
    maintenance
    Enables lightning-fast file searching on Windows using Everything SDK, with tools for search, version check, status, and file info retrieval.
    4
    16 npm
    MIT

Appeared in Searches