File Find MCP

一个专用的模型上下文协议 (MCP) 服务器，用于在文件系统中快速查找文件，使用 Rust 构建并由 ripgrep 提供支持。

🔍 概述

File Find 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 提供了模型上下文协议的实现
• 该项目 fork 自 file-search-mcp 并进行了修改，以使用 ripgrep 提高搜索效率