kerlenton/mcpsnoop

何を解決するか

mcpsnoop は「MCP の Wireshark」として機能し、AI クライアント（Cursor や Claude Code など）と Model Context Protocol (MCP) サーバー間の通信を透明に監視・デバッグするツールです。他のインスペクタが独自のクライアントとして動作するのとは異なり、mcpsnoop はデータパスの直接的な中継として機能し、実際のクライアントが送信する内容とサーバーの応答を正確に確認できます。また、モデルが呼び出しを失敗した場合や引数が誤っている呼び出しを特定することも可能です。

動作方法

MCP サーバーのコマンドをラップする透明なシェイムとして動作します。クライアントとサーバー間のバイトをそのまま転送しながら、すべての JSON-RPC フレームをハブにコピーします。このハブはリアルタイム監視用のライブ端末ユーザーインターフェース（TUI）を提供します。stdio ベースのサーバーとストリーミング HTTP サーバー（リバースプロキシとして動作）の両方をサポートしており、構造化された観測性のために OpenTelemetry スパンとしてデータをエクスポートできます。

対象ユーザー

MCP サーバーや AI エージェントの開発・デバッグが必要な開発者で、ツール呼び出し、レイテンシ、プロトコルエラーのトラブルシューティングに必要な実際の通信レベルの情報を得たい方。

主な特徴

• 透明な監視: クライアントやサーバーのコード変更なしに、実際のデータパスに直接配置可能。
• CI/CD 統合: エラー、無効なフレーム、レイテンシ予算の超過に基づいてビルドを失敗させる GitHub Action を提供。
• 観測性: OpenTelemetry へのエクスポートと、ツールパフォーマンス用のライブ Prometheus メトリクスを提供。
• 多様なデプロイ: stdio および HTTP サーバーをサポート。Claude Desktop の設定を簡単にラップ/アンラップするヘルパー コマンドも提供。
• セッション管理: キャプチャしたセッションをモック化、2つのセッションの差分を比較、過去のログをレビューして事後分析（post-mortems）が可能。