使用说明

项目简介

MCP Inspector Proxy 服务器是 MCP Inspector 工具的核心组件，它作为一个代理服务器，帮助开发者调试和测试 MCP 服务器的实现。它接收来自 MCP Inspector 客户端的请求，并将这些请求转发到实际的 MCP 服务器。同时，它也接收 MCP 服务器的响应，并将响应返回给客户端。通过这个代理服务器，开发者可以方便地监控和分析 MCP 客户端与服务器之间的通信过程，从而更好地理解和调试 MCP 服务器。

主要功能点

MCP 请求代理: 拦截并转发 MCP 客户端和 MCP 服务器之间的 JSON-RPC 请求和响应。
通信监控: 记录和展示 MCP 客户端与服务器之间完整的 JSON-RPC 通信历史，方便开发者查看和分析。
多传输协议支持: 支持通过 Stdio 或 SSE 等多种传输协议连接到实际的 MCP 服务器。
灵活配置: 允许配置连接到 MCP 服务器的各种参数，例如启动命令、命令行参数、环境变量和 SSE URL。

安装步骤

本仓库提供的 MCP Inspector Proxy 服务器通常 无需单独安装。它作为 MCP Inspector 工具的一部分，可以通过 'npx' 命令直接运行。

如果你需要从源代码构建和运行：

克隆仓库: 'git clone https://github.com/modelcontextprotocol/inspector'
进入 server 目录: 'cd inspector/server'
安装依赖: 'npm install'
构建项目: 'npm run build'

服务器配置

MCP Inspector Proxy 服务器本身 无需用户直接配置。配置的重点在于 MCP 客户端 (MCP Inspector UI) 如何通过 Proxy 服务器连接到你的实际 MCP 服务器。

在 MCP Inspector UI 中，你需要配置连接信息，以指定 Proxy 服务器如何启动或连接到你的 MCP 服务器。以下是一个配置示例，你需要根据你的 MCP 服务器情况进行调整：

{
  "serverName": "你的 MCP 服务器名称",
  "transportType": "stdio", // 传输类型，可选 "stdio" 或 "sse"

  // 当 transportType 为 "stdio" 时，需要配置以下参数：
  "command": "node", // MCP 服务器的启动命令，例如 "node" 或 "python"
  "args": "path/to/your/mcp-server.js arg1 arg2", // MCP 服务器的启动参数，包括服务器脚本路径和任何需要的命令行参数

  // 当 transportType 为 "sse" 时，需要配置以下参数：
  // "sseUrl": "http://your-mcp-server-address:port/sse" //  MCP 服务器的 SSE (Server-Sent Events) 端点 URL
}

配置说明:

'serverName': 为你的 MCP 服务器指定一个易于识别的名称。
'transportType': 选择 MCP Inspector Proxy 服务器连接到你的 MCP 服务器的方式。
- 'stdio': 通过标准输入/输出流 (Stdio) 启动并连接到 MCP 服务器。适用于本地开发和调试，Proxy 服务器会作为子进程启动你的 MCP 服务器。
- 'sse': 通过 Server-Sent Events (SSE) 连接到一个已经运行的 MCP 服务器。适用于连接到远程或已独立运行的 MCP 服务器。
'command' (当 'transportType' 为 'stdio' 时): 指定用于启动你的 MCP 服务器的可执行命令。例如，如果你的 MCP 服务器是 Node.js 应用，则设置为 '"node"'。
'args' (当 'transportType' 为 'stdio' 时): 指定传递给 'command' 的命令行参数，包括你的 MCP 服务器脚本的路径以及任何其他必要的参数。多个参数请用空格分隔。
'sseUrl' (当 'transportType' 为 'sse' 时): 指定你的 MCP 服务器提供的 SSE 端点 URL。 MCP Inspector Proxy 服务器将通过此 URL 与你的 MCP 服务器建立 SSE 连接。

重要提示: 你配置的是 MCP Inspector 客户端 如何通过 Proxy 连接到你的 实际 MCP 服务器。 Proxy 服务器本身无需额外配置，它会根据 MCP Inspector 客户端的指示工作。

基本使用方法

启动 MCP Inspector: 在命令行中运行 'npx @modelcontextprotocol/inspector <你的MCP服务器启动命令和参数>' (例如: 'npx @modelcontextprotocol/inspector node build/index.js')。如果你的 MCP 服务器已经运行，可以省略后面的服务器启动命令和参数。
打开 Inspector UI: 在浏览器中访问 MCP Inspector UI 界面 (通常地址为 'http://127.0.0.1:6274')。
配置 MCP 服务器连接: 在 Inspector UI 中，根据你的 MCP 服务器情况，选择 'stdio' 或 'sse' 传输方式，并填写相应的配置信息（启动命令、参数或 SSE URL）。
开始调试和测试: 使用 Inspector UI 与你的 MCP 服务器进行交互。你可以在 UI 界面中发送 MCP 请求，查看服务器响应，并监控完整的通信过程。 Proxy 服务器会将所有通信记录在 UI 界面上，方便你进行分析和调试。

关键词