什么是 GitLab MCP Server？
GitLab MCP Server 是一个兼容 MCP 的服务器，作为 AI 应用程序与您的 GitLab 实例之间的桥梁。它提供了一组标准化工具（API 接口），使语言模型和 AI 代理可以安全地访问和修改 GitLab 上的仓库、问题、合并请求、维基以及其他项目资源。设计时考虑了灵活性、安全性和可扩展性，支持只读和完全访问模式，并可以在您自己的环境中部署。
如何配置
要配置 GitLab MCP Server，请在应用程序的配置中定义服务器（例如在 Claude App、Cline、Roo Code 或 Cursor 中），通过指定命令、参数和所需的环境变量：
GITLAB_PERSONAL_ACCESS_TOKEN：用于身份验证的 GitLab 个人访问令牌。GITLAB_API_URL：您的 GitLab 实例的 API 接口（默认：https://gitlab.com/api/v4）。GITLAB_READ_ONLY_MODE：设置为'true'限制操作为只读；设置为'false'为完全访问。USE_GITLAB_WIKI：设置为'true'启用维基页面工具。
示例配置：
{
"mcpServers": {
"GitLab 通信服务器": {
"command": "npx",
"args": ["-y", "@zereight/mcp-gitlab"],
"env": {
"GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
"GITLAB_API_URL": "your_gitlab_api_url",
"GITLAB_READ_ONLY_MODE": "false",
"USE_GITLAB_WIKI":"true"
}
}
}
}
如何使用
- 使用您的配置启动 GitLab MCP Server。
- 通过 MCP 协议将 AI 驱动的应用（如 Claude Desktop、Cursor 等）连接到服务器。
- LLM 或客户机可以通过
tools/list接口发现可用工具，并使用tools/call接口调用特定功能。 - 根据您的权限和配置，您可以直接从基于 LLM 的工作流中读取、创建、更新或删除大量 GitLab 资源。
关键特性
- 提供广泛的 GitLab 工具：支持仓库、问题、合并请求、标签、命名空间、维基等超过 40 种功能。
- 只读模式，增强安全性或审计场景。
- 根据需要启用或禁用维基管理工具。
- 可以自我托管，支持公共 GitLab 和自定义/自我管理的 GitLab 实例。
- 通过 MCP 标准轻松集成主流 AI 开发工具和 LLM。
- 基于环境变量的配置，确保安全部署。
用例
- 从 AI 驱动的 IDE 自动化管理仓库和代码审查任务。
- 使用 LLM 代理编写、更新或总结问题和合并请求。
- 通过自然语言接口创建、编辑和组织 GitLab 维基。
- 通过对话 AI 快速引导和管理项目、命名空间和标签。
- 在不暴露内部 API 密钥的情况下安全、审计友好地与公司 GitLab 实例交互。
常见问题
问1：我可以限制 AI 代理可用的工具或将服务器设置为只读吗？
可以。将 GITLAB_READ_ONLY_MODE 设置为 'true'，只会暴露读取操作，防止 AI 代理进行更改。
问2：在配置中使用我的个人访问令牌是否安全？
服务器应在安全环境中运行。限制令牌权限，并考虑在非关键操作中使用只读模式。
问3：如果我只想管理代码和问题，是否需要启用维基功能？
不需要。维基相关的工具默认是禁用的——仅在您需要维基功能时，将 USE_GITLAB_WIKI 设置为 'true'。
问4：这能与 GitLab 自我管理实例一起使用吗？
可以！通过 GITLAB_API_URL 指定您的自定义 API 地址，以连接到自托管或企业版 GitLab 安装。
问5：与原始 GitLab MCP 服务器相比，主要区别是什么？
此版本包括错误修复、可用性改进，以及支持维基、只读模式和增强工具集的新功能。