mcp-ripgrep

Ripgrep MCP Server

mcp-ripgrep brings ripgrep-based file search to Claude and other MCP clients. It offers pattern searches, additional search controls, match counts, and file discovery for users working with files on their own system.

Server facts

mcp-ripgrep

Project

Author
mcollina
License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
78
Last commit
Data as of

Overview

Local text search is the focus of mcp-ripgrep, which exposes ripgrep through an MCP interface for Claude and other compatible clients. Its search tool accepts a pattern and a target path, while advanced-search adds controls for literal-string matching, file types, and hidden-file inclusion. For examining search scope before looking for content, list-files returns candidate files without performing a content search. The separate list-file-types tool reports ripgrep’s supported type definitions, and count-matches provides counting functionality, including an option to count matching lines.

The project runs on Node.js and uses stdio for transport. Its documented prerequisites are Node.js version 18 or later and an installed ripgrep executable available through PATH. Claude for Desktop setup involves adding the server to the client configuration and restarting the application. Because the server invokes ripgrep through shell commands on the local machine, the documentation advises caution with supplied input despite its argument-escaping measures. The code is distributed under the MIT license.

mcp-ripgrep setup notes

  • mcp-ripgrep records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers