MCP Ripgrep Server
2025.04.07
8
TypeScript文本搜索代码搜索搜索工具
MCP Ripgrep Server 是一个提供 ripgrep (rg) 搜索能力的 MCP 服务器，适用于任何 MCP 客户端，如 Claude。它通过 Model Context Protocol (MCP) 接口为强大的 ripgrep 搜索工具提供了访问能力，使 Claude AI 和其他 MCP 兼容客户端能够在系统文件上执行高性能的文本搜索。
View on GitHub
Overview
基本能力
产品定位
MCP Ripgrep Server 是一个为 MCP 客户端提供高性能文本搜索能力的服务器，特别适用于需要快速搜索大量文本文件的场景。
核心功能
- 提供 ripgrep (rg) 搜索能力的 MCP 接口
- 支持基本搜索、高级搜索、匹配计数、文件列表和文件类型列表等功能
- 高性能的文本搜索能力
适用场景
- 在 Claude AI 或其他 MCP 客户端中快速搜索系统文件
- 开发过程中快速查找代码中的特定模式或错误
- 统计代码库中特定模式的出现次数
工具列表
- search: 基本搜索功能，支持指定模式和路径
- advanced-search: 高级搜索功能，支持固定字符串、文件类型等选项
- count-matches: 统计模式出现的次数
- list-files: 列出符合搜索条件的文件
- list-file-types: 列出 ripgrep 支持的所有文件类型
常见问题解答
- 安全性: 该服务器会执行 shell 命令，虽然已采取措施安全转义参数，但仍需谨慎提供输入
- 依赖: 需要 Node.js v18+ 和 ripgrep (rg) 命令
使用教程
使用依赖
- 安装 Node.js (v18 或更高版本)
- 安装 ripgrep (
rg) 命令 - macOS:
brew install ripgrep
安装教程
- 编辑 Claude for Desktop 配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - 添加以下配置:
json { "mcpServers": { "ripgrep": { "command": "npx", "args": ["-y", "mcp-ripgrep@latest"] } } } - 重启 Claude for Desktop
调试方式
- 确保
rg命令在 PATH 中可用 - 检查 Node.js 版本是否符合要求
- 检查配置文件是否正确