MCP Inspector 本地调试全流程指南

JSON Parse Error: 检查服务代码中是否有误用的 <code class="bg-zinc-100 dark:bg-zinc-800 text-zinc-900 dark:text-zinc-100 px-1.5 py-0.5 rounded text-xs font-mono">console.log 污染了标准输出。
Schema Validation Failed: 检查入参字段的必填项 (<code class="bg-zinc-100 dark:bg-zinc-800 text-zinc-900 dark:text-zinc-100 px-1.5 py-0.5 rounded text-xs font-mono">required ) 是否与模型实际传入相符。
Connection Refused: 检查 Node/Python 可执行文件路径是否具有读写权限。

为什么需要 MCP Inspector？

在将自定义 MCP Server 接入 Claude Desktop 或 Cursor 之前，常常会遇到“工具不显示”、“参数校验报错”或“子进程静默退出”的问题。

如果每次都在 IDE 中反复重启排查，效率极低。Anthropic 官方提供了 @modelcontextprotocol/inspector，它是一个独立的 WebUI 调试客户端，能够直观模拟客户端调用全过程。

直接通过 npx 启动并指定目标 Server：

# 调试本地 Node.js 脚本
npx @modelcontextprotocol/inspector node dist/index.js

# 调试 Python 脚本
npx @modelcontextprotocol/inspector python server.py

启动后控制台会输出本地 Web 地址（通常为 http://localhost:5173），在浏览器中打开即可。

协议初始化握手检查：观察 initialize 请求中客户端与服务端协商的 capabilities，确认 tools/resources 是否被正确激活。
工具列表 (Tools) 可视化：查看每个工具的 description、inputSchema，并提供动态生成的表单，可以直接输入参数点击「Call Tool」进行测试。
JSON-RPC 原始报文监控：切换到「Console」标签页，可以实时看到发送与接收的每个 JSON 帧（包括 id、method、params、result 和 error）。