File Find Mcp

File Find MCP

一个专用于在文件系统中快速搜索文件的 Model Context Protocol（MCP）服务，使用 Rust 构建，并由 ripgrep 提供支持。

🔍 概览

File Find MCP 是一个工具，可在指定目录中提供强大的文件搜索功能。它使用 ripgrep 高效地搜索文件内容，性能出色。

本项目实现了 Model Context Protocol（MCP），因此兼容支持该协议的 AI 助手和其他系统。

✨ 功能

• 高性能搜索：使用 ripgrep，在目录结构中执行极快的搜索
• 文件内容读取器：读取并显示特定文本文件的内容
• 智能文件检测：自动识别文本文件并跳过二进制文件
• MCP 集成：可与支持 Model Context Protocol 的系统配合使用
• 回退机制：当 ripgrep 命令不可用时，使用纯 Rust 实现

📋 前提条件

使用此工具前，请确保已安装：

1. Rust - 安装 Rust
2. ripgrep - 在 macOS 上，可以使用 Homebrew 安装：

   brew install ripgrep
   

📦 构建

构建项目：

# Clone the repository
git clone https://github.com/joisun/file-find-mcp
cd file-find-mcp

# Build in release mode
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 提供 Model Context Protocol 实现
• 本项目 fork 自 file-search-mcp，并经过修改，使用 ripgrep 提升搜索效率