Инструмент mcpsnoop — это прозрачный прокси для отладки трафика между AI-клиентом и MCP-сервером. Он решает проблему официального MCP Inspector: тот подключается как отдельный клиент и не видит, что на самом деле передаёт ваш реальный клиент (Claude Desktop, Cursor, Claude Code). Брейкпоинт на сервере срабатывает только когда запрос уже дошёл — а если клиент его не отправил, послал не те аргументы или вызов просто завис, приходится гадать и копаться в логах в /tmp.
mcpsnoop садится прямо на путь данных. Вы оборачиваете команду сервера этой утилитой — и в терминале появляется живой UI со всеми JSON-RPC фреймами между реальным клиентом и сервером. Для работы достаточно изменить конфиг MCP-клиента: всё после -- — это команда запуска вашего сервера (например, node build/index.js, python server.py или npx -y @scope/server). Никаких флагов, путей к сокетам или порядка запуска запоминать не нужно — шлюз и UI находят друг друга сами и подгружают старые сессии с диска.
Для streamable-HTTP сервера mcpsnoop работает как reverse proxy: mcpsnoop http --target http://localhost:3000/mcp --listen :7000.
Ключевые возможности: цветной поток запросов, ответов, нотификаций и stderr сервера с пометкой ошибок и медленных вызовов. Любой захваченный вызов можно перезапустить на чистой копии сервера (клавиша r) — это быстрейший способ итерации. Инспектор возможностей (c) показывает, о чём договорились клиент и сервер при рукопожатии. Инспектор фреймов (enter) даёт полный JSON с поиском. Зависшие вызовы видны сразу — статус PENDING с таймером. Есть полноценный поиск: tool:, status:, dir:, kind:, id: и просто текст.
Сравнение с аналогами: mcp-trace и MCP Inspector не дают нуль-конфига, интерактивного терминала, повтора вызовов и инспектора возможностей. mcpsnoop — один бинарник без рантайм-зависимостей.
Установка: go install github.com/kerlenton/mcpsnoop/cmd/mcpsnoop@latest или через Homebrew (brew install mcpsnoop). Для Homebrew нужно либо доверить tap (brew trust kerlenton/mcpsnoop), либо дождаться попадания в core — для этого проекту нужны звёзды на GitHub. Готовые бинарники под разные платформы — на странице Releases.
Важно: mcpsnoop запускает переданную команду сервера — доверяйте только тому, что сами прописали в конфиге, сомнительные серверы запускайте в контейнере. Проект под MIT, на стадии pre-1.0, следует SemVer: минорные версии могут менять поведение, патчи — только багфиксы.