MCP Inspector：上线前先给服务器做体检

MCP Inspector 是官方出的确定性测试工具：在把 MCP 服务器交给 AI 客户端之前，先用它把工具、资源、提示和高亮错误逐项验一遍。

写完一个 MCP 服务器，直接丢给 Claude 或 Cursor 试，出了问题很难判断是服务器、客户端还是配置的事。MCP Inspector 是 Model Context Protocol 官方提供的调试工具，能连上你的服务器，列出它暴露的工具（tools）、资源（resources）与提示（prompts），让你逐个调用、传参、看返回，把问题定位在「这一项」。仓库 modelcontextprotocol/inspector 以 TypeScript 编写、2026 年仍在活跃维护，是开发和排错 MCP 时的标配。

信息卡

• 连接器名称：MCP Inspector（官方调试器）
• 传输方式：本地 Web 界面 + 代理，连接 stdio / SSE / HTTP 各类服务器
• 适用客户端：MCP 服务器开发者与调试者（独立于具体 AI 客户端）
• 配置示例(json)：见下方使用上手
• 仓库地址：https://github.com/modelcontextprotocol/inspector （官方文档 modelcontextprotocol.io）

核心能力

逐项列出并调用工具。 Inspector 连上服务器后，把工具清单、参数 schema 列出来，你可以填参数直接调用，即时看到返回或报错。这比在 AI 对话里绕一大圈试错直接得多——是「工具定义写错了」还是「参数传错了」，一眼就能分清。对调试新写的工具尤其省时。

资源与提示的检查。 除工具外，还能查看服务器暴露的 resources 与 prompts，确认它们是否按预期注册、内容是否正确。一个 MCP 服务器往往不止工具，资源与提示同样需要验证，Inspector 把这些都纳入检查范围。

确定性测试与错误高亮。 官方描述强调「确定性测试工具」——同样输入应有同样输出，便于回归验证。界面会高亮错误信息，帮开发者快速定位问题所在。配合自动化的测试脚本，还能把检查纳入开发流程，避免改一处坏一处。

跨传输方式通用。 不管你的服务器用 stdio、SSE 还是 Streamable HTTP，Inspector 都能连接测试。这让它在本地开发与远程部署两种形态下都派得上用场。具体支持的传输与启动参数以仓库 README 为准。

使用上手

1. 确认 Node.js 环境；仓库提供 npx 直接运行的方式。
2. 启动 Inspector，它会拉起一个本地 Web 界面与代理进程。
3. 在界面里选择传输类型（stdio/SSE/HTTP），填入你服务器的启动命令或端点 URL。
4. 连接后浏览工具/resource/prompt 列表，逐个调用、传参、查看返回，定位问题。
5. 修好后重复验证，确认无报错再接入 Claude、Cursor 等正式客户端。

配置示例

启动本地 Inspector（命令以仓库 README 为准）：

npx @modelcontextprotocol/inspector node your-server.js

或在界面中填写要连接的服务器命令/端点。

优点与不足

优势是官方出品、逐项可视化调试、错误高亮清晰、跨传输通用、能显著提升开发效率。局限：它是开发者工具，不是给终端用户连业务的连接器；本地界面与代理需 Node 环境；具体命令、参数与功能以仓库 README 为准，版本演进较快。

适合谁

适合正在开发或调试 MCP 服务器的程序员；接入第三方 MCP 前想先验明工具与权限的谨慎使用者；以及需要给自研服务器做回归测试、保证质量的团队。

下载与访问

仓库 https://github.com/modelcontextprotocol/inspector ；官方文档 modelcontextprotocol.io（含 Inspector 使用说明）。

许可证与获取

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。