让 Pi 编程代理通过单一代理工具使用 MCP 服务器,避免工具定义占满上下文。
zereight/gitlab-mcp
让 AI 助手通过结构化工具操作 GitLab 项目、合并请求、议题、流水线和 Wiki 的 MCP 服务器。
- Star
- 2,089
- Fork
- 368
- 未关闭 Issue
- 11
- 最近提交
- 昨天
这是什么?
gitlab-mcp 是一个 Model Context Protocol 服务器,用于把 Claude、Cursor、VS Code、Copilot 等 AI 客户端连接到 GitLab 实例。它基于 GitLab REST 和 GraphQL API,提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki、发布、标签和里程碑等操作。默认只加载约 40 个核心工具,其余工具集可在会话中按需激活,以控制模型可见的工具列表长度。
本地客户端可通过 stdio 连接,团队共享或托管部署则可使用 Streamable HTTP 或 SSE。认证方式包括个人访问令牌、本地 OAuth2 浏览器授权、面向远程客户端的 MCP OAuth 代理,以及支持多用户的逐请求令牌转发。只读、修改、完全等权限模式,以及工具白名单和黑名单、群组与项目限制,可以约束智能体的操作范围。
在合并请求审查方面,可先列出变更文件,再分批获取差异内容。JMESPath 过滤和结果压缩可以缩减过大的返回内容。同一个程序还提供命令行接口,用于在终端中获取完整的差异和任务日志,并同时支持 GitLab.com 与自建实例。
核心功能
- 01提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki 和发布
- 02默认加载精简工具集,其余工具按需激活
- 03支持 stdio、SSE 和 Streamable HTTP 传输方式
- 04支持个人访问令牌、OAuth2 以及逐请求的远程授权
- 05提供只读、修改等权限模式,并可按工具和项目过滤
- 06合并请求审查分两步进行,先列出变更文件,再分批获取差异
适用场景
- 让 AI 编程助手读取合并请求的变更文件和差异并给出审查意见
- 让智能体查看流水线任务日志或在 GitLab 中触发 CI 相关操作
- 在团队内共享一个托管的 GitLab MCP 端点,每位用户使用各自的令牌
- 搭建只读的 GitLab 集成,用于报表统计或议题分拣
快速上手
- 1
从 npm 安装可执行文件
npm install -g @zereight/mcp-gitlab - 2
设置 GitLab 个人访问令牌(不回显输入)
read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN - 3
在 Claude Code 中注册该服务器
claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
使用前须知
- 默认工具集仅提供约 40 个工具,其他工具需通过 discover_tools 激活。
- api 工具集存在风险,因为它会绕过白名单和安全检查。
收录于专题
标签
常见问题
- gitlab-mcp 是什么?
- 让 AI 助手通过结构化工具操作 GitLab 项目、合并请求、议题、流水线和 Wiki 的 MCP 服务器。 gitlab-mcp 是一个 Model Context Protocol 服务器,用于把 Claude、Cursor、VS Code、Copilot 等 AI 客户端连接到 GitLab 实例。它基于 GitLab REST 和 GraphQL API,提供约 280 个工具,覆盖项目、合并请求、议题、流水线、Wiki、发布、标签和里程碑等操作。默认只加载约 40 个核心工具,其余工具集可在会话中按需激活,以控制模型可见的工具列表长度。
- gitlab-mcp 可以免费使用吗?用的什么许可证?
- gitlab-mcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- gitlab-mcp 还在维护吗?
- 活跃维护中。gitlab-mcp 最近一次提交是在 2026年11月6日。
- gitlab-mcp 适合用来做什么?
- 让 AI 编程助手读取合并请求的变更文件和差异并给出审查意见 让智能体查看流水线任务日志或在 GitLab 中触发 CI 相关操作 在团队内共享一个托管的 GitLab MCP 端点,每位用户使用各自的令牌 搭建只读的 GitLab 集成,用于报表统计或议题分拣
- gitlab-mcp 怎么安装和运行?
- 从 npm 安装可执行文件: npm install -g @zereight/mcp-gitlab 设置 GitLab 个人访问令牌(不回显输入): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN 在 Claude Code 中注册该服务器: claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
- 在哪里获取 gitlab-mcp?
- 源代码和安装说明在 GitHub 上:https://github.com/zereight/gitlab-mcp
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
托管式 MCP 服务器,让 AI 智能体获取 YouTube 字幕、搜索视频、列出频道和播放列表,并免费追踪新上传。
让 Claude、Cursor 等 AI 助手通过自建或可信的 SearXNG 实例进行网页搜索的 MCP 服务器。
一个 Python CLI 与 MCP 服务器,通过可复用的规则筛选代码文件,为编码智能体或聊天提供上下文。
一个分步骤的 Go 教程,带你基于 Claude API 从零构建一个编程智能体,逐步加入文件、命令和代码搜索工具。
让 Claude、Cursor、Copilot 等 AI 代理通过 MCP 操作 Unity 编辑器,并可在游戏运行时调用 LLM 的插件。