MCP Ripgrep Server

MCP Ripgrep Server

Claude などのあらゆる MCP クライアントに ripgrep（rg）の検索機能を提供する MCP サーバーです。

概要

このサーバーは、高性能な検索ツールである ripgrep 用の Model Context Protocol（MCP）インターフェースを提供します。Claude AI などの MCP 対応クライアントが、システム上のファイルを対象に高速なテキスト検索を実行できるようにします。

前提条件

• Node.js（v18 以上）
• ripgrep（rg）コマンドがインストールされ、PATH から利用できること。macOS では brew install ripgrep でインストールします。

Claude for Desktop での使用方法

この MCP サーバーを Claude for Desktop で使用するには、次の手順に従います。

1. Claude for Desktop の設定ファイルを編集します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 次の内容を設定に追加します。

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

   /path/to/mcp-ripgrep を、このリポジトリをクローンした場所の絶対パスに置き換えてください。

3. Claude for Desktop を再起動します。

利用可能なツール

search

ripgrep による基本的な検索です。

Pattern: error
Path: ./src

advanced-search

追加オプションを指定できる、より高度な検索です。

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

count-matches

パターンの出現回数を数えます。

Pattern: TODO
Path: ./src
CountLines: true

list-files

実際に検索せず、検索対象となるファイルを一覧表示します。

Path: ./src
FileType: js

list-file-types

ripgrep でサポートされているすべてのファイルタイプを一覧表示します。

セキュリティに関する注意事項

この MCP サーバーは ripgrep ツールを使用してシェルコマンドを実行します。引数を安全にエスケープするための対策を講じていますが、マシン上でコマンドが実行されるため、入力を与える際は注意してください。

ライセンス

MIT