9.3k
Stars
+203
Stars/month
10
Releases (6m)
Star Growth
+44 (0.5%)
Overview
MCP Inspector 是一个专为开发者设计的可视化测试工具，用于调试和验证 MCP（Model Context Protocol）服务器的功能。该工具采用双组件架构：MCP Inspector Client（MCPI）提供基于 React 的直观网页界面，而 MCP Proxy（MCPP）作为协议桥梁，支持多种传输方式（stdio、SSE、streamable-http）连接到 MCP 服务器。这种设计使开发者能够在浏览器环境中轻松测试原本需要命令行交互的 MCP 服务器。工具支持传递自定义参数和环境变量给 MCP 服务器，提供了灵活的测试配置。通过可视化界面，开发者可以实时查看服务器响应、调试协议交互，并验证 MCP 服务器的各项功能是否按预期工作。该工具在 GitHub 上获得了 9230 颗星的认可，证明了其在 MCP 生态系统中的重要地位和广泛应用。
Deep Analysis
Key Differentiator
The official MCP developer tool from the protocol creators — only dedicated inspector for testing MCP servers across all transport types
⚡ Capabilities
- • MCP server testing and debugging
- • React-based interactive web UI
- • Multi-transport support (stdio, SSE, streamable-http)
- • Server configuration export (mcp.json)
- • Bearer token authentication for SSE
- • DNS rebinding protection
- • Session-based proxy authentication
🔗 Integrations
Model Context ProtocolCursorClaude CodeNode.jsDocker
✓ Best For
- ✓ MCP server developers needing testing/debugging UI
- ✓ Teams building MCP integrations for AI agents
- ✓ Developers debugging transport issues (stdio/SSE/HTTP)
✗ Not Ideal For
- ✗ Production MCP server monitoring
- ✗ Non-MCP protocol testing
Languages
TypeScript
Deployment
npx (zero install)Dockernpm install
Pricing Detail
Free: Fully open-source
Paid: N/A
⚠ Known Limitations
- ⚠ Requires Node.js >= 22.7.5
- ⚠ Not a production tool — developer debugging only
- ⚠ Proxy server should not be exposed to untrusted networks
- ⚠ Limited to MCP protocol testing
Pros
- + 提供直观的可视化界面，无需复杂的命令行操作即可测试 MCP 服务器
- + 支持多种传输协议（stdio、SSE、streamable-http），兼容性强
- + 零配置快速启动，通过 npx 命令即可直接运行，开发体验极佳
Cons
- - 需要 Node.js 22.7.5+ 环境，对运行环境有特定要求
- - 主要面向 MCP 服务器开发者，普通用户使用场景有限
- - 作为调试工具，不适合生产环境部署使用
Use Cases
- • MCP 服务器开发过程中的功能验证和调试测试
- • 集成 MCP 服务器到应用前的接口兼容性检查
- • MCP 协议实现的教学演示和原型验证
Getting Started
1. 确保安装 Node.js 22.7.5+，然后运行 'npx @modelcontextprotocol/inspector' 启动 UI 模式；2. 浏览器访问 [link] 打开检查器界面；3. 使用 'npx @modelcontextprotocol/inspector node your-server.js' 连接并测试特定的 MCP 服务器