@mcp-use/inspector

技能简介

@mcp-use/inspector 是 mcp-use 团队开源的 MCP 服务器调试工具，为开发者提供可视化的界面来测试和调试 MCP 服务器。它支持 MCP-UI 和 OpenAI Apps SDK 的小组件功能，可以在浏览器中实时测试工具、探索资源、管理提示和管理服务器连接。

该工具完全开源，支持 Streamable HTTP 服务器连接，提供美观的响应式界面，是 MCP 开发者和生态贡献者必备的调试利器。

核心能力

• 多连接管理：同时连接和管理多个 MCP 服务器
• 交互式测试：实时执行工具并查看结果
• 实时状态监控：监控连接状态、错误和服务器健康状况
• OAuth 支持：内置 OAuth 流程处理和弹出式身份验证
• 持久会话：连接保存到 localStorage 并自动重连
• 工具浏览器：浏览和执行所有可用工具，带 Schema 验证
• 资源浏览器：查看和复制资源 URI，带语法高亮
• Skills 浏览器：通过 MCP 文件浏览、验证和预览 Skills
• 提示管理器：使用参数模板测试和管理提示
• Widget 支持：完整支持 MCP-UI 和 OpenAI Apps SDK 的 Widget
• Docker 支持：可通过单个 Docker 容器自托管

安装配置

在线使用（推荐）

访问 https://inspector.mcp-use.com/inspector 无需安装，直接使用。

本地运行

npx @mcp-use/inspector

启动后在浏览器打开 http://localhost:8080

Docker 部署

docker run -p 8080:8080 mcpuse/inspector

MCP 配置

在支持 MCP 的工具中添加：

{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": ["@mcp-use/inspector"]
    }
  }
}

使用步骤

1. 启动 Inspector：通过在线地址或 npx 启动
2. 连接服务器：在界面中添加要调试的 MCP 服务器地址
3. 浏览工具：在 Tools 面板查看可用工具列表
4. 执行测试：选择工具，输入参数，点击执行查看结果
5. 查看资源：在 Resources 面板浏览服务器暴露的资源
6. 测试提示：在 Prompts 面板测试提示模板
7. 保存调用：将常用的工具调用保存以便重复测试

适用场景

• MCP 服务器开发：开发过程中调试和验证服务器实现
• MCP 工具测试：测试第三方 MCP 服务器的工具是否正常工作
• MCP 协议学习：通过可视化界面理解 MCP 协议的工作方式
• 服务器健康检查：定期检查 MCP 服务器的连接状态
• 自动化工作流验证：验证 MCP 服务器在复杂调用下的行为
• 多服务器对比：同时连接多个 MCP 服务器对比功能差异

适用人群

• MCP 服务器开发者
• 需要测试和调试 MCP 集成的工程师
• 学习 Model Context Protocol 的开发者
• AI 工具集成工程师
• DevRel 和生态贡献者

工作原理

@mcp-use/inspector 是一个 MCP 客户端应用，它连接到目标 MCP 服务器（通过 Streamable HTTP），然后将服务器的响应以可视化方式呈现给用户。用户可以通过界面发起 MCP 请求（工具调用、资源浏览、提示执行等），Inspector 将结果格式化展示。同时它也充当 MCP 服务器，允许其他 MCP 客户端连接到它进行测试。

官方链接

• NPM 页面：https://www.npmjs.com/package/@mcp-use/inspector
• 在线使用：https://inspector.mcp-use.com/inspector
• GitHub 仓库：https://github.com/mcp-use/mcp-use
• 官方文档：https://mcp-use.com/docs/inspector
• Discord 社区：https://discord.gg/XkNkSkMz3V