kerlenton/mcpsnoop

Wireshark for MCP. mcpsnoop은 AI 클라이언트와 MCP 서버 사이에 위치해 있습니다 그리고 양쪽 모두에 변화가 없도록 모든 JSON-RPC 프레임을 기록합니다. 터미널에서 실시간으로 시청하거나, CI가 발견한 것에 실패하거나, 아니면 당신의 OpenTelemetry 범위에 따라 백엔드를 추적하는 것.

문제는

공식 MCP 검사관 자신의 클라이언트로 연결되기 때문에, 당신의 클라이언트(커서, 클로드)를 전혀 볼 수 없습니다. 코드, 코덱스)는 실제로 서버를 보냅니다. 그리고 요청을 기다리는 모든 것들 도착하면 모델이 하지 않았거나 잘못된 통화를 할 수 없습니다 인수. 도구가 조용히 호출되지 않거나, 능력이 일치하지 않거나, 통화가 계속 걸리고, 로그를 뒤지며 추측만 하게 됩니다.

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