inspector
活跃·★ 11.1k·Apache-2.0 / MIT (transitioning)·更新于 2026-10-13
★ 时下流行
MCP Inspector 是检查 Model Context Protocol Server 的官方开发工具。它以一个包的形式发布,提供三种界面:用于交互式探索 Server 的网页界面;用于自动化、CI 和编程 Agent 快速反馈的可脚本化 CLI;以及终端界面。你可以连接一个 Server,列出并调用它的工具、读取资源、试用提示模板,还能查看原始的协议通信内容。
对于开发或调试 MCP Server 的人来说,它是必备工具:检查工具的 schema 和描述是否正确、复现客户端反馈的问题、测试 OAuth 流程,或者在发布 Server 前在 CI 中运行自动化检查。当前的 v2 版本重新组织了配置方式(把 `--config` 和 `--catalog` 分开),并要求更新版本的 Node.js;官方提供了从 v1 迁移的指南。
上手方式:运行 `npx @modelcontextprotocol/inspector` 打开网页界面,加上 `--cli` 或 `--tui` 则使用另外两种界面。Python SDK 的 `mcp dev` 命令也会直接在 Inspector 中打开你的 Server。
#开发工具#调试#测试#Web界面#协议
01
功能特性
01用于测试和调试 MCP 服务器的交互式 Web 用户界面。
02支持多种传输协议(stdio、SSE、流式HTTP)。
03用于脚本、自动化和集成的命令行界面模式。
04导出服务器启动配置以供外部客户端(如 Cursor、Claude Code)使用。
05强大的安全功能,包括令牌认证和本地绑定。
02
为什么选择它
+MCP 项目官方工具,始终与最新的协议特性保持一致。
+三种界面:网页用于探索,CLI 用于自动化和 CI,TUI 用于终端。
+能显示原始协议通信,排查客户端与 Server 之间的问题容易得多。
+默认把 OAuth 令牌和密钥保存在操作系统的钥匙串中。
03
权衡点
!v2 修改了 CLI 参数和配置方式,存在不兼容变更,并要求 Node.js 22.19 或更高版本。
!在没有系统钥匙串的机器上,密钥会退回到安全性较低的存储方式;请阅读 README 中的警告。
!它是开发者工具,最终用户并不需要。
04
兼容性
MCP Servers
原生支持
已通过文档验证
Cursor
配置导出
已通过文档验证
Claude Code
配置导出
已通过文档验证
Docker
容器化部署
已通过文档验证
05
快速开始
1
$ npx @modelcontextprotocol/inspector
06
使用场景
↳在开发过程中测试和调试 MCP 服务器实现。
↳通过 CLI 与 MCP 服务器进行编程交互,用于脚本和自动化。
↳配置和管理不同环境或项目的 MCP 服务器设置。
07
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧