kerlenton/mcpsnoop

MCP用のWireshark。 mcpsnoopはAIクライアントとMCPサーバーの間に位置します 交換するすべてのJSON-RPCフレームを記録し、両側に変化はありません。 端末でライブ視聴し、CIで検出に失敗するか、またはあなたのサイトに送信してください OpenTelemetryがスパンする際のバックエンドのトレース。

問題

公式MCP検査官 自分のクライアントとして接続するため、あなたのクライアント(カーソル、Claude)を決して見ることができません Codex)は実際にあなたのサーバーを送ります。そしてリクエストを待つものはすべて 到着は、モデルが行っていない、または間違ったもので作ったコールを表示できません 引数。ツールが無音で呼び出されなかったり、能力が一致しなかったり、 通話はただ止まらず、ログを掘り返して推測するしかありません。

mcpsnoopは実際のデータパスに位置します。 サーバーコマンドを そして、実際のクライアントとサーバーが話すように、すべてのJSON-RPCフレームをリアルタイムで監視します。

CIで

このページはまた、mcpsnoopのGitHub Actionの一覧でもあります。 これが全体の構成です。キャプチャされたセッションをチェックし、すべての発見を次のようにファイルします コードスキャンのアラートが出て、あなたがゲートしたもので失敗します。

手元にキャプチャがない?自分のクライアントと一度だけセッションを録音して、それをコミットし、

Wireshark for MCP. mcpsnoop sits between your AI client and your MCP server and records every JSON-RPC frame they exchange, with no change to either side. Watch it live in your terminal, fail CI on what it finds, or send it to your tracing backend as OpenTelemetry spans.

The problem

The official MCP Inspector connects as its own client, so it never sees what your client (Cursor, Claude Code, Codex) actually sends your server. And anything that waits for a request to arrive can’t show the call the model never made, or made with the wrong arguments. When a tool silently isn’t called, capabilities don’t line up, or a call just hangs, you’re left digging through logs and guessing.

mcpsnoop sits in the real data path instead. Wrap your server command with it and watch every JSON-RPC frame live, as your real client and server talk.

In CI

This page is also the listing for the mcpsnoop GitHub Action, so here is the whole of it. It checks a captured session, files every finding as a code scanning alert, and fails the job on what you gated on.

permissions:
  security-events: write
  contents: read

steps:
  - uses: kerlenton/[email protected]
    with:
      session: artifacts/session.jsonl

No capture to hand? Record one session with your own client once, commit it, and let the action replay it against every build. No model and no API key run in CI. The replay is checked like any capture, and the job also fails when the server got worse than in the recording. A server reached over Streamable HTTP gets target with its endpoint, and a recording replays over either transport.

steps:
  - uses: kerlenton/[email protected]
    with:
      replay: tests/mcp/claude-code-session.jsonl
      server: node dist/index.js

Pin whichever release you want. The newest is on the releases page. Every input and output is in The GitHub Action further down, and every signal the check can fail on is in docs/CI.md.

OpenTelemetry

MCP revision 2026-07-28 deprecates protocol-level Logging and tells implementations to move to stderr on stdio, or to OpenTelemetry for structured