cubic

cubic MCP 服务

cubic 是一款用于 GitHub 拉取请求的 AI 代码审查工具。它托管的 MCP 服务可让你的 AI Agent 连接到 cubic 审查发现、代码库文档、代码库扫描结果和团队经验。

你可以做什么

• 阅读拉取请求中尚未处理的审查发现，包括文件位置、严重程度和审查状态。
• 启动对拉取请求的云端审查。
• 解决、重新打开或驳回发现，并在 GitHub 审查讨论串中记录处理结果。
• 阅读代码库 Wiki 和单个 Wiki 页面。
• 浏览代码库扫描结果、查看问题并更新其分类状态。
• 阅读团队针对某个代码库总结的审查经验。
• 查看组织订阅和成员。组织管理员还可以管理席位、角色和支持的账单设置。

MCP 使用你的 cubic 账户权限。你需要拥有相关代码库或组织的访问权限；连接服务不会授予额外权限。可用工具取决于你的权限和订阅。

连接

设置	值
服务名称	cubic
URL	https://www.cubic.dev/api/mcp
传输方式	Streamable HTTP
身份验证	OAuth（推荐）或个人 API 密钥

请完全按照所示使用 URL，包括 www。该服务由 cubic 托管，因此无需在本地安装服务。

GitHub Copilot in VS Code

1. 打开命令面板并运行 MCP: Add Server。
2. 选择 HTTP，然后输入 https://www.cubic.dev/api/mcp。
3. 将服务命名为 cubic，并选择用户或工作区配置。
4. 运行 MCP: List Servers，启动 cubic，然后完成浏览器 OAuth 登录。
5. 使用启用了 cubic 工具的 Copilot Agent 模式。

你也可以将此便携配置添加到项目中的 .mcp.json。如果文件已存在，请将 cubic 条目添加到其 mcpServers 对象中：

{
  "mcpServers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json（适用于所有项目）或 .cursor/mcp.json（适用于单个项目），然后在 MCP 设置中连接 cubic 并完成 OAuth：

{
  "mcpServers": {
    "cubic": {
      "url": "https://www.cubic.dev/api/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http --scope user cubic https://www.cubic.dev/api/mcp

打开 Claude Code，运行 /mcp，选择 cubic，然后完成浏览器 OAuth 流程。

Codex CLI

codex mcp add cubic --url https://www.cubic.dev/api/mcp
codex mcp login cubic
codex mcp list

脚本、CI 和不支持 OAuth 的客户端

在 Settings > Integrations > MCP 中生成个人 API 密钥。将其作为 bearer token 放入 Authorization 标头，并跳过客户端的 OAuth 登录步骤。

对于 VS Code 扩展宿主会话，请在 .vscode/mcp.json 中使用输入项，以免将密钥写入工作区配置。对于 Agent Host 会话，请使用 OAuth，或使用基于环境变量保存机密的便携配置；VS Code 不会转发需要交互式输入的服务。

{
  "inputs": [
    {
      "id": "cubic-api-key",
      "type": "promptString",
      "description": "cubic personal API key",
      "password": true
    }
  ],
  "servers": {
    "cubic": {
      "type": "http",
      "url": "https://www.cubic.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cubic-api-key}"
      }
    }
  }
}

对于脚本和 CI，请从机密存储中读取密钥。密钥属于个人，并沿用创建者的权限。你可以在同一设置页面撤销或重新生成密钥。

使用方法

连接后，尝试以下提示词，并将仓库和 PR 替换为你有权访问的仓库和 PR：

• "使用 cubic 列出 https://github.com/OWNER/REPO/pull/NUMBER 上未解决的审查问题。"
• "开始审查 acme/backend 中的 PR #42。"
• "列出 acme/backend 的 Wiki 页面，并向我展示身份验证系统页面。"
• "显示 acme/backend 中严重程度至少为 7 的代码库扫描问题。"
• "哪些审查经验适用于 acme/backend？"

get_pr_issues 会读取问题发现结果和审查状态；它不会启动审查。只有在审查已完成且不存在更新的提交时，空的问题发现列表才表示当前提交没有未解决的问题。使用 trigger_pr_review 启动云端审查。

将 get_pr_issues 返回的 PR 问题 ID 与 update_pr_issue_status 一起使用；此操作会更新 GitHub 审查线程，并将署名回复加入队列。将 get_scan 返回的代码库扫描问题 ID 与 get_issue 或 update_issue_status 一起使用。

进行本地代码审查时，请使用 cubic CLI。cubic skills 会为你的 Agent 添加调查和修复问题发现结果的工作流。

文档与支持

• 完整的 MCP 文档、可用工具和故障排除
• VS Code MCP 设置与配置
• cubic 网站
• 官方 MCP Registry 条目
• 联系 cubic 支持团队

此仓库包含 cubic 托管式 MCP 服务的公开文档和注册表元数据。注册表名称为 dev.cubic/cubic，其元数据位于 server.json。