File Find MCP

🚀 文件查找 MCP

文件查找 MCP 是一款專為快速文件搜索打造的模型上下文協議（MCP）服務器。它基於 Rust 編寫，依託 ripgrep 實現高速搜索，能在文件系統中高效查找所需文件。

🚀 快速開始

文件查找 MCP 可以對指定目錄中的文件進行強大的搜索。它藉助 ripgrep 實現高效內容搜索，速度極快。同時，該項目實現了模型上下文協議（MCP），可與 AI 助手及其他支持該協議的系統兼容。

✨ 主要特性

• 高性能搜索：使用 ripgrep 實現超高速目錄結構內容搜索
• 文件內容讀取器：可閱讀並顯示特定文本文件的內容
• 智能文件識別：自動識別文本文件並跳過二進制文件
• MCP 集成：與支持模型上下文協議的系統兼容
• 回退機制：當 ripgrep 命令不可用時，採用純 Rust 實現作為備用方案

📦 安裝指南

先決條件

在使用此工具之前，請確保安裝以下內容：

1. Rust 已安裝 - 安裝 Rust
2. ripgrep 已安裝 - 在 macOS 上，可以通過 Homebrew 安裝：

brew install ripgrep

構建項目

# 克隆倉庫
git clone https://github.com/joisun/file-find-mcp
cd file-find-mcp

# 以發佈模式構建
cargo build --release

編譯後的二進制文件將位於 target/release/file-find-mcp。

配置

在您的 MCP 設置中添加以下內容（例如在 Cursor、Claude 或其他支持 MCP 的工具中）：

{
  "mcpServers": {
    "file-find-mcp": {
      "command": "/path/to/your/file-find-mcp/target/release/file-find-mcp"
    }
  }
}

將 /path/to/your/file-find-mcp 替換為您實際克隆倉庫的路徑。

🛠️ 詳細文檔

搜索工具

• 描述：在指定目錄中的文本文件中搜索關鍵字
• 參數：
  • directory：要搜索的目錄路徑
  • keyword：要搜索的關鍵字

文件內容讀取器工具

• 描述：讀取並顯示特定文件的內容
• 參數：
  • file_path：要讀取的文件路徑

📄 許可證

本項目採用 MIT 許可證。

🙏 致謝

• ripgrep 感謝其提供的閃電般的搜索性能
• RMCP 感謝模型上下文協議的實現
• 該項目是從 file-search-mcp 分叉而來，並進行了修改以使用 ripgrep 以提高搜索效率