文件搜索服务

一个为Claude Desktop提供基于Everything SDK的快速文件系统搜索服务的MCP服务器。

  • by DanMarshall909
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 DanMarshall909/EverythingMCP

使用说明

所有MCP服务器

MCP服务器 VoidTools的一切 它为Claude Desktop在Windows上提供了闪电般快速的文件系统搜索。此实现通过Everything SDK使用本机C绑定以实现最大性能,并透明地回退到HTTP API。

特性

  • 快速燃烧:利用本地资源 Everything64.dll 以获得近乎即时的结果。
  • 架构感知:根据Node.js运行时自动检测并加载正确的DLL(32位或64位)。
  • 线程安全:实现一个内部互斥体,以防止并发工具调用期间出现竞争情况。
  • 非阻塞:使用异步工作线程进行SDK查询,以保持MCP连接的响应。
  • 智能回退:如果SDK不可用,则自动切换到Everything HTTP服务器。

先决条件

  • Windows操作系统:本机SDK功能所需。
  • 一切搜索:必须安装并运行。
  • Everything SDK: 点击此处下载。确保DLL位于系统PATH中或通过环境变量配置。
  • Node.js:版本18或更高版本。

安装

  1. 克隆并安装:
npm install

  1. 构建项目:
npm run build

  1. 配置Claude桌面: 将以下内容添加到您的 %APPDATA%\Claude\claude_desktop_config.json:
{
  "mcpServers": {
    "everything": {
      "command": "node",
      "args": ["C:\\path\\to\\everything-mcp\\dist\\index.js"],
      "env": {
        "EVERYTHING_SDK_PATH": "C:\\path\\to\\Everything64.dll"
      }
    }
  }
}

工具: search_files

使用高级筛选在整个系统中搜索文件和文件夹。

参数

参数 类型 默认值 说明
query 字符串 (必填) 搜索词(支持Everything搜索语法)。
count number 100 要返回的最大结果数(1-1000)。
offset number 0 大型结果集的分页偏移量。
sort 字符串 "name" name, path, size, date_created, date_modified, extension.
ascending 布尔值 true 设置为 false 按降序排列。
path string - 搜索特定目录。
regex 布尔值 false 启用正则表达式匹配。
case 布尔值 false 启用区分大小写的匹配。

开发与测试

该项目包括一个强大的测试套件,用于模拟MCP JSON-RPC通信:

# Run the universal test script
node test-mcp.js