MCP Use (d6fd0c)

⚠️ 这是一个只读镜像 libraries/typescript/packages/inspector 在 mcp使用/mcp使用 monorepo。 🚀 请将问题和拉取请求提交给monorepo。 🛠 此分支反映： canary 🌐 源文件夹： libraries/typescript/packages/inspector

MCP Inspector

🔍 MCP检查员由MCP使用 是一个开源的交互式开发工具，用于测试和调试MCP服务器，支持MCP-UI和OpenAI Apps SDK小部件。它为测试工具、探索资源、管理提示和监控服务器连接提供了一个美观直观的界面，所有这些都可以通过浏览器完成。

🚀 试试看：

• 在线的: inspector.mcp-use.com
• 本地：运行 npx @mcp-use/inspector
• 仓库:

🎥 演示


📖 文档

有关详细的使用说明和指南，请访问 mcp-use.com/docs/inspector

______________________________________________________________________

📦 相关套餐

______________________________________________________________________

✨ 主要特点

______________________________________________________________________

🚀 快速开始

访问检查员

有三种方法可以使用MCP检查器：

1.在线版本（建议测试）

访问 inspector.mcp-use.com -无需安装！

2.本地运行

npx @mcp-use/inspector

在浏览器中打开检查器 http://localhost:8080

3.自动安装mcp使用服务器

当您使用以下命令创建MCP服务器时 mcp-use，检查员可自动访问 /inspector:

import { MCPServer } from "mcp-use/server";

const server = new MCPServer({
  name: "my-server",
  version: "1.0.0",
});

// Add your tools, resources, prompts...

server.listen(3000);
// 🎉 Inspector automatically available at http://localhost:3000/inspector

______________________________________________________________________

📖 使用指南

仪表盘

主仪表板是管理MCP服务器连接的中心枢纽：

• 已连接服务器面板 （左）：查看您连接的所有服务器
• 连接面板 （右）：添加具有传输、URL、身份验证和标头配置的新服务器连接
• 快捷操作：从顶部栏访问设置和清除会话

添加MCP服务器

要连接到MCP服务器，请执行以下操作：

1. 打开连接面板：单击仪表板右侧的“连接”面板
2. 配置传输:

- 为SSE连接选择“流式HTTP” - 为WS连接选择“WebSocket” - 为本地进程连接配置“stdin/stdio”

1. 输入服务器URL：输入MCP服务器端点（例如。， https://mcp.linear.app/mcp)
2. 配置身份验证 （如果需要）：添加OAuth凭据或API头
3. 点击连接：建立连接

示例网址：

• 线性的： https://mcp.linear.app/mcp
• 当地： http://localhost:3000/mcp

OAuth身份验证

对于需要OAuth的服务器（如Linear）：

1. 点击后 连接，您将看到授权页面
2. 点击 “批准” 授予访问权限
3. 检查器自动处理重定向
4. 服务器出现在“已连接的服务器”列表中，并显示绿色指示器

隐私声明：所有身份验证令牌和凭据都安全地存储在浏览器的本地存储中。不会向我们的服务器发送任何内容，所有内容都会保留在您的设备上。

已连接的服务器

连接后，每台服务器显示：

• 连接状态指示灯（绿色=已连接）
• 服务器名称和URL
• 可用工具计数
• 操作按钮： 检查, 断开, 移除

点击 “检查” 打开详细的服务器视图。

______________________________________________________________________

🔍 服务器详细信息视图

点击后 “检查” 在连接的服务器上，您将看到四个主要选项卡：

工具选项卡

“工具”选项卡显示MCP服务器中的所有可用工具。

特征：

• 浏览所有可用工具及其名称和描述
• 选择一个工具以查看其详细架构
• 点击 “执行” 测试工具
• 在输入面板中输入JSON参数
• 通过语法高亮显示查看实时结果
• 支持MCP-UI和OpenAI Apps SDK小部件

示例：当连接到Linear MCP服务器时，您将看到23多种用于管理问题、项目和团队的工具。

资源选项卡

从MCP服务器浏览可用资源：

• 查看资源描述和元数据
• 复制资源URI以在应用程序中使用
• 检查MIME类型和资源属性
• 预览资源内容

备注：某些服务器（如Linear）可能不会公开资源，在这种情况下，您将看到“没有可用资源”。

提示选项卡

测试和管理预配置的提示：

• 查看所有带有描述的可用提示
• 选择一个提示以查看其架构
• 在表格中填写必填参数
• 点击 “渲染” 执行提示
• 复制渲染输出以供使用

备注：并非所有服务器都提供提示。如果没有可用提示，您将看到“没有可用提示”。

激励选项卡

Elicitation选项卡处理在执行过程中需要用户输入的工具请求。

特征：

• 在专用队列中查看待处理的启发请求
• 直接在检查器中填写并提交表单模式响应
• 接受、拒绝或取消请求
• 响应后跳转回工具结果

支持的字段类型：

• 文本、数字/整数和布尔字段
• 单选枚举下拉菜单：

- type: "string" + enum - type: "string" + oneOf[{ const, title }] - type: "string" + enum + enumNames （遗产）

• 多选枚举组：

- type: "array" + items.enum - type: "array" + items.anyOf[{ const, title }]

这与MCP一致性场景使用的SEP-1330枚举模式变体相一致。

聊天选项卡

聊天选项卡提供了一个交互式界面，使用LLM测试MCP服务器 BYOK（自带钥匙）.

隐私：您的API密钥存储在浏览器本地，从不发送到我们的服务器。所有请求都是直接从您的设备向LLM提供商提出的。

设置：

1. 点击 “配置API密钥” 打开配置模式
2. 选择您的 提供者 （OpenAI、Anthropic等）
3. 选择 模型 （gpt-4o、claude-3-5-连接器等）
4. 输入你的 API密钥 （存储在浏览器本地）
5. 点击 “保存配置”

使用聊天：

• 键入自然语言查询以测试MCP服务器
• 使用可视化指示器实时查看工具调用
• 有关参数和结果，请参阅详细的JSON输出
• 根据工具结果观察助手的反应
• 准确跟踪MCP服务器如何处理请求

______________________________________________________________________

⌨️ 键盘快捷键

快速搜索（Cmd/Ctrl+K） 允许您：

• 快速连接到新服务器
• 访问文档和教程
• 跳转到最近使用的服务器
• 直接搜索和执行工具
• 导航到不同的选项卡

______________________________________________________________________

💾 持久性

检查器会自动保存您的配置：

• 服务器连接 在页面重新加载过程中保持不变
• 凭证 安全地存储在浏览器的本地存储中
• 会话首选项 自动维护
• 随时使用清除所有会话 “全部清除” 按钮

您的数据永远不会离开您的浏览器-为了隐私和安全，所有内容都存储在本地。

______________________________________________________________________

🐳 自我寄宿

使用单个Docker容器将MCP Inspector部署到您自己的基础设施中。非常适合企业环境、气隙网络或需要完全控制调试环境的情况。

Docker镜像

官方Docker镜像可在 .

快速入门：

docker run -d -p 8080:8080 --name mcp-inspector mcpuse/inspector:latest

然后访问 http://localhost:8080 访问您的自托管检查器。

Docker部署选项

使用Docker运行：

docker run -d \
  --name mcp-inspector \
  -p 8080:8080 \
  -e NODE_ENV=production \
  mcpuse/inspector:latest

使用Docker Compose：

version: "3.8"
services:
  mcp-inspector:
    image: mcpuse/inspector:latest
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
      - PORT=8080
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080"]
      interval: 30s
      timeout: 10s
      retries: 3

环境变量

所有配置都是可选的。检查员开箱即用，有合理的默认值。

______________________________________________________________________

📊 遥测和隐私

MCP检查器收集匿名使用数据，以帮助我们改进工具。

收集了哪些数据？

我们收集：

• 使用事件：当您连接到服务器、执行工具、读取资源或调用提示时
• 匿名用户ID：随机生成的UUID存储在浏览器的localStorage中
• 技术信息：包版本、浏览器类型和连接类型
• 性能数据：工具执行持续时间和成功/失败率

我们 不要 收集：

• 个人信息（姓名、电子邮件等）
• 实际工具参数或结果
• 服务器凭据或API密钥
• 资源内容或数据

如何选择退出

您可以通过多种方式禁用遥测：

选项1：环境变量

# Set before starting the inspector
export MCP_USE_ANONYMIZED_TELEMETRY=false

选项2：本地存储（浏览器）

// In browser console
localStorage.setItem("mcp_inspector_telemetry_disabled", "true");

选项3：包装级别

// Add to your package.json
{
  "scarfSettings": {
    "enabled": false
  }
}

遥测提供商

我们使用：

• 后霍格：用于产品分析和功能使用跟踪
• 围巾：用于软件包下载分析和公司见解

两家提供商都尊重您的隐私并遵守GDPR合规性。

🤝 贡献

我们欢迎捐款！

查看我们的 贡献指南 了解详情。

______________________________________________________________________

📚 了解更多

• 检查员文件 -完整的使用指南和教程
• 自助托管指南 -部署您自己的实例
• mcp使用文档 -完整的框架文档
• 模型上下文协议 -MCP官方规范
• -源代码和示例

______________________________________________________________________

📜 许可证

MIT© mcp使用