一、项目介绍

MCP（模型上下文协议）让 AI 应用能统一接入各种工具和服务，但当你写好一个 MCP 服务器后，怎么确认它真的能被模型正确调用？参数对不对、返回结构漂不漂亮、流式是否正常，往往只能靠在客户端里盲试。
MCP Inspector 是协议官方的调试器，提供 Web、CLI、TUI 三种形态。你可以把它指向任意一个本地或远程的 MCP 服务器，直观地浏览它的工具、资源、提示词，并手动发起调用、查看请求响应。它相当于 MCP 世界的接口测试工具，把联调从碰运气变成可观测。

二、项目基本信息

信息项详情
项目名称inspector
GitHub地址https://github.com/modelcontextprotocol/inspector
项目描述Visual testing tool for MCP servers
作者modelcontextprotocol
开源协议Apache-2.0
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-25

三、核心优势

  • 三形态：Web 界面、命令行 CLI、终端 TUI 按需选用
  • 即连即测：一条命令指向目标服务器即可发起调用
  • 可观测：请求参数、返回结构、错误一目了然
  • 官方维护：与 MCP 协议规范同步演进
  • 适合 CI：CLI 形态可嵌入自动化与流水线

四、适用场景

适合 MCP 服务器开发者做联调与回归测试，也适合 AI 应用工程师在接入第三方 MCP 前先验证其行为。

五、安装教程

当前最新版本 2.12.0。按下方命令安装（如遇网络问题可切换镜像源）：

npx @modelcontextprotocol/inspector

常见报错：依赖缺失时先升级运行环境（如 Node、Python、.NET、JDK）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。

六、使用示例

下面是一段可直接运行或参考的真实示例：

npx @modelcontextprotocol/inspector --cli
# 直接调试某个 MCP 服务器（例如官方示例）
npx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-everything

七、常见问题

问：它只能测官方的服务器吗？答：不是，任何遵循 MCP 的服务器都能连。问：CLI 能进 CI 吗？答：可以，CLI 形态专为自动化与快速反馈设计，适合写进测试流程。

八、总结

inspector 用一个清晰的设计，把把联调过程变得可观测这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。