Skip to main content
Glama

一切搜索 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: SearXNG MCP Server

先决条件

视窗

  1. 一切搜索实用程序:

  2. 一切 SDK:

Linux

  1. 安装并初始化locateplocate命令:

    • Ubuntu/Debian: sudo apt-get install plocatesudo 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。

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mamertofabian/mcp-everything-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server