MCP Ripgrep Server

Name: MCP Ripgrep Server
Author: mcollina

@mcollina

リポジトリ

MCP Ripgrep Server について

An MCP server to wrap ripgrep

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

mcollina

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.