Gitlab MCP Server

GitLab MCP Server

为你的 AI 助手提供完整的 GitLab。 通过 GitLab 的 REST 和 GraphQL API，支持多达 1,103 项操作，涵盖从 Free 到 Ultimate 的所有版本以及 GitLab.com。它是一个独立的二进制文件，可与 Claude、Cursor、VS Code、Codex 和任何其他 MCP 客户端配合使用。你只需用自然语言提出需求，它就会为你处理 GitLab 工作。

默认启动上下文为 11,396 个 token，在所有 GitLab 套餐中都相同（设置 GITLAB_MCP_CAPABILITY_SURFACE=minimal 时为 1,994 个 token）。 通过两个工具即可访问整个目录；若将每个工具单独列出，则需要 577,678 到 737,573 个 token。使用 cl100k_base tokenizer 测量，并在 CI 中验证。测量方法

“检查合并请求 !15：可以安全合并吗？”·“上一次流水线为什么失败？”·“列出分配给我的未解决议题”·“根据 v1.0 到 v2.0 生成发行说明”

为什么选择此服务

• 涵盖所有层级和所有实例。 Free/CE、Premium 和 Ultimate，无论是自托管，还是带有 Orbit 知识图谱的 GitLab.com。系统会检测层级，并据此提供工具目录。
• 使用你已有的令牌。 具有 api 权限的个人、项目或群组访问令牌；对于 GitLab 接受其执行的操作，也可使用 read_api 权限；细粒度令牌则根据其授权逐项判断；HTTP 模式下还可使用 OAuth。每项操作的工具参考条目都会说明所需的权限范围和细粒度权限。
• 安全防护。 只读模式、安全模式（预览每项写入操作，而非直接写入）、按名称排除工具，以及在执行任何破坏性操作前进行确认。
• 三种界面，两种传输方式。 默认提供两个发现工具，可按领域或按操作提供工具；桌面客户端使用 stdio，共享部署使用 HTTP，并将每个凭据相互隔离。此外还提供 45 个资源和 37 个提示词。
• 可验证的发布版本。 每个二进制文件都有签名校验和，每个制品都有 SBOM 和构建来源证明。

安装

这些按钮会注册 Docker 镜像，因此需要 Docker；Claude Desktop 行则会下载原生扩展。创建具有 api 权限范围的个人访问令牌（对于 GitLab 接受其执行的操作，也可使用 read_api；如果不允许写入任何内容，请添加 GITLAB_MCP_READ_ONLY=true）。

客户端	一键按钮	令牌步骤
VS Code		提示你输入（内容会被遮蔽）
Cursor		编辑 YOUR_GITLAB_TOKEN
LM Studio		编辑 YOUR_GITLAB_TOKEN
Kiro		编辑 YOUR_GITLAB_TOKEN
Claude Desktop		设置界面

Claude Code。 注册命令不会携带令牌：-e GITLAB_TOKEN 会从 Claude Code 传给 docker 的环境中转发令牌。

export GITLAB_TOKEN=glpat-xxxx
claude mcp add gitlab --transport stdio \
  -- docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest

任何其他客户端都可将以下任一命令作为服务的命令运行，并在传入的环境中设置 GITLAB_TOKEN：

npx -y @jmrp.io/gitlab-mcp-server                   # npm, nothing installed first
uvx jmrplens-gitlab-mcp-server                      # PyPI, nothing installed first
dnx gitlab-mcp-server                               # NuGet (.NET 10 SDK), nothing installed first
brew install jmrplens/tap/gitlab-mcp-server         # Homebrew, macOS and Linux
winget install --id jmrplens.gitlab-mcp-server -e   # winget, Windows
docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest

对于自行管理的实例，请在令牌旁设置 GITLAB_URL=https://gitlab.example.com；使用 Docker 镜像时，还需在 docker 参数中添加 -e GITLAB_URL 来传递该变量，因为容器只会接收此处指定的变量（Docker 安装说明）。所有通道、各客户端的配置和验证步骤都在安装指南中，负责为你安装的助手也可以在 llms.txt 中找到相同内容。

想先试用的话，有一个公共实例运行在 https://mcp.jmrp.io/gitlab；在 浏览器检查器 中通过 OAuth 登录后，它会以只读方式调用该实例。你的令牌和每个请求都会经过这台机器，因此若要继续使用，请自行运行该服务；托管端点页面说明了它的用途和限制。

文档

其他所有内容都在 docs.jmrp.io/gitlab-mcp-server，提供英文和西班牙文版本： 入门指南、配置、工具概览、HTTP 服务模式、安全、隐私和故障排查。

贡献、安全与许可证

欢迎在 GitHub 上贡献；CONTRIBUTING.md介绍了工作流，并适用 CODE_OF_CONDUCT.md 中的行为准则。如需报告漏洞，请按照 SECURITY.md 中的说明私下提交。此服务采用 MIT 许可证（LICENSE）。

---

由 José M. Requena Plens 维护 · 项目页面 · 托管实例：mcp.jmrp.io/gitlab