用途:借助 Rube MCP(Composio)自动化 GitLab 操作,覆盖项目管理、议题跟踪、合并请求流程、CI/CD 流水线监控、分支管理与用户管理。
前置条件:Rube MCP 需已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 使用 gitlab 工具包建立有效连接;运行任何工作流前应始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。
配置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥。确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS(工具包 gitlab);若连接非 ACTIVE,按返回的授权链接完成 GitLab OAuth,确认状态为 ACTIVE 后再执行。
主要能力与用法:
- 议题管理:用 GITLAB_GET_PROJECTS 找项目,GITLAB_LIST_PROJECT_ISSUES 列出/筛选,GITLAB_CREATE_PROJECT_ISSUE 创建,GITLAB_UPDATE_PROJECT_ISSUE 更新。id 可为整数项目 ID 或 URL 编码路径;issue_iid 是项目内编号(如 #42),与全局 ID 不同;labels 会替换全部标签,增量修改用 add_labels/remove_labels;assignee_ids 用 [0] 取消全部指派,空数组无效。
- 合并请求:GITLAB_GET_PROJECT 验证访问,GITLAB_GET_PROJECT_MERGE_REQUESTS 列出/筛选。默认 scope 为 created_by_me,如需完整列表用 all;author_id 与 author_username、reviewer_id 与 reviewer_username 互斥;approved 过滤依赖默认关闭的 mr_approved_filter 特性开关。
- 项目与仓库:GITLAB_GET_PROJECTS、GITLAB_GET_PROJECT、GITLAB_LIST_USER_PROJECTS、GITLAB_CREATE_PROJECT(name 与 path 均必填)、分支相关工具及提交历史、语言构成。项目列表需完整分页,否则会遗漏。
- CI/CD:GITLAB_LIST_PROJECT_PIPELINES、GITLAB_GET_SINGLE_PIPELINE、GITLAB_LIST_PIPELINE_JOBS,可按 status、ref、sha、日期筛选。
- 用户与成员:GITLAB_GET_USERS、GITLAB_GET_USER、GITLAB_GET_USERS_ID_STATUS、GITLAB_LIST_ALL_PROJECT_MEMBERS、GITLAB_LIST_PROJECT_USERS。
限制:GitLab 有按用户速率限制(约 300–2000 请求/分钟,随套餐而异);分页基于 offset,需用 page 与 per_page(1–100,默认 20)翻至完成;路径中的斜杠需 URL 编码,优先用数字 ID;部分功能(epic_id、weight、iteration_id、approved_by_ids、成员 state 过滤)需 Premium/Ultimate;部分筛选仅管理员可用;日期用 ISO 8601 格式。