Skip to main content
Glama
gggab

GitLab Deployment MCP

by gggab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

GitLab Deployment MCP

一个供 Codex、Cursor、Claude Code 和 Kimi Code 使用的 GitLab 部署 MCP 服务。它通过 Streamable HTTP 提供项目、Pipeline 和 Job 查询；项目范围选择是只读操作，部署在核对 SHA 后只保留一次写操作批准。

默认认证是 GitLab OAuth：用户在自己的客户端中打开浏览器，登录 GitLab 并授权。也可以选择与 OAuth 互斥的 Personal Access Token 模式。

接入已部署服务

运维部署 OAuth 服务后，按所用平台选择一条命令。所有入口都使用用户自己的 GitLab OAuth；不需要个人 Token。

平台

Windows 入口

macOS 入口

Codex

托管 join.ps1

托管 join.sh

Cursor

托管 join-cursor.ps1

托管 join-cursor.sh

Claude Code

原生 claude mcp add

原生 claude mcp add

Kimi Code

托管 join-kimi.ps1

托管 join-kimi.sh

Codex

Windows：

irm https://<真实服务地址>/join.ps1 | iex

macOS：

curl -fsSL https://<真实服务地址>/join.sh | bash

Cursor

Windows：

irm https://<真实服务地址>/join-cursor.ps1 | iex

macOS：

curl -fsSL https://<真实服务地址>/join-cursor.sh | bash

Claude Code

Windows：

claude mcp add --transport http --scope user gitlab_deployment https://<真实服务地址>/mcp/gitlab-deployment

macOS：

claude mcp add --transport http --scope user gitlab_deployment https://<真实服务地址>/mcp/gitlab-deployment

Kimi Code

Windows：

irm https://<真实服务地址>/join-kimi.ps1 | iex

Windows 脚本会配置独立安装的 Kimi Code，并在检测到 Kimi Desktop 时同步配置其内置 Kimi Code CLI。

macOS：

curl -fsSL https://<真实服务地址>/join-kimi.sh | bash

Codex 接入后运行 codex mcp login gitlab_deployment；Cursor 接入后运行 cursor-agent mcp login gitlab_deployment；Claude Code 接入后启动 claude 并输入 /mcp；Kimi Code 接入后启动 kimi 并输入 /mcp-config login gitlab_deployment。四者都会打开浏览器完成 GitLab 授权。Codex 脚本写入 MCP URL、工具白名单和写操作审批配置；Cursor 与 Kimi Code 脚本只写入 MCP URL；Claude Code 使用自身 CLI 写入用户级配置。示例域名 mcp.internal.company.com 不是可用服务地址。

Related MCP server: GitLab MCP Server

自行部署服务

服务端部署请按认证方式选择一份手册：

首次使用

完成接入后，可以在新 Codex 对话中依次提出：

  1. 列出 <GitLab 组路径> 组中的项目

  2. 本次对话只允许操作 <完整项目路径>

  3. 查看这个项目最近的 pipelines

  4. 查看 pipeline <ID> 中的 jobs

部署前，Codex 必须展示项目、Job、分支、Pipeline ID 和 SHA。play_deploy_job 是唯一需要批准的写操作；客户端展示该工具调用时批准一次即可，不再要求额外的固定口令。

开发验证

yarn install --frozen-lockfile
yarn test

测试使用假 GitLab 完整覆盖 OAuth 授权码、PKCE、刷新令牌和 MCP Bearer 转发，不访问真实 GitLab，也不触发部署。

目录

install.ps1             Windows 自行部署安装脚本
join.ps1                Windows OAuth 接入脚本
join-cursor.ps1         Cursor Windows OAuth 接入脚本
join-cursor.sh          Cursor macOS OAuth 接入脚本
join-kimi.ps1           Kimi Code Windows OAuth 接入脚本
join-kimi.sh            Kimi Code macOS OAuth 接入脚本
join.sh                 macOS OAuth 接入脚本
src/server.mjs          MCP HTTP 服务
src/oauth.mjs           GitLab OAuth broker
tests/                  安装、接入、HTTP 与 OAuth 测试
docs/                   运维与使用文档

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GitLab MCP Server

    anupsahu
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with GitLab repositories through secure OAuth 2.0 authentication. Supports comprehensive GitLab operations including merge requests, issues, file management, commits, and branch operations through natural language.
    7 npm
    MIT

  • GitLab MCP Server

    maxkulish
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables project management and repository operations on GitLab through the GitLab API, including file operations, branch management, issue creation, merge requests, and repository forking with support for both GitLab.com and self-hosted instances.
    2,942 npm
    Apache 2.0