Routebase

routebase-mcp

让你的 AI Agent 在 Routebase 中操作 API。 这是 Routebase 的连接器。Routebase 是一个 API 生命周期平台，文档、模拟服务器、契约测试和监控均基于同一份 OpenAPI 规范生成。Agent 使用同一份规范，因此可以在与人工团队相同的基于角色的权限下设计端点和架构、运行契约与安全测试套件、管理模拟服务、发布文档以及查看监控信息。账单和组织访问权限仍为只读。

有两种连接方式。如果你的客户端只支持 stdio，请使用 stdio 方式；否则建议选择托管端点。

托管端点（推荐）

https://mcp.routebase.dev

使用 Streamable HTTP，并支持 OAuth 2.1 和动态客户端注册——使用 Routebase 账户登录即可，无需安装任何内容，也无需轮换密钥。偏好使用静态凭据的客户端可以改为发送 X-API-Key 标头。

美国区域账户使用 https://mcp.routebase.dev/?region=us。如果设置错误，连接器会显示为没有工具，而不是报错。

stdio 桥接程序

适用于只启动本地进程的客户端：

ROUTEBASE_API_KEY=rb_… npx routebase-mcp

在 Routebase 的 Settings → API Keys 下生成 API 密钥。交互式设置会为你写入正确的配置：

npx routebase-mcp init

也可以手动添加。Claude Code（.mcp.json）和 Cursor（.cursor/mcp.json）使用相同的配置块：

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": ["-y", "routebase-mcp", "--stdio"],
      "env": {
        "ROUTEBASE_API_KEY": "rb_…"
      }
    }
  }
}

Codex 使用 ~/.codex/config.toml，CLI 和 IDE 扩展共用此文件：

[mcp_servers.routebase]
command = "npx"
args = ["-y", "routebase-mcp@latest", "--stdio"]

[mcp_servers.routebase.env]
ROUTEBASE_API_KEY = "rb_…"

VS Code 无需桥接程序，因为它本身支持 Streamable HTTP。它的 .vscode/mcp.json 使用顶层键 servers 而不是 mcpServers，要求每个条目都包含 type，并且只会展开 ${input:…}，因此密钥不会写入已提交的文件。完整配置块请参阅 MCP 快速入门。

环境变量	必需	说明
ROUTEBASE_API_KEY	✅	用于身份验证的 API 密钥。在 Settings → API Keys 下创建。
ROUTEBASE_REGION	美国账户	账户所在区域：us 或 eu（默认值：eu）。如果不设置，美国密钥会被视为无效密钥。
ROUTEBASE_LOG_LEVEL	–	verbose · debug · info · warning · error · fatal（默认值：warning）。日志输出到 stderr——stdout 保留给 MCP 协议使用。

stdio 桥接程序的工作原理

npm 包是一个小型启动器。首次运行时，它会从 releases.routebase.dev 下载适用于你平台的独立 CLI 二进制文件，并根据发布时写入包中的 SHA-256 校验和进行验证（如果不匹配则拒绝运行，即采用故障关闭策略），然后将其缓存在 ~/.routebase/bin/<version>/ 下。

支持的平台： macOS（arm64、x64）、Windows（x64）、Linux（x64）。需要 Node.js ≥ 18。

此仓库包含的内容

文件	用途
bin/routebase-mcp.js	以 routebase-mcp npm 包形式发布的 stdio 启动器
server.json	MCP 注册表（dev.routebase/routebase）的清单
plugin.json、mcp.json	Agent Plugins 1.0 清单
package.json、checksums.json	已发布的包元数据，以及此版本固定使用的二进制文件的 SHA-256 校验和

此仓库镜像了已发布的连接器，且其中的每个文件均由 Routebase 自有仓库中的发布流水线生成。每次发布都会将 npm 包的确切内容推送到此处并创建标签，因此在此处所做的更改不会同步到 npm——请提交 issue，而不是发起拉取请求。

链接

• 产品：https://routebase.dev/mcp-server/
• 适用于所有客户端的 MCP 快速入门：https://docs.routebase.dev/mcp-quickstart/
• API 密钥和作用域：https://docs.routebase.dev/mcp-authentication/
• CLI 参考：https://docs.routebase.dev/mcp-cli-reference/
• npm：https://www.npmjs.com/package/routebase-mcp

许可证

此代码库中的 shim 采用 MIT 许可证。下载的 Routebase CLI 二进制文件受 Routebase 条款 约束。