Everything MCP Server

Everything MCP Server

一个 Model Context Protocol (MCP) 服务，通过 Everything 的原生 SDK 提供即时文件搜索功能。该服务将 Everything 强大的搜索引擎与 AI 工具集成，使你能够通过 MCP 接口以极快的速度搜索文件系统。

功能

• 🔍 即时文件搜索：利用 Everything 的即时索引，实现近乎即时的文件搜索
• 🎯 高级筛选：按路径、扩展名、大小、修改日期等条件搜索
• 🔄 重复文件检测：查找系统中的重复文件
• 📄 内容搜索：搜索文件内容（需要 Everything 内容索引）
• ⚡ 高性能：通过原生 SDK 集成直接访问 API
• 🛡️ 只读：安全、非破坏性的文件系统访问

提供的工具

1. search_files

基本文件搜索，支持正则表达式和区分大小写选项。

参数：

• query（string）：文件名搜索查询
• maxResults（number，可选）：返回结果的最大数量（默认值：100）
• matchCase（boolean，可选）：启用区分大小写的搜索
• matchWholeWord（boolean，可选）：仅匹配完整单词
• regex（boolean，可选）：启用正则表达式搜索

2. search_files_advanced

提供全面筛选选项的高级搜索。

参数：

• query（string）：文件名搜索查询
• path（string，可选）：将搜索范围限制在指定路径
• extension（string，可选）：按文件扩展名筛选（例如：'txt'、'pdf'）
• size（string，可选）：按文件大小筛选（例如：'>1mb'、'<100kb'、'1gb..2gb'）
• dateModified（string，可选）：按修改日期筛选（例如：'today'、'yesterday'、'thisweek'、'2024'）
• maxResults（number，可选）：返回结果的最大数量（默认值：100）
• matchCase（boolean，可选）：启用区分大小写的搜索
• matchWholeWord（boolean，可选）：仅匹配完整单词
• regex（boolean，可选）：启用正则表达式搜索
• sortBy（enum，可选）：按字段排序结果（name_asc、name_desc、path_asc、path_desc、size_asc、size_desc、date_asc、date_desc）

3. find_duplicates

按文件名查找重复文件。

参数：

• filename（string）：要搜索重复项的文件名
• path（string，可选）：将搜索范围限制在指定路径
• maxResults（number，可选）：返回结果的最大数量（默认值：50）

4. search_content

搜索文件中的文本内容。

参数：

• content（string）：要在文件中搜索的文本内容
• fileTypes（string，可选）：限制为指定文件类型（例如：'txt;doc;pdf'）
• path（string，可选）：将搜索范围限制在指定路径
• maxResults（number，可选）：返回结果的最大数量（默认值：50）

前置条件

1. Everything 应用程序：必须已安装并正在运行

   • 下载地址：https://www.voidtools.com/
   • 确保它在后台运行，以便访问 API

2. Node.js：版本 18+，支持 ES 模块

3. Windows OS：Everything SDK 兼容性要求

安装

1. 克隆仓库：

git clone https://github.com/peterparker57/everything-mcp-server.git
cd everything-mcp-server

2. 安装依赖：

npm install

3. 构建项目：

npm run build

配置

将该服务添加到 MCP 设置文件中：

{
  "mcpServers": {
    "everything": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["path/to/everything-mcp-server/build/index.js"],
      "disabled": false,
      "env": {},
      "alwaysAllow": [
        "search_files",
        "search_files_advanced",
        "find_duplicates",
        "search_content"
      ]
    }
  }
}

使用示例

基本文件搜索

Search for: "msbuild.exe"
Options: Case sensitive, max 50 results

使用筛选条件进行高级搜索

Query: "*.pdf"
Path: "C:\\Documents"
Size: ">1mb"
Date Modified: "thisweek"
Sort: "size_desc"

查找重复文件

Filename: "config.json"
Path: "C:\\Projects" (optional)

内容搜索

Content: "function main"
File Types: "js;ts;py"
Path: "C:\\Code" (optional)

架构

技术栈

• 语言：TypeScript
• 框架：MCP SDK (@modelcontextprotocol/sdk)
• FFI 库：koffi（用于原生 DLL 集成）
• 模块系统：ES 模块
• 目标：Everything SDK（Windows 文件搜索实用工具）

核心组件

1. 主服务（src/index.ts）：MCP 服务的核心实现
2. Everything SDK：用于文件搜索的原生 Windows DLL
3. 构建系统：将 TypeScript 编译为 ES 模块
4. 配置：支持 ES 模块的 Package.json

开发

构建

npm run build

测试

直接启动服务进行测试：

node build/index.js

项目结构

everything-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── EverythingSDK/        # Everything native SDK files
│   └── dll/
│       ├── Everything32.dll
│       └── Everything64.dll
├── build/                # Compiled JavaScript output
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

故障排除

“Everything 搜索客户端未运行”

• 启动 Everything 应用
• 确保它不是在没有服务的便携模式下运行

MCP 错误“连接已关闭”

• 检查构建目录是否存在且包含 index.js
• 验证 MCP 配置中的 Node.js 路径
• 确保 Everything 应用正在运行

ES 模块错误

• 确认 package.json 包含 "type": "module"
• 检查 import 语句是否使用 .js 扩展名
• 确保 koffi 以默认导出的形式导入

性能说明

• Everything 可即时为文件编制索引，搜索几乎瞬时完成
• 内容搜索要求在 Everything 中启用内容索引
• 大型结果集会自动限制（可按工具配置）
• 直接访问 API 的性能优于命令行界面

安全注意事项

• 服务通过 Everything 提供对文件系统的只读访问
• 不具备文件修改功能
• 遵循 Everything 自身的安全和索引设置
• 内容搜索仅限 Everything 已编制索引的文件

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到该分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

致谢

• 感谢 voidtools 开发的出色文件搜索工具 Everything
• 感谢 Model Context Protocol 提供 MCP 框架
• 感谢 koffi 提供出色的 FFI 库

相关项目

• MCP SDK - Model Context Protocol 的 TypeScript SDK
• Everything - 此服务集成的文件搜索工具

---

注意：这是一个 Windows 专用的 MCP 服务，需要安装并运行 Everything 应用。如需跨平台文件搜索解决方案，可考虑其他 MCP 服务或文件搜索工具。