Repolode
zereight

zereight/gitlab-mcp

让 AI 助手通过结构化工具操作 GitLab 项目、合并请求、议题、流水线和 Wiki 的 MCP 服务器。

Star
2,089
Fork
368
未关闭 Issue
11
最近提交
昨天

这是什么?

gitlab-mcp 是一个 Model Context Protocol 服务器,用于把 Claude、Cursor、VS Code、Copilot 等 AI 客户端连接到 GitLab 实例。它基于 GitLab REST 和 GraphQL API,提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki、发布、标签和里程碑等操作。默认只加载约 40 个核心工具,其余工具集可在会话中按需激活,以控制模型可见的工具列表长度。

本地客户端可通过 stdio 连接,团队共享或托管部署则可使用 Streamable HTTP 或 SSE。认证方式包括个人访问令牌、本地 OAuth2 浏览器授权、面向远程客户端的 MCP OAuth 代理,以及支持多用户的逐请求令牌转发。只读、修改、完全等权限模式,以及工具白名单和黑名单、群组与项目限制,可以约束智能体的操作范围。

在合并请求审查方面,可先列出变更文件,再分批获取差异内容。JMESPath 过滤和结果压缩可以缩减过大的返回内容。同一个程序还提供命令行接口,用于在终端中获取完整的差异和任务日志,并同时支持 GitLab.com 与自建实例。

核心功能

  • 01提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki 和发布
  • 02默认加载精简工具集,其余工具按需激活
  • 03支持 stdio、SSE 和 Streamable HTTP 传输方式
  • 04支持个人访问令牌、OAuth2 以及逐请求的远程授权
  • 05提供只读、修改等权限模式,并可按工具和项目过滤
  • 06合并请求审查分两步进行,先列出变更文件,再分批获取差异

适用场景

  • 让 AI 编程助手读取合并请求的变更文件和差异并给出审查意见
  • 让智能体查看流水线任务日志或在 GitLab 中触发 CI 相关操作
  • 在团队内共享一个托管的 GitLab MCP 端点,每位用户使用各自的令牌
  • 搭建只读的 GitLab 集成,用于报表统计或议题分拣

快速上手

  1. 1

    从 npm 安装可执行文件

    npm install -g @zereight/mcp-gitlab
  2. 2

    设置 GitLab 个人访问令牌(不回显输入)

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    在 Claude Code 中注册该服务器

    claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab

使用前须知

  • 默认工具集仅提供约 40 个工具,其他工具需通过 discover_tools 激活。
  • api 工具集存在风险,因为它会绕过白名单和安全检查。

收录于专题

标签

常见问题

gitlab-mcp 是什么?
让 AI 助手通过结构化工具操作 GitLab 项目、合并请求、议题、流水线和 Wiki 的 MCP 服务器。 gitlab-mcp 是一个 Model Context Protocol 服务器,用于把 Claude、Cursor、VS Code、Copilot 等 AI 客户端连接到 GitLab 实例。它基于 GitLab REST 和 GraphQL API,提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki、发布、标签和里程碑等操作。默认只加载约 40 个核心工具,其余工具集可在会话中按需激活,以控制模型可见的工具列表长度。
gitlab-mcp 可以免费使用吗?用的什么许可证?
gitlab-mcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
gitlab-mcp 还在维护吗?
活跃维护中。gitlab-mcp 最近一次提交是在 2026年11月6日。
gitlab-mcp 适合用来做什么?
让 AI 编程助手读取合并请求的变更文件和差异并给出审查意见 让智能体查看流水线任务日志或在 GitLab 中触发 CI 相关操作 在团队内共享一个托管的 GitLab MCP 端点,每位用户使用各自的令牌 搭建只读的 GitLab 集成,用于报表统计或议题分拣
gitlab-mcp 怎么安装和运行?
从 npm 安装可执行文件: npm install -g @zereight/mcp-gitlab 设置 GitLab 个人访问令牌(不回显输入): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN 在 Claude Code 中注册该服务器: claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
在哪里获取 gitlab-mcp?
源代码和安装说明在 GitHub 上:https://github.com/zereight/gitlab-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目