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.