kerlenton/mcpsnoop

Wireshark для MCP. mcpsnoop находится между вашим AI-клиентом и MCP-сервером и записывает каждый обмен кадрами JSON-RPC, без изменений ни с одной стороны. Смотрите его в прямом эфире в терминале, проваливайте CI на то, что найдёт, или отправляйте на свой отслеживание бэкэнда по мере охватки OpenTelemetry.

Проблема

Официальный инспектор MCP подключается как собственный клиент, поэтому никогда не видит, что ваш клиент (Курсор, Клод Code, Codex) фактически отправляет ваш сервер. И всё, что ждёт запроса Чтобы прийти, нельзя показывать звонок, который модель так и не сделала, или сделала неправильным аргументы. Когда инструмент молча не вызывается, возможности не совпадают, или Колл зависает, ты остаёшься копаться в бревнах и гадать.

mcpsnoop находится в реальном канале данных. Оберните серверную команду с и смотреть каждый кадр JSON-RPC в реальном времени, пока ваш реальный клиент и сервер общаются.

В CI

Эта страница также содержит объявление для действия mcpsnoop на GitHub, Вот всё. Он проверяет захваченную сессию, фиксирует каждое находку как Оповещение о сканировании кода, и он провалил задание на том месте, на котором вы зашли.

Нет захвата под рукой? Записывайте одну сессию с вашим клиентом один раз, фиксируйте её,

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