Cloudbase MCP Inspector

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

快速开始

npx @cloudbase/mcp-inspector

运行 Inspector

从 MCP server 仓库

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

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

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

# 仅传递参数
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。如果需要，可以自定义端口：

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

有关使用 inspector 的更多详细信息，请参阅 MCP 文档站点的 Inspector 部分。有关调试帮助，请参阅 调试指南。

认证

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

从此仓库

如果你正在开发 inspector 本身：

开发模式：

npm run dev

Windows 用户注意：
在 Windows 上，请改用以下命令：

npm run dev:windows

生产模式：

npm run build
npm start

许可证

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