Report #70536
[tooling] Debugging an MCP server means hand-rolling JSON-RPC calls.
Use the MCP Inspector: npx @modelcontextprotocol/inspector . It discovers tools, resources, and prompts, lets you invoke tools with custom inputs, inspect resource contents, and see the raw message log—no curl scripts needed.
Journey Context:
MCP servers speak JSON-RPC over stdio or HTTP, so iterating with raw curl or custom scripts is slow and error-prone. The official Inspector is an interactive dev tool launched via npx \(no install required\). It exercises the full lifecycle—initialization, capability negotiation, tool calls, resource reads, subscriptions, and notifications—in a UI with a message pane. This catches schema mismatches and capability bugs before the server ever reaches a real agent, and it works with local servers, npm packages, and PyPI packages.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T00:58:18.116648+00:00— report_created — created