kerlenton/mcpsnoop

何を解決するか

mcpsnoop は Model Context Protocol (MCP) のための透過プロキシであり、"MCP用の Wireshark" として機能します。AIクライアント（Cursor、Claude Code、Codexなど）とそのMCPサーバー間の実際の通信内容を可視化するという問題を解決します。公式の MCP Inspector とは異なり、独自のクライアントとして動作するのではなく、mcpsnoop はデータパスの直接中間に配置され、すべての実際のツール呼び出しを確認でき、凍結した呼び出しを特定し、不正なJSON-RPCフレームを検出し、ツール定義のずれを発見できます。

動作方法

このツールは1つのバイナリ内で2つの役割を果たします：透過シャムとハブ。シャムとして使用する場合（mcpsnoop -- <server>）、クライアントとサーバー間のバイトをそのまま転送しながら、すべてのフレームをハブにコピーします。ハブ（引数なしで mcpsnoop を実行）は、ライブなターミナルユーザーインターフェース（TUI）を提供し、トラフィックを監視・分析できます。これらの2つのコンポーネントは、既知のソケットとディスク上のログを介して自動的にペアリングされます。stdioおよびストリーミングHTTPサーバーの両方をサポートしており、GitHub Actionを介してCI/CDパイプラインに統合でき、エラーまたはレイテンシ予算に違反した場合にジョブを失敗させることができます。

対象ユーザー

MCPサーバーやAIクライアントの開発・デバッグを行う開発者で、JSON-RPCトラフィックおよびツール実行パフォーマンスに関するリアルタイムかつ高精度の可視性が必要な方。

特徴

• リアルタイム監視：ツール呼び出しやJSON-RPCフレームをリアルタイムで監視できるライブTUI。
• CI統合：コードスキャンアラートを発行し、ゲート付きエラーでジョブを失敗させるGitHub Action。
• HTTPプロキシング：詳細なHTTPステータス追跡を備えたストリーミングHTTPサーバーに対応。
• 観測性：ツール呼び出しの合計数、エラー率、レイテンシヒストグラムなどのPrometheusメトリクスを内蔵。
• セッション管理：セッションをJSON、HTML、テキスト、HAR、OTLP形式にエクスポートでき、事後分析に利用可能。
• マスキング：共有前にログからシークレット、キー、特定のパスをクリーニングするためのツールを提供。
• ゼロ構成セットアップ：Claude Desktopの設定に簡単な wrap/unwrap コマンドで対応可能。