跳到主要内容
Ed. notes

MCP Inspector:不接 Agent 也能调试 MCP 服务器

工具 · 2026-11-10

  • 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 客户端已经够用。

继续探索