Everything Search

一切搜索MCP服务器

](https://www.npmjs.com/package/everything-search-mcp-server)  ](https://nodejs.org/) 

一个强大的模型上下文协议（MCP）服务器，与Everything搜索引擎集成，在整个系统中提供闪电般快速的文件搜索功能。此服务器通过兼容MCP的应用程序（如Claude Desktop、VS Code和其他MCP客户端）启用自然语言文件搜索和高级过滤选项。

目录

• 特性
• 快速开始

- 先决条件 - 第一步：安装Everything搜索引擎 - 步骤2：安装MCP服务器 - 步骤3：配置MCP客户端 - 步骤4：重新启动MCP客户端

• 用法
• 例子
• 参数参考
• 故障排除
• 新增功能
• 发展
• 贡献
• 许可证
• 支持

特性

• 🚀 闪电快速搜索：利用Everything搜索引擎的即时文件索引
• 🔍 自然语言查询：使用自然语言描述进行搜索，如“大型视频文件”或“最新文档”
• 🎯 高级搜索选项：区分大小写、整词匹配、正则表达式支持
• 📁 基于路径的搜索：在特定目录内或整个驱动器中搜索
• 📊 智能分拣：按名称、路径、大小或修改日期排序
• 🎨 丰富的格式：人类可读的文件大小和格式化日期
• 🌐 全球安装：安装一次，在所有MCP客户端上随处使用
• ⚡ 实时结果：键入时即时搜索结果
• 🔧 高度可配置性：可自定义的端口、范围和搜索参数

快速开始

先决条件

1. Windows操作系统 （所有搜索引擎仅适用于Windows）
2. Node.js 16+ - 点击此处下载
3. 一切搜索引擎 - 点击此处下载

第一步：安装Everything搜索引擎

1. 下载并安装 一切搜索引擎
2. 打开一切搜索
3. 首选 工具>选项>HTTP服务器
4. ✅ 启用 HTTP服务器
5. 将端口设置为 8011 （默认）
6. 点击 好的 并重新启动一切

步骤2：安装MCP服务器

选项A：全局安装（推荐）

npm install -g everything-search-mcp-server

备注：如果你还没有发布到npm，用户应该使用选项B（From Source），直到包在npm上可用。

选项B：来源

git clone https://github.com/ananyaakamat/everything-search-mcp-server.git
cd everything-search-mcp-server
npm install
npm run build
npm install -g .

步骤3：配置MCP客户端

适用于克劳德桌面

添加到您的 claude_desktop_config.json:

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

配置文件位置：

• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

VS代码

为了快速安装，请使用下面的一键安装按钮之一。..

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 使用时需要密钥 mcp.json 文件。

添加到您的VS代码 settings.json:

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

设置文件位置：

• 视窗: %APPDATA%\Code\User\settings.json
• macOS: ~/Library/Application Support/Code/User/settings.json
• Linux: ~/.config/Code/User/settings.json

备注：确保在VS Code中安装了MCP扩展以支持MCP服务器。

步骤4：重新启动MCP客户端

重新启动Claude Desktop或VS Code以加载新服务器。

步骤5：验证安装

测试服务器是否正常工作：

# Check if the command is available
everything-search-mcp-server --help

# Or test with a simple search (if Everything is running)
# The server should start and respond to MCP requests

在您的MCP客户端中，尝试以下简单搜索：

• “搜索README文件”
• “查找所有.txt文件”
• “显示大视频文件”
• “查找最近的Word文档”

用法

服务器提供了两个强大的工具：

1. search -高级文件搜索

{
  "query": "search terms",
  "scope": "C:",
  "caseSensitive": false,
  "wholeWord": false,
  "regex": false,
  "path": false,
  "maxResults": 100,
  "sortBy": "name",
  "ascending": true
}

2. natural_search -自然语言搜索

{
  "naturalQuery": "find all video files larger than 1GB",
  "maxResults": 50
}

例子

基本搜索

// Find all PDF files
{
  "query": "*.pdf",
  "maxResults": 10
}

// Search for "readme" files
{
  "query": "readme",
  "maxResults": 5
}

高级搜索

// Case-sensitive search in specific directory
{
  "query": "Config",
  "scope": "C:\\Users\\YourName\\AppData",
  "caseSensitive": true,
  "maxResults": 20
}

// Regex search for JavaScript files
{
  "query": ".*\\.(js|ts)$",
  "regex": true,
  "sortBy": "date_modified",
  "ascending": false
}

自然语言搜索

// Find large video files
{
  "naturalQuery": "large video files on desktop",
  "maxResults": 10
}

// Find recent documents
{
  "naturalQuery": "documents modified this week",
  "maxResults": 15
}

// Find development projects
{
  "naturalQuery": "programming projects with package.json",
  "maxResults": 5
}

参数参考

search 刀具参数

natural_search 刀具参数

故障排除

常见问题

1. “连接被拒绝”错误

- 确保Everything Search正在运行 - 验证HTTP服务器是否已启用（工具>选项>HTTP服务器） - 检查端口8011是否未被防火墙阻止

1. “找不到命令”错误

- 确保服务器已全局安装： npm install -g everything-search-mcp-server - 验证Node.js是否在您的PATH中

1. 未返回任何结果

- 允许Everything完成初始索引（对于大型驱动器可能需要几分钟） - 首先检查Everything是否可以通过其GUI找到文件 - 验证您的搜索范围是否存在并且可以访问 - 确保您具有搜索目录的读取权限

1. 性能问题

- 减少 maxResults 以获得更快的响应 - 使用更具体的搜索范围来限制搜索区域 - 考虑使用精确的文件扩展名而不是通配符

配置

自定义端口配置

如果您需要使用其他端口：

1. 更改Everything的HTTP端口（工具>选项>HTTP服务器）
2. 设置环境变量： EVERYTHING_PORT=8012
3. 或修改服务器源代码

调试模式

启用调试日志记录：

DEBUG=everything-search:* everything-search-mcp-server

新增功能

版本1.0.0🎉

• 初始版本：完成MCP服务器实施
• 自然语言搜索：人工智能驱动的搜索查询
• 全球安装：易于基于npm的安装
• 多客户端支持：适用于Claude Desktop、VS Code和其他MCP客户端
• 高级搜索选项：正则表达式、区分大小写、路径搜索
• 丰富的文档：全面的设置和使用指南

发展

从源头构建

git clone https://github.com/ananyaakamat/everything-search-mcp-server.git
cd everything-search-mcp-server
npm install
npm run build

运行测试

npm test

贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature-name
3. 进行更改
4. 如果适用，添加测试
5. 承诺： git commit -am 'Add feature'
6. 推： git push origin feature-name
7. 创建拉取请求

许可证

ISC许可证-请参阅 许可证 文件以获取详细信息。

支持

• 🐛 错误报告:
• 💬 讨论:
• 📧 电子邮件: anant.kamat.in@gmail.com

相关项目

• 一切搜索引擎 -此服务器集成的强大文件搜索引擎
• 模型上下文协议 -此服务器实现的协议
• 克劳德桌面 -支持MCP的AI助手

______________________________________________________________________

由以下材料制成❤️ 对于MCP社区