Everything Search MCP Server

🚀 一切搜索MCP服務器

這是一個與Everything搜索引擎集成的MCP服務器，藉助模型上下文協議，實現強大的文件搜索功能，為用戶提供高效的文件搜索體驗。

🚀 快速開始

本服務器為用戶提供了強大的文件搜索功能，通過與Everything搜索引擎集成，可實現跨文件和目錄的全文搜索。在使用前，需確保滿足相應的先決條件，並完成安裝配置。

✨ 主要特性

• 全文搜索：支持跨文件和目錄的全文搜索，讓您快速定位所需文件。
• 高級搜索選項：
  • 按字母大小寫敏感搜索，滿足對大小寫有要求的搜索場景。
  • 整詞匹配，精準定位特定詞彙的文件。
  • 支持正則表達式，提供更靈活的搜索方式。
  • 可進行路徑搜索，快速篩選指定路徑下的文件。
• 排序選項：
  • 按名稱排序，方便按字母順序查看文件。
  • 按路徑排序，清晰展示文件的目錄結構。
  • 按文件大小排序，可快速找到大文件或小文件。
  • 按修改日期排序，優先查看最新修改的文件。
• 結果格式化：
  • 以人類可讀的文件大小展示，直觀瞭解文件佔用空間。
  • 格式化的日期，方便查看文件的修改時間。
  • 顯示完整文件路徑，準確知曉文件的存儲位置。

📦 安裝指南

先決條件

• Node.js 16或更高版本。
• 已啟用HTTP服務器的Everything搜索引擎。

Everything搜索配置

1. 打開Everything搜索。
2. 轉到工具 > 選項 > HTTP服務器。
3. 啟用HTTP服務器。
4. 設置HTTP服務器端口為8011（此為本MCP服務器使用的默認端口）。
5. 點擊「確定」保存更改。

注意：如果需要使用其他端口，則需要修改src/server.ts中連接的端口，即http://127.0.0.1:8011/

安裝命令

npm install
npm run build

💻 使用示例

基礎用法

服務器提供一個通過MCP使用的單工具，以下是使用示例：

use_mcp_tool:
- server_name: everything-search
- tool_name: search
- arguments:
  {
    "query": "搜索字符串",          // 必填：要搜索的文字
    "scope": "C:",                     // 可選：搜索範圍（默認：C:\）
    "caseSensitive": false,            // 可選：按字母大小寫敏感
    "wholeWord": false,                // 可選：整詞匹配
    "regex": false,                    // 可選：使用正則表達式
    "path": false,                     // 可選：搜索路徑
    "maxResults": 100,                 // 可選：最大結果數（1-1000，默認：100）
    "sortBy": "name",                  // 可選：按名稱排序/路徑排序/文件大小排序/修改日期排序
    "ascending": true                  // 可選：排序方向
  }

高級用法

基本文件搜索

{
  "query": "*.txt",
  "maxResults": 5
}

具有過濾器的高級搜索

{
  "query": "test",
  "scope": "C:\\Users",
  "caseSensitive": true,
  "wholeWord": true,
  "maxResults": 10,
  "sortBy": "date_modified",
  "ascending": false
}

路徑中的正則搜索

{
  "query": ".*\\.js$",
  "regex": true,
  "path": true,
  "maxResults": 5
}

📄 許可證

ISC許可證。