GitLab MCP Server
面向 GitLab 的 Model Context Protocol 服务器,让兼容 MCP 的 AI 客户端通过 GitLab REST/GraphQL API 管理项目、合并请求、议题、流水线、Wiki、发布、标签、标记和里程碑等;默认提供 40 个工具,可借助 discover_tools 扩展,工具总数为 288 个。
访问 zereight/gitlab-mcp项目简介
GitLab MCP Server 通过 Model Context Protocol 将兼容 MCP 的 AI 客户端连接到 GitLab,提供覆盖项目、合并请求、议题、流水线、Wiki、发布、标签、里程碑及相关工作流的工具;默认提供 40 个工具(38 个 core 工具加 discover_tools 和 help),可通过 discover_tools 按会话扩展,工具总数为 288 个。
核心功能
- 覆盖项目、仓库浏览、合并请求、议题、流水线、Wiki、发布、标签、标记和里程碑等 GitLab 功能;支持 Personal Access Token、本地 OAuth2 浏览器流程、MCP OAuth 代理和按请求远程授权;支持 stdio、SSE 和 Streamable HTTP 传输,面向本地、旧版和远程部署;默认仅启用 40 个工具,discover_tools 可激活更多工具集,工具总数为 288 个;支持 JMESPath 结果过滤和精简结果,以减少过大的工具回复;可用于自建 GitLab 实例、代理设置和动态 API URL 路由。
适用场景
- 在兼容 MCP 的 AI 客户端中,通过先列出合并请求变更文件、再批量获取文件差异来审查合并请求;检查流水线并获取分页的任务日志,无需在 GitLab 界面中查找;通过 AI 客户端工作流管理 GitLab 议题、项目、Wiki、发布、标签、标记和里程碑;使用 Streamable HTTP 为团队或远程 AI 客户端运行托管或自建 MCP 端点。
快速开始
- 使用 npm 或 Homebrew 安装 zereight-mcp-gitlab 二进制文件,或使用 npx 一行命令;在 MCP 客户端中配置 GitLab Personal Access Token 或 OAuth2 设置;如不希望注册 MCP,可使用 skill 加 CLI 方式执行工作流。
部署与要求
- 需要 Node.js 20 或更高版本;必须提供 GitLab API URL,以及 Personal Access Token 或 OAuth 配置,服务器才能访问 GitLab;远程 Claude.ai 连接需要公共 HTTPS,并在服务器上设置 GITLAB_MCP_OAUTH;共享 HTTP 部署可暴露 Streamable HTTP 端点供远程客户端使用。
采用前须知
- 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。