HeadlinesBriefing favicon HeadlinesBriefing.com

mcpsnoop: Debugging AI Client-Server Tool Calls

Hacker News •
×

Developers can now get a clearer view into how AI clients interact with "MCP" (model-centric programming) servers thanks to mcpsnoop, a new transparent proxy. Unlike official tools that connect as separate clients, mcpsnoop sits directly in the communication path. This allows it to capture and display every JSON-RPC frame exchanged in real-time within your terminal, revealing unexpected arguments or silent tool failures.

This tool addresses a critical gap in debugging AI applications. When tools fail to call or capabilities misalign, developers often resort to log-tailing and guesswork. mcpsnoop provides a live terminal UI that color-codes requests, responses, and errors. It also includes a capability inspector to see client-server handshake agreements and a replay feature to re-run captured tool calls against an isolated server instance, speeding up iteration.

Installation is straightforward via Go or Homebrew, with a `demo` command available for immediate testing. mcpsnoop operates in two modes: as a transparent shim wrapping the server command, and as a standalone UI hub. This setup requires no complex configuration, automatically pairing the components. It offers granular filtering and detailed frame inspection, making it a powerful addition for AI developers.