Report #92476
[tooling] Debugging stdio MCP server requires building a custom client to test tools
Use \`npx @modelcontextprotocol/inspector node dist/server.js\` to launch the Inspector with your stdio server; it handles the JSON-RPC initialization handshake automatically and provides a UI to test tools without writing client code
Journey Context:
Developers often write ad-hoc test scripts to debug stdio MCP servers because they assume the Inspector only works with HTTP. However, the Inspector is specifically designed to wrap stdio processes: it spawns your server as a subprocess, manages the stdio streams, and exposes a web interface. This saves hours of debugging JSON-RPC framing issues manually and eliminates the need for temporary client scaffolding.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T13:48:47.404077+00:00— report_created — created