MCP Ripgrep Server

Name: MCP Ripgrep Server
Author: mcollina

@mcollina

Repository

About MCP Ripgrep Server

An MCP server to wrap ripgrep

Basic information

Config

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

{
  "mcpServers": {
    "ripgrep": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ripgrep@latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Ripgrep Server?

A Model Context Protocol (MCP) server that provides ripgrep (rg) search capabilities to any MCP client such as Claude. It enables high-performance text searches across files on the user's system.

How to use MCP Ripgrep Server?

Requires Node.js (v18 or higher) and ripgrep installed and available in your PATH. Configure the server in your Claude for Desktop configuration file by adding a "ripgrep" entry using npx -y mcp-ripgrep@latest as the command, then restart Claude for Desktop.

Key features of MCP Ripgrep Server

Basic text search with ripgrep
Advanced search with fixed strings and file type filtering
Count pattern matches in files
List files matching a search without running it
List all supported ripgrep file types

Use cases of MCP Ripgrep Server

Search for error patterns across a source code directory
Count TODO or FIXME occurrences in a project
List all JavaScript files in a directory matching a pattern
Perform advanced regex searches filtered by file type

FAQ from MCP Ripgrep Server

What are the prerequisites for MCP Ripgrep Server?

Node.js (v18 or higher) and the ripgrep (rg) command installed and available in your PATH. On macOS, install ripgrep with brew install ripgrep.

How do I configure MCP Ripgrep Server with Claude for Desktop?

Edit your Claude for Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the server entry with command: "npx" and args: ["-y", "mcp-ripgrep@latest"], then restart the application.

What tools does MCP Ripgrep Server provide?

Five tools: search, advanced-search, count-matches, list-files, and list-file-types. Each supports a pattern, path, and tool-specific options like file type, fixed strings, or hidden file inclusion.

Are there security considerations with MCP Ripgrep Server?

Yes. This server executes shell commands using the ripgrep tool. While arguments are safely escaped, use caution with input as commands run on your machine.

How does MCP Ripgrep Server communicate with clients?

It uses the Model Context Protocol (MCP), which is supported by clients like Claude for Desktop. The server exposes tools that the client can invoke to perform ripgrep searches.