用途:通过 Rube MCP(Composio 的 CircleCI 工具包)自动化 CircleCI 的 CI/CD 操作,包括触发流水线、监控流水线与工作流、检查作业详情、获取构建产物与测试元数据。
前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 circleci 的有效连接;运行任何工作流前始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。设置:将 https://rube.app/mcp 添加为客户端配置中的 MCP 服务器,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit circleci,若未激活则按返回的授权链接完成认证,确认状态为 ACTIVE 后再运行。
主要能力与工具:触发流水线用 CIRCLECI_TRIGGER_PIPELINE(参数 project_slug、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;获取产物用 CIRCLECI_GET_JOB_ARTIFACTS;查看测试用 CIRCLECI_GET_TEST_METADATA。层级为流水线到工作流到作业。
注意事项:project_slug 格式为 {vcs}/{org}/{repo}(如 gh/myorg/myrepo 或 bb/myorg/myrepo),区分大小写;branch 与 tag 互斥;流水线与工作流 ID 为 UUID,作业号为整数;分页用 next_page_token 作为 page_token,直到不存在;产物需作业完成后获取;测试元数据需上传 JUnit XML 结果,否则为空;注意 API 速率限制,遇 429 应指数退避,避免频繁轮询(建议 5-10 秒间隔)。分类依据资料暂无官方分类说明。