file-systemsdeveloper-tools

Ripgrep▌

by mcollina

Ripgrep offers high-performance text search, ideal for SEO optimization software and rapid content discovery across loca

Provides high-performance text search capabilities by wrapping ripgrep, enabling powerful file exploration, pattern matching, and content discovery across local filesystems.

github stars

★ 63

GitHub npm

High-performance ripgrep backendRequires ripgrep installed locally

best for

/ Developers exploring large codebases
/ Content analysis across multiple files
/ Code review and debugging workflows

capabilities

/ Search files for text patterns
/ Count pattern matches in files
/ List files by type without searching
/ Perform advanced searches with filters
/ View supported file types

what it does

Provides high-performance text search across your local files using the ripgrep tool. Lets you search for patterns, count matches, and explore file contents from within MCP-compatible applications.

about

Ripgrep is a community-built MCP server published by mcollina that provides AI assistants with tools and capabilities via the Model Context Protocol. Ripgrep offers high-performance text search, ideal for SEO optimization software and rapid content discovery across loca It is categorized under file systems, developer tools. This server exposes 5 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Ripgrep in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Ripgrep is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

MCP Ripgrep Server

An MCP server that provides ripgrep (rg) search capabilities to any MCP client such as Claude.

Overview

This server provides a Model Context Protocol (MCP) interface for the powerful ripgrep search tool. It enables Claude AI and other MCP-compatible clients to perform high-performance text searches across files on your system.

Prerequisites

Node.js (v18 or higher)
ripgrep (rg) command installed and available in your PATH. Install it with brew install ripgrep on macOS.

Usage with Claude for Desktop

To use this MCP server with Claude for Desktop:

Edit your Claude for Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following to your configuration:

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

Replace /path/to/mcp-ripgrep with the absolute path to where you cloned this repository.

Restart Claude for Desktop.

Available Tools

search

Basic search with ripgrep:

Pattern: error
Path: ./src

advanced-search

More advanced search with additional options:

Pattern: function
Path: ./src
FixedStrings: true
FileType: ts
IncludeHidden: false

count-matches

Count occurrences of a pattern:

Pattern: TODO
Path: ./src
CountLines: true

list-files

List files that would be searched without actually searching them:

Path: ./src
FileType: js

list-file-types

List all supported file types in ripgrep.

Security Considerations

This MCP server executes shell commands using the ripgrep tool. While efforts have been made to safely escape arguments, use caution when providing input as it runs commands on your machine.

License

MIT