gitlab-automation

用途

GitLab Automation 通过 Rube MCP（Composio）将 GitLab 的常用操作接入 AI 客户端，实现项目、议题、合并请求、CI/CD 流水线、分支与用户管理的自动化。它本身不是独立应用，而是一套基于 MCP 工具调用的工作流集合。

主要能力

• 议题管理：列出、筛选、创建、更新项目议题，支持标签、指派人、里程碑、状态切换与搜索。
• 合并请求管理：列出与筛选合并请求，支持按状态、分支、作者、指派人、评审人、标签、草稿状态等过滤。
• 项目与仓库管理：列出、搜索、创建项目，查看项目详情、语言构成、分支与提交历史，创建分支。
• CI/CD 流水线监控：列出流水线、查看单个流水线详情、列出流水线中的作业，支持按状态、分支、提交 SHA、时间范围过滤。
• 用户与成员管理：搜索用户、查看用户详情与状态、列出项目成员与项目用户。

使用方式

1. 前置条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；GitLab 连接需通过 RUBE_MANAGE_CONNECTIONS 以 toolkit gitlab 激活。
2. 安装配置：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器，无需 API 密钥。
3. 验证：确认 RUBE_SEARCH_TOOLS 有响应；调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit gitlab；若连接非 ACTIVE，按返回的授权链接完成 GitLab OAuth；确认状态为 ACTIVE 后再执行工作流。
4. 调用原则：始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema，再按工作流调用具体工具。

典型工作流

• 议题：GITLAB_GET_PROJECTS 找项目 ID → GITLAB_LIST_PROJECT_ISSUES 列出/筛选 → GITLAB_CREATE_PROJECT_ISSUE 创建 → GITLAB_UPDATE_PROJECT_ISSUE 更新；可用 GITLAB_LIST_PROJECT_USERS 查用户 ID 用于指派。
• 合并请求：GITLAB_GET_PROJECT 验证访问 → GITLAB_GET_PROJECT_MERGE_REQUESTS 列出/筛选；可选 GITLAB_GET_REPOSITORY_BRANCHES 验证分支、GITLAB_LIST_ALL_PROJECT_MEMBERS 找评审人。
• 项目与仓库：GITLAB_GET_PROJECTS 列出 → GITLAB_GET_PROJECT 详情 → GITLAB_CREATE_PROJECT 创建 → GITLAB_GET_REPOSITORY_BRANCHES 列分支 → GITLAB_CREATE_REPOSITORY_BRANCH 建分支；可选查看提交历史与语言构成。
• 流水线：GITLAB_GET_PROJECT 验证 → GITLAB_LIST_PROJECT_PIPELINES 列出 → GITLAB_GET_SINGLE_PIPELINE 详情 → GITLAB_LIST_PIPELINE_JOBS 作业列表。
• 用户与成员：GITLAB_GET_USERS 搜索 → GITLAB_GET_USER 详情 → GITLAB_GET_USERS_ID_STATUS 状态 → GITLAB_LIST_ALL_PROJECT_MEMBERS 成员列表；可选 GITLAB_LIST_PROJECT_USERS。

适用场景

适合需要在 AI 客户端中批量或按条件查询 GitLab 项目信息、跟踪议题与合并请求、监控 CI/CD 流水线状态、管理分支与成员的用户。

限制与注意事项

• 项目标识支持整数 ID 或 URL 编码路径（如 my-group%2Fmy-project）；路径中的斜杠需编码，优先使用数字 ID。
• issue_iid 是项目内编号（如 #42），不同于全局 issue ID。
• labels 字段会替换全部现有标签，增量修改应使用 add_labels/remove_labels。
• assignee_ids 设为空数组不会取消指派，需使用 [0]。
• 合并请求默认 scope 为 created_by_me，需完整列表时用 all；author_id 与 author_username、reviewer_id 与 reviewer_username 互斥。
• 分页为偏移式，需设置 page 与 per_page（1-100，默认 20），应翻页至结束以保证完整。
• GitLab 存在按用户速率限制（通常每分钟 300-2000 次，视套餐而定）。
• 部分功能需 Premium/Ultimate（如 epic_id、weight、iteration_id、approved_by_ids、成员 state 过滤）；部分用户管理过滤为管理员专属；mr_approved_filter 特性标志默认关闭。
• 日期参数使用 ISO 8601 格式，如 "2024-01-15T10:30:00Z"。
• 资料未提供具体收费、价格与效果数据。