GitLab MCP Server

GitLab 官方内置 MCP 端点，另有社区版可自托管

核心功能

GitLab 的 MCP 接入有两条路径：官方在实例内置了 MCP server（Beta），端点是 /api/v4/mcp，用 OAuth 动态注册授权，需先开启 Duo 与 Beta 特性；社区实现 zereight/gitlab-mcp 用 PAT 认证，工具覆盖更广但要自行部署。

功能亮点

官方零安装

实例自带 /api/v4/mcp，客户端填 URL 即可，无需部署额外进程

OAuth 授权

首次连接自动完成动态客户端注册，共享应用需勾选 mcp scope

CI 排障工具

get_job_log 可直接拉取 CI 失败作业的日志输出

社区版工具多

社区版覆盖 wiki、里程碑、CI 变量等两百余个工具

适用场景

• 让助手总结 MR 改动并写评审
• 根据失败作业日志定位 CI 问题
• 批量查询与创建 issue
• 检索项目代码与 wiki 文档
• 查询已保存视图中的工作项

安装配置

bash

# 方式一：GitLab 内置 MCP server（HTTP，官方推荐）
{
  "mcpServers": {
    "GitLab": {
      "type": "http",
      "url": "https://gitlab.com/api/v4/mcp"
    }
  }
}

# 自管实例把域名换成自己的；可选加工具名前缀
# "headers": { "X-Gitlab-Mcp-Server-Tool-Name-Prefix": "gitlab_" }

# 只支持 stdio 的客户端（Claude Desktop / Zed，需 Node.js 20+）
{
  "mcpServers": {
    "GitLab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gitlab.com/api/v4/mcp"]
    }
  }
}

# 方式二：社区实现 zereight/gitlab-mcp（PAT 认证）
npm install -g @zereight/mcp-gitlab
{
  "mcpServers": {
    "gitlab": {
      "command": "zereight-mcp-gitlab",
      "args": ["--token=YOUR_GITLAB_TOKEN", "--api-url=https://gitlab.com/api/v4"],
      "tools": ["*"]
    }
  }
}

# 社区版容器（只读 + 指定工具集）
docker run -i --rm -e HOST=0.0.0.0 -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token -e GITLAB_API_URL="https://gitlab.com/api/v4" -e GITLAB_PERMISSION_MODE=readonly -e GITLAB_TOOLSETS=wiki,milestones,pipelines -e SSE=true -p 3333:3002 zereight050/gitlab-mcp

使用方法

bash

# 官方内置 server 的真实工具名
Issue / Work Item：create_issue、get_issue、create_workitem_note、get_workitem_notes、link_work_items、get_saved_view_work_items
Merge Request：create_merge_request、get_merge_request、list_merge_requests、get_merge_request_diffs、get_merge_request_commits、get_merge_request_notes、create_merge_request_note、get_merge_request_pipelines
CI/CD：manage_pipeline、get_pipeline_jobs、get_job_log
检索：search、search_labels、list_wiki_pages、semantic_code_search（需 GitLab Duo 附加项）
元信息：get_mcp_server_version

# 示例
"用 get_merge_request_diffs 取出 !42 的改动，逐个文件点评，再用 create_merge_request_note 提交评审"
"用 get_pipeline_jobs 找到失败的 job，再 get_job_log 拉日志，定位构建报错"

# 社区版（zereight/gitlab-mcp）额外提供
list_pipelines、get_pipeline_job_output、create_wiki_page、list_milestones、search_project_code、execute_graphql、discover_tools

关键指标

尚未核验对标产品，此处只列本工具自身指标，不做对比结论。

指标GitLab MCP Server

价格免费增值

开源是

上手难度进阶

优点

官方版由实例内置，GitLab.com、自管实例与 Dedicated 都可直接连，无需部署进程
采用 OAuth 动态客户端注册（RFC 7591），令牌由 GitLab 侧签发，配置文件里不用硬写 PAT
官方工具覆盖 MR diff、评论、流水线与作业日志，评审加 CI 排障可在同一会话闭环
可用 X-Gitlab-Mcp-Server-Tool-Name-Prefix 加前缀，多 MCP 并存时不会与其他服务器重名
社区版 zereight/gitlab-mcp 工具超过两百个，支持 GITLAB_TOOLSETS 与 readonly 权限模式

缺点

官方 MCP server 仍标注 Beta，工具数量有限，且需管理员先打开 Duo 与 Beta/实验特性开关
semantic_code_search 依赖 GitLab Duo 付费附加项，Free 层拿不到该工具
官方文档只给出 OAuth 路径，未提供 PAT 直连方式，脚本化接入不如社区版方便
社区版为第三方维护，需自行部署容器并管理 SSE/OAuth、限流等一堆环境变量
两套实现工具命名不一致（如官方 search 对应社区 search_project_code），切换时提示词要改写