AgentHubAgentHub
GitLab icon

GitLab MCP配置与使用教程

MCP ServerMCP Hub 中国

io.mcp-cn.zereight/mcp-gitlab

GitLab的MCP服务器，支持GitLab的读取和写入

在 MCP Hub 中国 查看 ↗

建议先在本页复制安装配置，再到上游核对文档与权限。

热度数据

使用量11.8k

产品介绍

GitLab的MCP服务器，支持GitLab的读取和写入 GitLab 是一个MCP Server，收录自 MCP Hub 中国。支持 stdio 传输。本页提供产品介绍、配置教程、安装命令与适用场景，支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。

GitLab版本控制代码管理MCP

适用场景

代码审查与 GitHub国内服务接入

AgentHub Verified 可用性验证技术测试通过

自动化测试流水线已校验安装命令、传输协议与客户端兼容性

最近校验时间2026-10-06
安装配置格式测试有效CLI 与 mcpServers JSON 语法校验通过
协议连接与握手响应正常支持标准 JSON-RPC 2.0 规格规范
上游数据源存活来源 mcp-cn，可正常下载依赖
测试可用客户端Claude Code、Claude Desktop、Cursor 等
安全等级： A 级 · 源码开放合规 (A)·该工具经 AgentHub 静态安全特征扫描，无高危越权行为。建议在项目级配置文件中指定工作区范围。

按平台快速复制

选择你的平台查看安装方式

  1. 打开项目根目录下的 .cursor/mcp.json（没有就新建）
  2. 点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
  3. 将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
  4. 保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行

预填环境变量与密钥（可选）

必填secret
必填
必填
必填
必填
必填
隐私安全承诺：所有参数与密钥仅在您本机的浏览器前端进行实时文本替换，AgentHub 绝不向任何服务器上传或存储您的敏感凭据。
点击「复制配置」直接粘贴到客户端
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

配置教程

  1. 打开 GitLab 详情页，确认这是你需要的 MCP Server（来源 MCP Hub 中国）。
  2. 按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code，复制 JSON 配置或 CLI 命令。
  3. 将配置合并进 mcpServers，并把环境变量占位符替换为真实密钥。
  4. 重载窗口后，在 Agent 对话中调用该 MCP 提供的工具。

安装命令

以下安装命令与配置步骤已写入页面 HTML，搜索引擎与未启用 JavaScript 的浏览器均可直接读取。

Claude Code（本地）

  1. 确保已安装 Claude Code CLI
  2. 复制下方命令，将 <占位符> 替换为真实环境变量值后，在终端执行
  3. 若下方列出了环境变量，请对照填写
claude mcp add mcp-gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN=<GITLAB_PERSONAL_ACCESS_TOKEN> --env GITLAB_API_URL=<GITLAB_API_URL> --env GITLAB_READ_ONLY_MODE=<GITLAB_READ_ONLY_MODE> --env USE_GITLAB_WIKI=<USE_GITLAB_WIKI> --env USE_MILESTONE=<USE_MILESTONE> --env USE_PIPELINE=<USE_PIPELINE> -- npx -y @zereight/mcp-gitlab

Cursor — .cursor/mcp.json（本地）

  1. 打开项目根目录下的 .cursor/mcp.json（没有就新建）
  2. 点击「复制配置」粘贴进去；若已有其他 MCP，只合并 mcpServers 里的本条目
  3. 将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
  4. 保存后按 Cmd+Shift+P（Windows：Ctrl+Shift+P）→ 输入 Reload Window 并执行
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

VS Code — .vscode/mcp.json（本地）

  1. 确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
  2. 打开项目根目录下的 .vscode/mcp.json（没有就新建）
  3. 点击「复制配置」粘贴；若已有其他 MCP，只合并 mcpServers 里的本条目
  4. 将 env 中的 <占位符> 替换为真实密钥（见下方「环境变量」）
  5. 保存后重新加载 VS Code 窗口
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

Claude Desktop — claude_desktop_config.json（本地）

  1. 打开 Claude Desktop 的 claude_desktop_config.json（路径见远程指引）
  2. 点击「复制配置」合并到 mcpServers
  3. 将 env 中的 <占位符> 替换为真实密钥
  4. 完全退出并重启 Claude Desktop
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

Trae — .trae/mcp.json（本地）

  1. 打开 Trae → 设置 → MCP，或编辑 .trae/mcp.json / 全局 mcp.json
  2. 点击「复制配置」粘贴并合并 mcpServers
  3. 将 env 中的 <占位符> 替换为真实密钥
  4. 保存后重载 Trae 窗口
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

Cherry Studio — MCP 设置（本地）

  1. 打开 Cherry Studio → 设置 → MCP 服务器 → 添加（STDIO）
  2. 也可直接导入下方 JSON：点击「复制配置」合并到 mcpServers
  3. 将 env 中的 <占位符> 替换为真实密钥，并确保本机已安装 Node.js / uv（npx、uvx）
  4. 启用服务并查看工具列表是否加载成功
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

通义灵码 — MCP 配置（本地）

  1. 通义灵码：个人设置 → MCP 服务 → 「+」→ 手工添加（STDIO）或配置文件添加
  2. 点击「复制配置」合并 mcpServers；命令/参数/环境变量与 JSON 一致
  3. 将 env 中的 <占位符> 替换为真实密钥；本机需 Node.js 18+（npx）或已安装 uv（uvx）
  4. 确认服务状态为已连接后再在智能体对话中调用
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

Windsurf — mcp_config.json（本地）

  1. 编辑 ~/.codeium/windsurf/mcp_config.json
  2. 点击「复制配置」合并 mcpServers（本地 stdio 与 Cursor 格式相同）
  3. 将 env 中的 <占位符> 替换为真实密钥后保存并刷新 Cascade
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

Cline — MCP Servers（本地）

  1. Cline 面板 → 设置 → MCP Servers
  2. 点击「复制配置」粘贴并合并
  3. 将 env 中的 <占位符> 替换为真实密钥后保存
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

WorkBuddy — .workbuddy/mcp.json（本地）

  1. 编辑 ~/.workbuddy/mcp.json（用户级）或项目目录 .workbuddy/mcp.json
  2. 也可在界面：插件 → MCP 服务器 → 配置 MCP，粘贴下方 JSON
  3. 将 env 中的 <占位符> 替换为真实密钥；Windows 下 command/脚本路径建议用绝对路径
  4. 保存并重启 WorkBuddy，确认连接器状态为绿色
{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "<GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<GITLAB_READ_ONLY_MODE>",
        "USE_GITLAB_WIKI": "<USE_GITLAB_WIKI>",
        "USE_MILESTONE": "<USE_MILESTONE>",
        "USE_PIPELINE": "<USE_PIPELINE>"
      }
    }
  }
}

常见报错排查与运行避坑 (Troubleshooting)FAQ

针对 GitLab 在 Cursor、Claude Code 中的常见连接错误与解决办法

在 Cursor / Claude Code 中配置 GitLab 提示 connection closed 或 exit code 1？

通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤： 1. 确认已安装 Node.js 18+（支持 npx）或 Python 3.10+（支持 uvx）； 2. 尝试在终端运行 which npx 或 which uvx，把配置文件中的 "command" 字段改为完整绝对路径； 3. 修改 mcp.json 后，必须完全重载或重启客户端窗口。

Fix Snippet
# 终端测试命令是否存在：
which npx
node -v
提示 spawn npx ENOENT 或 command not found？

这是因为编辑器后台进程未加载完整的终端环境变量（PATH）。解决方案：在全局安装该包（如 npm install -g 包名），或在配置文件中将 command 设置为系统的实际路径（如 Windows 下的 C:\Program Files\nodejs\npx.cmd，Mac 下的 /usr/local/bin/npx）。

提示 Missing required environment variable 或 API 认证失败？

GitLab 依赖环境变量（如 GITLAB_PERSONAL_ACCESS_TOKEN、GITLAB_API_URL、GITLAB_READ_ONLY_MODE、USE_GITLAB_WIKI、USE_MILESTONE、USE_PIPELINE）。请在客户端配置文件的 "env" 对象中填入有效密钥，注意不要包含多余空格或未闭合的双引号。

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "GITLAB_PERSONAL_ACCESS_TOKEN": "your_actual_key_here"
  }
}
仍连不上？查看 MCP 连接失败排查指南 →

免安装模拟调用 (Playground)

仿真环境

GitLab 核心接口调用仿真 · 无需配置本地环境，直接预览调用参数与返回格式

沙盒就绪 (Virtual Mock)
fn: mcp_gitlabGitLab的MCP服务器，支持GitLab的读取和写入
请求入参 (Arguments)JSON Schema
{
  "target": "GitLab",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Agent 在规划任务时会自动生成并传递上述入参
Agent Tool Output

点击上方「模拟运行」按钮

查看该工具在 Agent 内部的返回数据格式

测试环境：AgentHub Virtual SandboxJSON-RPC 2.0

选型与决策建议（为什么选它？）

帮助你快速判断该资源是否契合当前项目，避免盲目折腾

适合什么任务？
  • PR 自动审查
  • 生成 changelog
  • 跨仓库 Issue 检索
什么时候不建议用？
  • 替代人工安全审计
  • 在无授权仓库上操作
推荐工作流搭配：查看完整场景 →

GitLab + 对应场景 Prompt → 组成标准 Agent 自动化任务

MCP 实战教程：从安装到看见效果

按完整实例走一遍（含期望效果与对比验收）。装完本页资源后，用教程里的提示词核对是否真正生效。

打开教程 →

相关资源

常搭配使用

继续逛 AgentHub

大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。

浏览更多同类搜索相似资源按场景选型场景提示词MCP 实战教程评测与对比

收录徽章：把 AgentHub 挂到你的官网

复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链，无需上传文件，链接指向本页，访客可由此直接找到安装方式。

预览AgentHub 已收录：GitLab
HTML
<a href="https://myagenthub.cn/p/io.mcp-cn.zereight/mcp-gitlab" title="AgentHub 已收录：GitLab" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.mcp-cn.zereight/mcp-gitlab" alt="AgentHub 已收录：GitLab" height="20" style="border:0"/>
</a>
Markdown（GitHub README）
[![AgentHub 已收录：GitLab](https://myagenthub.cn/badge/io.mcp-cn.zereight/mcp-gitlab)](https://myagenthub.cn/p/io.mcp-cn.zereight/mcp-gitlab)

徽章由 /badge/<资源ID> 动态生成，名称与收录状态变化后自动更新；请保留链接指向，它是收录来源的判定依据。

统一 Manifest

{
  "id": "io.mcp-cn.zereight/mcp-gitlab",
  "type": "mcp-server",
  "version": "latest",
  "displayName": "GitLab",
  "description": "GitLab的MCP服务器，支持GitLab的读取和写入",
  "author": {
    "name": "zereight"
  },
  "iconUrl": "https://static-00.iconduck.com/assets.00/gitlab-icon-1024x942-f30d1qro.png",
  "homepage": "https://mcp-cn.com/server/91",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@zereight/mcp-gitlab",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "GITLAB_PERSONAL_ACCESS_TOKEN",
            "description": "<YOUR_GITLAB_TOKEN>",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "GITLAB_API_URL",
            "description": "<YOUR_GITLAB_API_URL>",
            "isRequired": true,
            "isSecret": false
          },
          {
            "name": "GITLAB_READ_ONLY_MODE",
            "description": "false",
            "isRequired": true,
            "isSecret": false
          },
          {
            "name": "USE_GITLAB_WIKI",
            "description": "false",
            "isRequired": true,
            "isSecret": false
          },
          {
            "name": "USE_MILESTONE",
            "description": "false",
            "isRequired": true,
            "isSecret": false
          },
          {
            "name": "USE_PIPELINE",
            "description": "false",
            "isRequired": true,
            "isSecret": false
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [
    "use_count:11790",
    "GitLab",
    "版本控制",
    "代码管理",
    "MCP"
  ],
  "provenance": {
    "origin": "mcp-cn",
    "originalId": "@zereight/mcp-gitlab",
    "originalUrl": "https://mcp-cn.com/server/91",
    "isOfficial": false,
    "status": "active"
  }
}