MCP Inspector:不接 Agent 也能调试 MCP 服务器
结论
MCP Inspector 是 MCP 服务器的调试入口,不参与业务。它能在命令行里完成握手、列工具、看参数 schema、调用工具,也能开网页 UI;排查「服务器有没有启动、工具名对不对、参数怎么填」时,比反复改客户端配置快得多。
它解决什么问题
MCP 出错时,客户端往往只给一句连接失败,既不说是启动失败、传输不兼容,还是工具参数不对。Inspector 把服务器单独拉起来,直接显示初始化结果、工具清单和调用响应,把问题缩小到服务器、传输或参数中的一层。对写服务器的人来说,它也是不依赖具体客户端的验收工具。
我的实验
用 --cli 检查 Filesystem MCP:
npx @modelcontextprotocol/inspector --cli \
npx -y @modelcontextprotocol/server-filesystem@2.2.0 /path/to/repo \
--method tools/list
返回 16 个工具及完整 inputSchema。用同样方式检查 Playwright MCP,得到 25 个浏览器工具;再调用 browser_navigate 打开 example.com,直接看到页面标题和快照路径。整个过程没有接入任何 Agent 客户端。先列 schema 再调用,也能在写客户端代码前确认参数名和必填项。
限制
- CLI 模式一次命令对应一个会话,多步交互要重复启动 server,状态不保留。
- 复杂调试仍建议用网页 UI,能看到资源、提示词和调用历史。
- Inspector 2.14.0 声明需要 Node
^24.22.1,本机 24.18 会有引擎警告,实测可用但不应依赖。 - 输出是 JSON,适合脚本处理;人工阅读时建议配合
jq。
适合谁
正在写或接入 MCP 服务器的人。只是日常使用现成服务器时,Agent 客户端已经够用。