用途:通过 GitLab REST API 管理 GitLab 项目、合并请求、流水线和议题,适合在自动化脚本或智能体流程中调用 GitLab 完成日常仓库操作。
主要能力:列出项目(含成员项目、按最近活动排序)、获取项目详情;列出与创建合并请求;列出流水线、触发流水线、获取流水线作业;列出与创建议题;获取作业日志。
使用方式:需设置环境变量 GITLAB_URL(GitLab 实例地址,如 https://gitlab.com 或自建实例)与 GITLAB_TOKEN(个人访问令牌或项目令牌)。请求通过 curl 发送,携带请求头 PRIVATE-TOKEN: $GITLAB_TOKEN,调用 $GITLAB_URL/api/v4/... 接口,并可用 jq 提取字段。例如列出项目:curl -s -H "PRIVATE-TOKEN: $GITLAB_TOKEN" "$GITLAB_URL/api/v4/projects?membership=true&per_page=20&order_by=last_activity_at" | jq '.[] | {id, name: .path_with_namespace, default_branch}';创建合并请求使用 POST /projects/123/merge_requests 并传入 source_branch、target_branch、title、description。
限制与注意:项目 ID 可用数字或 URL 编码路径(如 mygroup%2Fmyproject);分页使用 per_page 与 page 参数;gitlab.com 上已认证请求速率限制为每分钟 300 次;创建合并请求、触发流水线或修改议题前应先确认。