MCP Ripgrep Server

Name: MCP Ripgrep Server
Author: mcollina

本地服务

github.com/mcollina搜索与检索7878 周前更新

代码仓库

关于 MCP Ripgrep Server

MCP Ripgrep Server 是一个封装 ripgrep（rg）搜索能力的 MCP 服务，可供 Claude 等 MCP 客户端调用，在本地文件中进行文本搜索。它适合需要让 AI 助手检索代码或文件内容的用户。

主要功能

01封装 ripgrep 的文本搜索
02支持固定字符串与文件类型过滤
03提供匹配数量统计
04列出将被搜索的文件及支持的文件类型

适用场景

01让 AI 助手在源码目录中查找特定模式
02统计代码中 TODO 等标记的出现次数
03查看某一文件类型下将被搜索的文件

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 search、advanced-search、count-matches、list-files 和 list-file-types 等工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y mcp-ripgrep

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-ripgrepstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
pattern	string	是	搜索模式（默认使用正则表达式）
path	string	是	要搜索的目录或文件。
caseSensitive	boolean	否	区分大小写进行搜索（默认：自动）
filePattern	string	否	按文件类型或 glob 过滤
maxResults	number	否	限制匹配行数
context	number	否	显示每个匹配项前后的 N 行
useColors	boolean	否	在输出中使用颜色（默认：false）

详细介绍

MCP Ripgrep 服务

一个 MCP 服务，可向 Claude 等任意 MCP 客户端提供 ripgrep（rg）搜索功能。

概览

此服务为强大的 ripgrep 搜索工具提供 Model Context Protocol（MCP）接口。它使 Claude AI 和其他兼容 MCP 的客户端能够在你的系统文件中执行高性能文本搜索。

前置条件

Node.js（v18 或更高版本）
已安装 ripgrep（rg）命令，并且可在你的 PATH 中找到。在 macOS 上使用 brew install ripgrep 安装。

与 Claude for Desktop 搭配使用

如需将此 MCP 服务与 Claude for Desktop 搭配使用：

编辑 Claude for Desktop 配置文件：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json

将以下内容添加到配置中：

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

将 /path/to/mcp-ripgrep 替换为你克隆此仓库的绝对路径。

重启 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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。