AI导哈

文件搜索服务

一个与Everything搜索引擎集成的MCP服务器，提供快速文件搜索和自然语言查询功能，适用于开发者和需要高效文件管理的用户。

  • by ananyaakamat
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ananyaakamat/everything-search-mcp-server

使用说明

一切搜索MCP服务器

一个强大的模型上下文协议（MCP）服务器，与Everything搜索引擎集成，在整个系统中提供闪电般快速的文件搜索功能。此服务器通过兼容MCP的应用程序（如Claude Desktop、VS Code和其他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 刀具参数

参数 类型 默认值 说明
query 字符串 必需的 搜索查询字符串
scope 字符串 "C:" 搜索范围/目录
caseSensitive 布尔值 false 启用区分大小写的匹配
wholeWord 布尔值 false 仅匹配整个单词
regex 布尔值 false 启用正则表达式
path 布尔值 false 在文件路径中搜索
maxResults 编号 100 最大结果（1-1000）
sortBy 字符串 "name" 排序方式： name, path, size, date_modified
ascending 布尔值 true 排序方向

natural_search 刀具参数

参数 类型 默认值 说明
naturalQuery 字符串 必需的 自然语言搜索描述
maxResults 编号 100 最大结果（1-1000）

故障排除

常见问题

  1. “连接被拒绝”错误

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

  2. “找不到命令”错误

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

  3. 未返回任何结果

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

  4. 性能问题

    • 减少 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许可证-请参阅 许可证 文件以获取详细信息。

支持

相关项目

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

相关 MCP