MCP Ripgrep

🚀 MCP 通用grep 服務器

本項目是一個 MCP 服務器，提供了強大的 ripgrep（rg）搜索功能，可供任何 MCP 客戶端（如Claude）使用，能夠幫助用戶在系統文件中高效進行文本搜索。

🚀 快速開始

此服務器為強大的ripgrep搜索工具提供了 Model Context Protocol (MCP) 接口。它使 Claude AI 和其他與 MCP 兼容的客戶端能夠對系統上的文件執行高性能文本搜索。

✨ 主要特性

• 為 ripgrep 搜索工具提供 MCP 接口，讓 MCP 兼容客戶端可使用其搜索功能。
• 支持多種搜索模式，如基本搜索、高級搜索、計算匹配次數、列出文件、列出文件類型等。

📦 安裝指南

先決條件

• Node.js（v18 或更高版本）
• ripgrep (rg) 命令已安裝並添加到 PATH 中。使用 brew install ripgrep 在 macOS 上安裝。

💻 使用示例

與Claude Desktop一起使用

要將此 MCP 服務器與 Claude Desktop 一起使用：

1. 編輯你的 Claude Desktop 配置文件：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 將以下內容添加到你的配置中：

   {
     "mcpServers": {
       "ripgrep": {
         "command": "npx",
         "args": ["-y", "mcp-ripgrep@latest"]
       }
     }
   }
   

   將 /path/to/mcp-ripgrep 替換為你克隆此倉庫的絕對路徑。
3. 重啟 Claude Desktop。

可用工具使用示例

基礎用法

基本 ripgrep 搜索

模式：error
路徑：./src

高級用法

帶更多選項的高級搜索

模式：function
路徑：./src
固定字符串：true
文件類型：ts
包含隱藏文件：false

計算匹配次數

模式：TODO
路徑：./src
計算行數：true

列出文件

路徑：./src
文件類型：js

列出文件類型 列出 ripgrep 支持的所有文件類型。

⚠️ 安全注意事項

此 MCP 服務器使用 ripgrep 工具執行 shell 命令。儘管已努力安全地轉義參數，但提供輸入時請小心，因為它會在你的機器上運行命令。

📄 許可證

本項目採用 MIT 許可證。