This MCP server integrates AI assistants like Claude with GitLab to automate comprehensive code review workflows through GitLab's API. It works with both gitlab.com and self-hosted GitLab instances.
Merge Request Management
Fetch detailed merge request information including diffs, commits, and comments
List all merge requests for a project with filtering by state (opened, closed, merged, locked)
Approve or unapprove merge requests
Analyze specific file changes within merge requests
Code Comparison & Analysis
Compare differences between branches, tags, or commits
View and analyze file-specific changes with line-level precision
Discussion & Comments
Add general comments to merge requests
Create discussions at specific positions in files
Reply to existing discussion threads
Resolve, unresolve, or delete discussions
Project Management
Search for GitLab projects by name
Browse accessible projects
Team Standards
Fetch team-specific code review rules from remote servers via SSH (optional configuration)
Provides tools for GitLab merge request management, including analyzing merge requests with full details and diffs, comparing different branches/tags/commits, adding comments, and managing approvals through the GitLab API.
GitLab MCP 代码审查工具
本项目 fork 自 cayirtepeomer/gerrit-code-review-mcp 并为 GitLab 集成进行了适配。
一个用于将 Claude 等 AI 助手与 GitLab 的合并请求集成的 MCP (Model Context Protocol) 服务器。这使得 AI 助手可以通过 GitLab API 直接审查代码变更。
功能
完整的合并请求分析: 获取合并请求的全部详情，包括差异、提交和评论
文件特定的差异: 分析合并请求中特定文件的变更
版本比较: 比较不同的分支、标签或提交
审查管理: 添加评论、批准或取消批准合并请求
项目概览: 获取项目中的所有合并请求列表
Related MCP server: GitLab PR Analysis MCP Server
安装
先决条件
Python 3.10+
uv
具有 API 范围 (read_api, api) 的 GitLab 个人访问令牌
用于 MCP 集成的 Cursor IDE 或 Claude 桌面应用
Cursor IDE 集成
克隆此仓库：
要将此 MCP 与 Cursor IDE 一起使用，请将以下配置添加到你的 ~/.cursor/mcp.json 文件中：
将
/path/to/your/gitlab-mcp-code-review替换为你克隆仓库的实际路径。将
GITLAB_HOST修改为你的Gitlab地址将
GITLAB_TOKEN修改为你的AccessToken
环境变量
必需的环境变量
GITLAB_HOST: GitLab 实例的主机名（默认: gitlab.com）GITLAB_TOKEN: GitLab 个人访问令牌（需要 api 和 read_api 权限）
可选的环境变量（用于代码审查规范功能）
如果你想使用 fetch_code_review_rules 工具从远程服务器获取团队的代码审查规范，需要配置以下环境变量：
CODE_REVIEW_SSH_HOST: SSH 服务器地址CODE_REVIEW_SSH_PORT: SSH 端口（默认: 22）CODE_REVIEW_SSH_USERNAME: SSH 用户名CODE_REVIEW_SSH_PASSWORD: SSH 密码CODE_REVIEW_RULE_FILE: 规范文件在服务器上的绝对路径（例如: /home/user/code-review-rules.md）
配置示例：
可用工具
MCP 服务器提供以下工具用于与 GitLab 交互：
工具 | 描述 |
| 通过 SSH 获取团队的代码审查规范文件 |
| 获取有关合并请求的完整信息 |
| 比较不同的分支、标签或提交 |
| 向合并请求添加评论 |
| 批准合并请求 |
| 取消批准合并请求 |
| 获取项目的合并请求列表 |
故障排除
如果遇到问题：
验证你的 GitLab 令牌是否具有适当的权限 (api, read_api)
确保你的 MCP 配置路径正确
使用以下命令测试连接：
curl -H "Private-Token: your-token" https://gitlab.com/api/v4/projects
许可证
本项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。