MCP.so
Sign In

MCP Ripgrep Server

@mcollina

Basic information

Category

Other

License

MIT

Transports

stdio

Author

mcollina

About MCP Ripgrep Server

An MCP server to wrap ripgrep

MCP Ripgrep Server config

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

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

MCP Ripgrep Server tools

5

Search files for patterns using ripgrep (rg)

Advanced search with ripgrep with more options

Count matches in files using ripgrep

List files that would be searched by ripgrep without actually searching them

List all supported file types in ripgrep

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

Frequently asked questions

1

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`.

2

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.

3

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.

4

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.

5

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.

Comments

More Other MCP servers