MCP Ripgrep

🚀 MCP 汎用grepサーバー

このサーバーは、強力なripgrep検索ツールに対して、Model Context Protocol (MCP) インターフェイスを提供します。Claude AIやその他のMCP互換クライアントが、システム上のファイルに対して高性能なテキスト検索を実行できるようになります。

🚀 クイックスタート

このサーバーは、強力なripgrep検索ツールに対して、Model Context Protocol (MCP) インターフェイスを提供します。Claude AIやその他のMCP互換クライアントが、システム上のファイルに対して高性能なテキスト検索を実行できるようになります。

✨ 主な機能

• 強力なripgrep検索ツールに対して、Model Context Protocol (MCP) インターフェイスを提供します。
• Claude AIやその他のMCP互換クライアントが、システム上のファイルに対して高性能なテキスト検索を実行できるようになります。

📦 インストール

前提条件

• Node.js（v18 以上）
• ripgrep (rg) コマンドがインストールされ、PATHに追加されていること。macOSでは brew install ripgrep を使用してインストールできます。

💻 使用例

基本的な使用法

Claude Desktopとの連携

1. Claude 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 Desktopを再起動します。

高度な使用法

利用可能なツール

検索

基本的なripgrep検索：

パターン：error
パス：./src

高度な検索

より多くのオプションを持つ高度な検索：

パターン：function
パス：./src
固定文字列：true
ファイルタイプ：ts
隠しファイルを含める：false

一致数の計算

パターンの出現回数を計算する：

パターン：TODO
パス：./src
行数を計算する：true

ファイルのリスト表示

実際に検索を実行せずに、検索対象となるファイルをリスト表示する：

パス：./src
ファイルタイプ：js

ファイルタイプのリスト表示

ripgrepがサポートするすべてのファイルタイプをリスト表示する。

📚 ドキュメント

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

このMCPサーバーは、ripgrepツールを使用してシェルコマンドを実行します。パラメータを安全にエスケープするよう努めていますが、入力を提供する際は注意してください。これらのコマンドはあなたのマシン上で実行されます。

📄 ライセンス

MIT