modelcontextprotocol/inspector

项目概览

该工具提供了专门针对 MCP 服务器测试的可视化界面与命令行模式，填补了 MCP 服务器调试缺乏专用交互工具的空白；其本地优先的默认安全设置（localhost 绑定、令牌认证、DNS 重绑定防护）降低了本地调试时的安全风险。

项目类型

MCP · 基础设施

应用场景

知识问答

部署方式

查看项目说明

License

License 待确认

适合谁

• 需要在本地对 MCP 服务器进行交互式测试与调试、排查响应错误的开发者。
• 需要将 MCP 服务器测试集成到自动化脚本或 CI/CD 流程中的测试工程师。

核心能力

• 提供一个基于 React 构建的 Web 界面，用于交互式地测试和调试 MCP 服务器。它允许用户输入参数并向服务器发送请求，从而获取可视化的服务器响应、错误详情及请求历史记录。
• 运行一个 Node.js 代理服务器，充当协议桥梁，将 Web UI 连接到通过 stdio、SSE 和 streamable-http 传输方式通信的 MCP 服务器。
• 启用从命令行以编程方式与 MCP 服务器交互的能力。该功能可用于编写脚本、实现自动化测试流程，以及与编码助手进行集成。
• 在用户界面上提供操作按钮，允许用户复制或导出服务器的启动配置（例如 mcp.json 文件），以便在客户端环境中直接使用。
• 通过生成随机的会话令牌作为 Bearer Token，对连接到代理服务器的请求进行身份验证，以确保访问受控。
• 对传入 Web 请求的 Origin 标头进行验证，以防止针对本地代理服务器的 DNS 重绑定攻击。

限制与风险

• 如果将工具绑定到所有网络接口而非默认的 localhost，将暴露代理服务器执行本地进程的能力，从而带来安全风险。
• 其设计目标为开发与调试，并未设计用于拦截生产环境网络流量或进行生产服务器的监控。

如何开始

• 上手难度低。无需克隆代码仓库，可直接通过 npx 命令运行；同时也提供了预构建的 Docker 容器。首次成功运行的路径为：执行 npx @modelcontextprotocol/inspector 命令，然后在浏览器中访问 http://localhost:6274 即可打开界面。

核验依据

• README: The MCP inspector is a developer tool for testing and debugging MCP servers.
• README: The MCP Inspector consists of two main components that work together: - **MCP Inspector Client (MCPI)**: A React-based web UI that provides an interactive interface for testing an…
• README: - Node.js: ^22.7.5
• README: The MCP Inspector proxy server requires authentication by default. When starting the server, a random session token is generated and printed to the console:
• README: CLI mode enables programmatic interaction with MCP servers from the command line, ideal for scripting, automation, and integration with coding assistants. This creates an efficien…

内容核验时间：