全局文件搜索服务

Everything Search MCP Server 是一个跨平台的快速文件搜索服务,支持在Windows、macOS和Linux系统上进行高效的文件和文件夹搜索。在Windows上,它利用Everything SDK提供强大的搜索功能;在macOS上,使用内置的`mdfind`命令;在Linux上,则使用`locate`/`plocate`命令。该服务支持多种搜索参数和排序方式,适用于需要快速定位和管理文件的场景。

  • by aripo99
  • 更新于

使用说明

基本能力

产品定位

Everything Search MCP Server 是一个跨平台的快速文件搜索服务,旨在为用户提供高效的文件和文件夹搜索功能。

核心功能

  • 跨平台支持:Windows(使用Everything SDK)、macOS(使用mdfind命令)、Linux(使用locate/plocate命令)
  • 强大的搜索功能:支持文件名、路径、大小、修改日期等多种搜索条件
  • 灵活的排序选项:支持按文件名、路径、大小、扩展名、创建日期和修改日期等多种排序方式
  • 可定制的结果数量:可设置返回结果的最大数量

适用场景

  • 快速定位和管理文件
  • 跨平台文件搜索需求
  • 开发过程中的文件查找

工具列表

  • search:搜索文件和文件夹,支持多种搜索参数和排序方式

使用教程

使用依赖

Windows

  1. 下载并安装Everything搜索工具:https://www.voidtools.com/
  2. 确保Everything服务正在运行
  3. 下载Everything SDK:https://www.voidtools.com/support/everything/sdk/
  4. 将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安装

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

使用uv(推荐)

无需特定安装,使用uvx直接运行mcp-server-everything-search。

使用PIP安装

pip install mcp-server-everything-search

安装后,可以运行:

python -m mcp_server_everything_search

调试方式

使用MCP检查器调试

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:APPDATAClaudelogsmcp*.log" -Tail 20 -Wait