---

name: circleci-automation description: "通过 Rube MCP (Composio) 自动化 CircleCI 任务：触发流水线、监控工作流/作业、获取构建产物和测试元数据。操作前务必先搜索工具以获取最新 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 CircleCI 自动化

通过 Rube MCP 使用 Composio 的 CircleCI 工具包自动化 CI/CD 操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 CircleCI 连接，工具包为 circleci
• 操作前务必先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置步骤

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用
2. 使用工具包 circleci 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 CircleCI 授权
4. 确认连接状态为 ACTIVE 后再执行任何工作流

核心工作流

1. 触发流水线

使用场景：用户需要启动新的 CI/CD 流水线运行

工具调用顺序：

1. CIRCLECI_TRIGGER_PIPELINE - 在项目上触发新流水线 [必需]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - 监控生成的工作流 [可选]

关键参数：

• project_slug：项目标识符，格式为 gh/org/repo 或 bb/org/repo
• branch：运行流水线的 Git 分支
• tag：运行流水线的 Git 标签（与 branch 互斥）
• parameters：流水线参数键值对

注意事项：

• project_slug 格式为 {vcs}/{org}/{repo}（例如 gh/myorg/myrepo）
• branch 和 tag 互斥，同时提供会报错
• 流水线参数必须与 .circleci/config.yml 中定义的一致
• 触发操作返回流水线 ID；工作流异步启动

2. 监控流水线和工作流

使用场景：用户需要检查流水线或工作流的状态

工具调用顺序：

1. CIRCLECI_LIST_PIPELINES_FOR_PROJECT - 列出项目的近期流水线 [必需]
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - 列出流水线内的工作流 [必需]
3. CIRCLECI_GET_PIPELINE_CONFIG - 查看使用的流水线配置 [可选]

关键参数：

• project_slug：项目标识符，格式为 {vcs}/{org}/{repo}
• pipeline_id：特定流水线的 UUID
• branch：按分支名筛选流水线
• page_token：分页游标，用于获取下一页结果

注意事项：

• 流水线 ID 是 UUID，不是数字 ID
• 工作流继承流水线 ID；一个流水线可包含多个工作流
• 工作流状态包括：success、running、not_run、failed、error、failing、on_hold、canceled、unauthorized
• 响应中返回 page_token 用于分页；持续请求直到无 token 返回

3. 查看作业详情

使用场景：用户需要深入了解特定作业的执行详情

工具调用顺序：

1. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID - 找到包含该作业的工作流 [前置]
2. CIRCLECI_GET_JOB_DETAILS - 获取详细作业信息 [必需]

关键参数：

• project_slug：项目标识符
• job_number：数字作业编号（非 UUID）

注意事项：

• 作业编号是整数，不是 UUID（与流水线和工作流 ID 不同）
• 作业详情包括执行器类型、并行度、开始/结束时间和状态
• 作业状态：success、running、not_run、failed、retried、timedout、infrastructure_fail、canceled

4. 获取构建产物

使用场景：用户需要下载或列出作业生成的构建产物

工具调用顺序：

1. CIRCLECI_GET_JOB_DETAILS - 确认作业已成功完成 [前置]
2. CIRCLECI_GET_JOB_ARTIFACTS - 列出作业的所有构建产物 [必需]

关键参数：

• project_slug：项目标识符
• job_number：数字作业编号

注意事项：

• 构建产物仅在作业完成后可用
• 每个产物包含 path 和 url 用于下载
• 产物 URL 下载时可能需要认证头
• 大型产物可能有下载大小限制

5. 查看测试结果

使用场景：用户需要检查特定作业的测试结果

工具调用顺序：

1. CIRCLECI_GET_JOB_DETAILS - 验证作业已运行测试 [前置]
2. CIRCLECI_GET_TEST_METADATA - 获取测试结果和元数据 [必需]

关键参数：

• project_slug：项目标识符
• job_number：数字作业编号

注意事项：

• 测试元数据要求作业已上传测试结果（JUnit XML 格式）
• 如果未上传测试结果，响应将为空
• 测试元数据包含 classname、name、result、message 和 run_time 字段
• 失败的测试在 message 字段中包含失败信息

常用模式

项目 Slug 格式

格式: {vcs_type}/{org_name}/{repo_name}
- GitHub:    gh/myorg/myrepo
- Bitbucket: bb/myorg/myrepo

典型调试流程

1. CIRCLECI_LIST_PIPELINES_FOR_PROJECT → 获取 pipeline_id
2. CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID → 获取 workflow_id，找到失败的工作流
3. CIRCLECI_GET_JOB_DETAILS → 查看失败作业的详情
4. CIRCLECI_GET_TEST_METADATA → 检查具体哪些测试失败
5. CIRCLECI_GET_JOB_ARTIFACTS → 获取日志或产物进行分析