用途:通过 Composio 的 CircleCI 工具包,经 Rube MCP 自动化 CircleCI 的 CI/CD 操作,包括触发流水线、监控工作流与作业、获取构建产物和测试元数据。
前置条件:需连接 Rube MCP(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立并激活 toolkit 为 circleci 的连接;每次先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。设置方式:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥。
主要能力与用法:
- 触发流水线:CIRCLECI_TRIGGER_PIPELINE,参数含 project_slug(格式 gh/org/repo 或 bb/org/repo)、branch 或 tag(二者互斥)、parameters;可用 CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID 监控。
- 监控流水线与工作流:CIRCLECI_LIST_PIPELINES_FOR_PROJECT、CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID,可选 CIRCLECI_GET_PIPELINE_CONFIG。
- 查看作业详情:CIRCLECI_GET_JOB_DETAILS,job_number 为整数。
- 获取构建产物:CIRCLECI_GET_JOB_ARTIFACTS,产物仅在作业完成后可用。
- 查看测试结果:CIRCLECI_GET_TEST_METADATA,需作业已上传 JUnit XML 格式测试结果。
层级关系为流水线→工作流→作业;分页使用 next_page_token 作为 page_token 继续请求。
限制:流水线和工作流 ID 为 UUID,作业号为整数,不可混用;project_slug 必须含 VCS 前缀且大小写敏感,格式错误会返回 404;branch 与 tag 互斥;流水线参数须与 .circleci/config.yml 中定义一致;CircleCI API 有速率限制,遇 429 应指数退避,避免快速轮询(建议 5-10 秒间隔);产物 URL 可能需要认证头,大文件可能有下载限制;无测试结果时响应为空。输出不应替代环境特定验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。