面向 MCP 服务器的可视化测试与调试开发者工具,支持 Web UI 与 CLI 双模式,覆盖 stdio、SSE、streamable-http 三种传输协议。
MCP Inspector 是 Model Context Protocol 官方组织推出的 MCP 服务器调试工具。项目采用 Monorepo 架构,由 React 前端(MCPI)、Node.js 代理服务(MCPP)和命令行工具(CLI)三个子包组成。代理服务作为核心枢纽,同时承担 MCP 客户端和 HTTP 服务器的双重角色,将目标 MCP 服务器的 tools、resources、prompts 能力通过统一的 Web 界面或命令行暴露给开发者。
工具支持 stdio、SSE、streamable-http 三种传输协议的无缝切换测试,无需更换工具即可覆盖本地进程和远程服务两种场景。Web UI 提供实时交互调试能力,并支持一键导出服务器配置至 Cursor、Claude Code 等客户端。CLI 模式支持指定方法和参数进行单次调用,便于集成到 CI/CD 流水线或与编码助手配合使用。
安全方面,工具默认绑定 localhost,实现了基于随机 session token 的代理会话认证、SSE Bearer Token 认证、Origin 头验证(防 DNS Rebinding)等多层防护机制。支持通过 mcp.json 配置文件管理多个服务器连接,环境变量和 URL 查询参数提供灵活的运行时配置。提供官方 Docker 镜像,支持容器化部署。
快速启动:
npx @modelcontextprotocol/inspector
启动后访问 http://localhost:6274。
CLI 模式:
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/call --tool-name mytool --tool-arg key=value
关键环境变量: CLIENT_PORT(默认 6274)、SERVER_PORT(默认 6277)、HOST(默认 localhost)、MCP_AUTO_OPEN_ENABLED(默认 true)。
注意事项: 已知安全漏洞 CVE-2025-49596 与早期版本相关,当前版本(0.21.2)是否已修复需进一步确认。项目正处于从 MIT 向 Apache-2.0 的许可证过渡期。