mcp-everything-search

🚀 一切搜索MCP服务器

本MCP服务器可提供强大的文件搜索功能，支持多种操作系统，能满足不同用户的文件搜索需求。

🚀 快速开始

你可以使用Smithery进行安装，具体命令如下：

npx @modelcontextprotocol/core mcp add mcp-server-everything-search@latest

✨ 主要特性

这个MCP服务器提供了一个强大的文件搜索功能，支持多种操作系统。以下是该服务器的主要特点：

• Windows：利用Everything搜索工具进行高效搜索。
• macOS 和 Linux：通过本地文件系统实现全盘搜索。

📦 安装指南

Windows

1. 下载并安装Everything，启动服务。
2. 下载Everything SDK（版本4.x或更高）。
3. 将EVERYTHING_SDK_PATH环境变量设置为指向你的Everything SDK DLL文件：

   setx EVERYTHING_SDK_PATH "C:\path\to\EverythingSDK\dll\x64\Everything.dll"
   

macOS 和 Linux

无需额外安装，直接使用默认的文件搜索功能。

💻 使用示例

基础用法

以下是搜索命令的示例：

{
  "search": {
    "query": "search_string",
    "options": {
      "maxResults": number,
      "caseSensitive": boolean
    }
  }
}

返回结果示例如下：

{
  "files": [
    {
      "name": string,
      "path": string,
      "size": number,
      "modified": date
    }
  ]
}

📚 详细文档

配置示例

Windows配置（使用uvx）

在claude_desktop_config.json中添加：

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"],
    "env": {
      "EVERYTHING_SDK_PATH": "C:\path\to\EverythingSDK\dll\x64\Everything.dll"
    }
  }
}

Windows配置（使用pip安装）

在claude_desktop_config.json中添加：

"mcpServers": {
  "everything-search": {
    "command": "python",
    "args": ["-m", "mcp_server_everything_search"],
    "env": {
      "EVERYTHING_SDK_PATH": "C:\path\to\EverythingSDK\dll\x64\Everything.dll"
    }
  }
}

Linux 和 macOS配置

在claude_desktop_config.json中添加：

"mcpServers": {
  "everything-search": {
    "command": "uvx",
    "args": ["mcp-server-everything-search"]
  }
}

调试技巧

使用MCP inspectors进行调试：

• 对于uvx安装：

  npx @modelcontextprotocol/inspector uvx 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 inspector测试：

   npx @modelcontextprotocol/inspector uv run mcp-server-everything-search
   

2. 在Claude桌面应用中添加以下配置：

   "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": "C:\path\to\EverythingSDK\dll\x64\Everything.dll"
     }
   }
   

📄 许可证

本MCP服务器根据MIT License授权。这意味着你可以自由地使用、修改和分发软件，但需遵守许可证的条款和条件。详细信息请参阅项目仓库中的LICENSE文件。

免责声明

该项目与voidtools（一切搜索实用程序的创建者）无关，未获得其支持或赞助。这是一个独立的项目，利用公开可用的Everything SDK。