MCP-Grep MCPサーバー

「MCP-Grep」MCPサーバーは何をしますか？

MCP-Grepは、UnixのgrepユーティリティのローカルインスタンスをラップするModel Context Protocol（MCP）サーバーです。これにより、その強力な検索機能がAIアシスタントやMCP対応クライアントから利用できるようになります。MCP-Grepはgrepをリソースおよびツールとして公開し、AIシステムや開発者が標準化されたAPI経由で高度なパターン検索、テキスト解析、ファイル探索タスクを実現できます。これにより、コードベースやログ、ドキュメント内のパターン検索、マッチ周辺のコンテキスト取得、システムのgrepバイナリの機能情報取得などのワークフローが可能です。MCP-Grepは自然言語プロンプト、LLM連携、MCPインスペクタによる対話的探索に対応しており、開発・デバッグ作業を強化します。

プロンプト例一覧

• MCP-Grepは、LLMと連携しやすい自然言語プロンプトをサポートしています。主なプロンプトテンプレート例は以下の通りです：
  • 基本検索： ファイル名内で「pattern」を検索
  • 大文字小文字を区別しない検索： ファイル名内で「PATTERN」を大文字小文字問わず全て探す
  • コンテキスト行付き検索： ファイル名内で「pattern」を検索し、各マッチの前後N行を表示
  • 再帰ディレクトリ検索： ディレクトリ内およびサブディレクトリで「pattern」を全て探す
  • 固定文字列検索： ファイル名内で正確に一致する「pattern」を検索
  • 結果の制限： ファイル名内で「pattern」が最初に出現するN件のみを表示
  • 複数オプションの組み合わせ： 条件に合致する全ファイルを大文字小文字問わず「pattern」を検索し、コンテキスト表示や結果数制限も指定

リソース一覧

• grep://info
  システムのgrepバイナリのパス、バージョン、対応機能などの情報を返します。

ツール一覧

• grep
  システムのgrepバイナリを使ってファイル内のパターン検索を実行します。大文字小文字を区別しない検索、コンテキスト行、最大マッチ数、固定文字列一致、再帰検索などのオプションもサポートしています。

このMCPサーバーの活用例

• ログ解析:
  大規模なログファイルから特定のエラーメッセージやパターンを素早く検索し、デバッグや自動監視を効率化します。
• コードベース探索:
  大規模ソースコードリポジトリ内で関数定義や変数利用、非推奨コードのパターンを検索できます。
• 設定ファイル検索:
  ディレクトリをまたいだ複数の設定ファイルから特定のパラメータや設定を発見し、監査やトラブルシューティングに活用できます。
• セキュリティ監査:
  コードやファイル中のハードコーディングされたシークレット、パスワード、不適切なパターンを検出し、セキュリティレビューに役立てます。
• ドキュメント検索:
  ドキュメントファイル内から該当セクションや用語、更新情報を素早く探し出せます。

セットアップ方法

Windsurf

1. Pythonとmcp-grepがインストールされていることを確認: pip install mcp-grep
2. Windsurfの設定ファイル（例: windsurf.config.json）を探します
3. mcpServersセクションに下記JSONを追加:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. 設定を保存してWindsurfを再起動します
5. WindsurfのMCPインターフェースからサーバーが利用できるか確認します

Claude

1. Smitheryでインストール:

   npx -y @smithery/cli install @erniebrodeur/mcp-grep --client claude
   

2. Claude Desktopの設定ファイルを開きます
3. MCP-Grepをサーバーとして追加:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. 保存してClaude Desktopを再起動します
5. サーバーパネルから統合ができているか確認します

Cursor

1. mcp-grepをインストール: pip install mcp-grep
2. CursorのMCP設定ファイルを編集
3. エントリーを追加:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. 設定を保存してCursorを再起動
5. Cursor内でMCPツールが利用可能か確認

Cline

1. pipでmcp-grepをインストール: pip install mcp-grep
2. ClineのMCP設定ファイルを探します
3. 下記を挿入:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. 保存してアプリケーションを再起動
5. ClineがMCPサーバーを認識しているか確認

APIキーの安全な設定

環境変数を設定する必要がある場合（高度な設定時）は、以下のパターンを利用してください:

{
  "mcpServers": {
    "mcp-grep": {
      "command": "mcp-grep-server",
      "args": [],
      "env": {
        "MY_SECRET_API_KEY": "${MY_SECRET_API_KEY}"
      },
      "inputs": {
        "api_key": "${MY_SECRET_API_KEY}"
      }
    }
  }
}

注: MCP-GrepはデフォルトでAPIキー不要ですが、安全なシークレットの扱い例としてこのパターンを示しています。

フロー内でMCPを使う方法

FlowHuntでMCPを使う

FlowHuntのワークフローにMCPサーバーを統合するには、まずMCPコンポーネントをフローに追加し、AIエージェントと接続します：

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションにて、以下のJSON形式でMCPサーバー情報を入力してください：

{
  "mcp-grep": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントは全機能・全能力を備えたこのMCPをツールとして利用できるようになります。“mcp-grep"はご自身のMCPサーバー名に、URLもご自身のMCPサーバーURLに置き換えてください。

概要

当社の見解

MCP-Grepは、人気grepユーティリティ向けにフォーカスされたMCP実装であり、明確なリソース・ツール定義・セットアップ手順を備えていますが、Rootsやサンプリング対応については記載されていません。そのシンプルさとドキュメントの明解さから、検索機能を必要とする開発者には堅実な選択肢ですが、高度なMCP機能カバーはありません。

MCPスコア

評価: 7/10
MCP-Grepはコア機能とドキュメント面で堅牢ですが、Rootsやサンプリングなど高度なMCP機能の明示的な記載はありません。検索タスク向けの実用的かつ適切なMCPサーバーです。