MCP Ripgrep 服务器

一个为任何 MCP 客户端（如 Claude）提供 ripgrep (rg) 搜索功能的 MCP 服务器。

概述

此服务器为强大的 ripgrep 搜索工具提供了一个模型上下文协议 (MCP) 接口。它使 Claude AI 和其他 MCP 兼容的客户端能够在您的系统上的文件中执行高性能的文本搜索。

前提条件

• Node.js (v18 或更高版本)
• ripgrep (rg) 命令已安装并在您的 PATH 中可用。在 macOS 上使用 brew install ripgrep 安装它。

与 Claude for Desktop 一起使用

要将此 MCP 服务器与 Claude for Desktop 一起使用：

1. 编辑您的 Claude for 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 for Desktop。

可用工具

search

使用 ripgrep 的基本搜索：

Pattern: error
Path: ./src

advanced-search

具有附加选项的更高级搜索：

Pattern: function
Path: ./src
FixedStrings: true
FileType: ts
IncludeHidden: false

count-matches

计算模式的出现次数：

Pattern: TODO
Path: ./src
CountLines: true

list-files

列出将要搜索的文件，而无需实际搜索它们：

Path: ./src
FileType: js

list-file-types

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

安全注意事项

此 MCP 服务器使用 ripgrep 工具执行 shell 命令。虽然已经努力安全地转义参数，但在提供输入时请谨慎，因为它会在您的机器上运行命令。

许可证

MIT