MCP.so
Sign In
R

Ripgrep Mcp

@superauu

Repository

About Ripgrep Mcp

Auu.Mcp.Rg

#ripgrep

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

5

Search for a pattern using ripgrep

Advanced search with all ripgrep options

Count matches for a pattern

List all files that would be searched

List all supported file types

Overview

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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

Transports

stdio

Author

superauu

Submitted by

Yibo Li

More Other MCP servers

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K