What can you do with this server?

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)

Which integrations are available for this server?

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.

How do I use GitLab MCP Code Review?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GitLab MCP Code Review review merge request #42 in project my-team/web-app" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

GitLab MCP 代码审查工具

Python 3.10+ License: MIT

本项目 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 集成

克隆此仓库：

git clone https://gitea.ffpy.site/ffpy/gitlab-mcp-code-review.git
cd gitlab-mcp-code-review

要将此 MCP 与 Cursor IDE 一起使用，请将以下配置添加到你的 ~/.cursor/mcp.json 文件中：

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/gitlab-mcp-code-review",
        "run",
        "server.py"
      ],
      "env": {
        "GITLAB_HOST": "gitlab.com",
        "GITLAB_TOKEN": "xxx"
      }
    }
  }
}

将 /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）

配置示例：

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "uv",
      "args": ["--directory", "/path/to/your/gitlab-mcp-code-review", "run", "server.py"],
      "env": {
        "GITLAB_HOST": "gitlab.com",
        "GITLAB_TOKEN": "xxx",
        "CODE_REVIEW_SSH_HOST": "your-server.com",
        "CODE_REVIEW_SSH_PORT": "22",
        "CODE_REVIEW_SSH_USERNAME": "your-username",
        "CODE_REVIEW_SSH_PASSWORD": "your-password",
        "CODE_REVIEW_RULE_FILE": "/path/to/code-review-rules.md"
      }
    }
  }
}

可用工具

MCP 服务器提供以下工具用于与 GitLab 交互：

工具	描述
`fetch_code_review_rules`	通过 SSH 获取团队的代码审查规范文件
`fetch_merge_request`	获取有关合并请求的完整信息
`compare_versions`	比较不同的分支、标签或提交
`add_merge_request_comment`	向合并请求添加评论
`approve_merge_request`	批准合并请求
`unapprove_merge_request`	取消批准合并请求
`get_project_merge_requests`	获取项目的合并请求列表