Advertise
MCP.so
Sign In
R

Ripgrep MCP Server

@superauu

Repository

Basic information

Category

Other

Transports

stdio

Author

superauu

Submitted by

Yibo Li

About Ripgrep MCP Server

Auu.Mcp.Rg

#ripgrep

Ripgrep MCP Server 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"
      }
    }
  }
}

Ripgrep MCP Server 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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

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

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K
Advertise