gitlab-mcp

为AI助手提供全面的GitLab项目管理能力

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:gitlab-mcp。
它的用途是:为AI助手提供全面的GitLab项目管理能力
完整的 Skill 内容见:https://321skill.com/skills/gitlab-mcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我在项目‘backend-api’中,基于‘feature/auth’分支创建一个合并请求到‘main’,标题是‘用户认证模块’,并@同事张三进行评审。” 它会通过GitLab MCP Server调用GitLab API,自动完成分支比对、创建合并请求、设置标题和评审者的全套操作。

介绍

GitLab MCP Server 是一个为AI客户端(如Claude、Cursor、Copilot等)设计的中间层服务,它解决了AI助手无法直接、安全地操作GitLab平台的问题。通过标准化的MCP协议,它将GitLab的API(包括项目管理、合并请求、议题、流水线、Wiki、发布等)暴露给AI,让AI能像人类开发者一样在代码库中执行任务。

使用方式非常灵活,支持本地安装(通过npm或Homebrew)并配置到你的AI客户端中。核心在于认证配置,提供了四种方式:个人访问令牌(最简单)、本地OAuth2浏览器流程(更安全)、MCP OAuth代理(用于远程客户端如Claude.ai)以及远程授权(用于多用户部署)。用户可以根据自己的使用场景(本地开发还是远程服务)选择合适的认证路径。

它非常适合需要频繁与GitLab交互的开发者、技术负责人或DevOps工程师。无论是想通过自然语言让AI帮忙创建合并请求、审查代码、查看构建状态,还是管理项目维基和发布,这个工具都能大幅提升工作流效率,将重复的GitLab操作自动化。

建议初次使用者从个人访问令牌开始,这是最直接的本地设置。如果追求更好的安全性,或需要在团队或远程环境中使用,则应仔细阅读对应的OAuth或远程授权指南。注意,它需要用户拥有对目标GitLab实例(无论是gitlab.com还是自托管实例)的相应访问权限。

核心特点

支持GitLab功能的覆盖面极广,不仅限于基础的仓库和合并请求,还扩展到了Wiki、发布、标签、里程碑等;同时提供了业界最全的客户端配置指南,覆盖了Claude Code、Cursor、Copilot等几乎所有主流MCP客户端。

注意事项

不适合仅需要只读Git信息(如查看提交记录)的简单场景,其价值在于对GitLab的全面写入和管理操作。

常见问题

如何在VS Code里用Claude操作GitLab?

安装本Server后,参考VS Code和Claude Code的客户端设置指南进行配置即可。

支持自托管的GitLab实例吗?

完全支持,可以通过环境变量动态配置API地址。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/gitlab-mcp/raw/index.md 读取 gitlab-mcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。