Ripgrep Mcp

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.