# Cloudbase MCP Inspector

MCP inspector 是一个用于测试和调试 MCP server 的开发工具。

![MCP Inspector 截图](mcp-inspector.png)

## 快速开始

```
npx @cloudbase/mcp-inspector
```

## 运行 Inspector

### 从 MCP server 仓库

要检查 MCP server 的实现，无需克隆此仓库。相反，使用 `npx`。例如，如果你的 server 构建在 `build/index.js`：

```bash
npx @cloudbase/mcp-inspector node build/index.js
```

你可以向你的 MCP server 传递参数和环境变量。参数直接传递给 server，而环境变量可以使用 `-e` 标志设置：

```bash
# 仅传递参数
npx @cloudbase/mcp-inspector build/index.js arg1 arg2

# 仅传递环境变量
npx @cloudbase/mcp-inspector -e KEY=value -e KEY2=$VALUE2 node build/index.js

# 同时传递环境变量和参数
npx @cloudbase/mcp-inspector -e KEY=value -e KEY2=$VALUE2 node build/index.js arg1 arg2

# 使用 -- 分隔 inspector 标志和 server 参数
npx @cloudbase/mcp-inspector -e KEY=$VALUE -- node build/index.js -e server-flag
```

inspector 同时运行一个客户端 UI（默认端口 5173）和一个 MCP 代理 server（默认端口 3333）。在浏览器中打开客户端 UI 以使用 inspector。如果需要，可以自定义端口：

```bash
CLIENT_PORT=8080 SERVER_PORT=9000 npx @cloudbase/mcp-inspector node build/index.js
```

有关使用 inspector 的更多详细信息，请参阅 [MCP 文档站点的 Inspector 部分](https://modelcontextprotocol.io/docs/tools/inspector)。有关调试帮助，请参阅 [调试指南](https://modelcontextprotocol.io/docs/tools/debugging)。

### 认证

inspector 支持 SSE/POST 连接的 bearer token 认证。在连接到 MCP server 时在 UI 中输入你的 token，它将被发送到 Authorization 头中。

### 从此仓库

如果你正在开发 inspector 本身：

开发模式：

```bash
npm run dev
```

> **Windows 用户注意：**  
> 在 Windows 上，请改用以下命令：
>
> ```bash
> npm run dev:windows
> ```

生产模式：

```bash
npm run build
npm start
```

## 许可证

本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件。