Ripgrep Mcp

Name: Ripgrep Mcp
Author: superauu

@superauu

代码仓库

关于 Ripgrep Mcp

Auu.Mcp.Rg

#ripgrep

基本信息

分类

其他

传输方式

stdio

发布者

superauu

提交者

Yibo Li

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "auu-mcp-rg": {
      "command": "npx",
      "args": [
        "auu-mcp-rg"
      ],
      "env": {
        "ROOT": "/path/to/your/project"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Ripgrep Mcp?

Ripgrep Mcp is a cross-platform MCP (Model Context Protocol) server for ripgrep that provides powerful search capabilities with native support for Windows, macOS, and Linux, plus enhanced security features. It is deployable via npx and includes built-in result limits, output size caps, and timeout protection.

How to use Ripgrep Mcp?

Install globally with npm install -g auu-mcp-rg or run directly with npx auu-mcp-rg. Configure the server in your Claude Desktop MCP settings, optionally setting the ROOT environment variable to limit all searches to a specific directory. Invoke tools like search, advanced-search, count-matches, list-files, or list-file-types with JSON arguments.

Key features of Ripgrep Mcp

Cross-platform compatible with Windows, macOS, and Linux
Full support for all ripgrep options and flags
Global root directory configuration via the ROOT environment variable
Automatic path validation and directory traversal protection
Built‑in result limit (100), output size limit (10 MB), and timeout (30 s)
Intelligent cross-platform path normalization and validation

Use cases of Ripgrep Mcp

Perform fast regex searches across your codebase with common ripgrep options
Count occurrences of a pattern (e.g., TODOs) across files
List all files that match a given glob or file type before searching
Execute advanced searches with context lines, case sensitivity, and word boundaries
Safely search within a sandboxed project directory, preventing access to sensitive files outside it

FAQ from Ripgrep Mcp

What are the installation requirements for Ripgrep Mcp?

Node.js 18 or later, and ripgrep must be installed and available in the system PATH. The server runs on Windows, macOS, and Linux.

How do I configure a global root directory?

Set the ROOT environment variable in your MCP server configuration. All search tools will then be automatically restricted to that directory unless overridden per call.

What default safety limits are applied?

Each search returns at most 100 matches, output is truncated at 10 MB, and a 30‑second timeout prevents hanging. These defaults can be overridden per tool call.

Can I override the root directory for a single search?

Yes. Pass a root parameter in the tool arguments to temporarily use a different base directory. That path is still validated against any server‑wide root.

How does Ripgrep Mcp handle cross‑platform paths?

It uses Node.js path utilities to automatically detect and normalize platform‑specific formats (e.g., Windows backslashes are converted to forward slashes). Relative paths are resolved relative to the root directory, and all paths are validated to prevent directory traversal.