GitLab MCP 用于代码审查

GitLab MCP for Code Review

This project is forked from cayirtepeomer/gerrit-code-review-mcp and adapted for GitLab integration.

An MCP (Model Context Protocol) server for integrating AI assistants like Claude with GitLab's merge requests. This allows AI assistants to review code changes directly through the GitLab API.

Features

Complete Merge Request Analysis: Fetch full details about merge requests including diffs, commits, and comments
File-Specific Diffs: Analyze changes to specific files within merge requests
Version Comparison: Compare different branches, tags, or commits
Review Management: Add comments, approve, or unapprove merge requests
Project Overview: Get lists of all merge requests in a project

Installation

Prerequisites

Python 3.10+
GitLab personal access token with API scope (read_api, api)
Cursor IDE or Claude Desktop App for MCP integration

Quick Start

Clone this repository:

git clone https://github.com/mehmetakinn/gitlab-mcp-code-review.git
cd gitlab-mcp-code-review

Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Create a .env file with your GitLab configuration (see .env.example for all options):

# Required
GITLAB_TOKEN=your_personal_access_token_here

# Optional settings
GITLAB_HOST=gitlab.com
GITLAB_API_VERSION=v4
LOG_LEVEL=INFO

Configuration Options

The following environment variables can be configured in your .env file:

Variable	Required	Default	Description
GITLAB_TOKEN	Yes	-	Your GitLab personal access token
GITLAB_HOST	No	gitlab.com	GitLab instance hostname
GITLAB_API_VERSION	No	v4	GitLab API version to use
LOG_LEVEL	No	INFO	Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
DEBUG	No	false	Enable debug mode
REQUEST_TIMEOUT	No	30	API request timeout in seconds
MAX_RETRIES	No	3	Maximum retry attempts for failed requests

Cursor IDE Integration

To use this MCP with Cursor IDE, add this configuration to your ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Replace /path/to/your/gitlab-mcp-code-review with the actual path to your cloned repository.

Claude Desktop App Integration

To use this MCP with the Claude Desktop App:

Open the Claude Desktop App
Go to Settings → Advanced → MCP Configuration
Add the following configuration:

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Replace /path/to/your/gitlab-mcp-code-review with the actual path to your cloned repository.

Available Tools

The MCP server provides the following tools for interacting with GitLab:

Tool	Description
`fetch_merge_request`	Get complete information about a merge request
`fetch_merge_request_diff`	Get diffs for a specific merge request
`fetch_commit_diff`	Get diff information for a specific commit
`compare_versions`	Compare different branches, tags, or commits
`add_merge_request_comment`	Add a comment to a merge request
`approve_merge_request`	Approve a merge request
`unapprove_merge_request`	Unapprove a merge request
`get_project_merge_requests`	Get a list of merge requests for a project

Usage Examples

Fetch a Merge Request

# Get details of merge request #5 in project with ID 123
mr = fetch_merge_request("123", "5")

View Specific File Changes

# Get diff for a specific file in a merge request
file_diff = fetch_merge_request_diff("123", "5", "path/to/file.js")

Compare Branches

# Compare develop branch with master branch
diff = compare_versions("123", "develop", "master")

Add a Comment to a Merge Request

# Add a comment to a merge request
comment = add_merge_request_comment("123", "5", "This code looks good!")

Approve a Merge Request

# Approve a merge request and set required approvals to 2
approval = approve_merge_request("123", "5", approvals_required=2)

Troubleshooting

If you encounter issues:

Verify your GitLab token has the appropriate permissions (api, read_api)
Check your .env file settings
Ensure your MCP configuration paths are correct
Test connection with: curl -H "Private-Token: your-token" https://gitlab.com/api/v4/projects
Set LOG_LEVEL=DEBUG in your .env file for more detailed logging

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

See the CONTRIBUTING.md file for more details on the development process.

License

This project is licensed under the MIT License - see the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP 服务器将 Claude 等 AI 助手与 GitLab 的合并请求相集成，允许他们直接通过 GitLab API 审查代码更改、添加注释以及批准/取消批准合并请求。

Related MCP Servers

GitHub MCP Server
ualUsham
A
security
F
license
A
quality
An MCP server that enables Claude and other compatible LLMs to interact with the GitHub API, supporting features like creating issues, retrieving repository information, listing issues, and searching repositories.
Last updated -
4
GitLab MCP Server
harshmaur
-
security
A
license
-
quality
An MCP server that enables communication with GitLab repositories, allowing interaction with GitLab's API to manage projects, issues, and repositories through natural language.
Last updated -
8,525
1
MIT License
GitHub MCP Server
alsonwangkhem
A
security
F
license
A
quality
An MCP server that allows Claude and other MCP-compatible LLMs to interact with the GitHub API, supporting features like creating issues, getting repository information, listing issues, and searching repositories.
Last updated -
4
GitHub Notifications MCP Server
mcollina
-
security
A
license
-
quality
An MCP server that enables AI assistants like Claude to help users manage their GitHub notifications through natural language commands.
Last updated -
3
15
MIT License

View all related MCP servers

GitLab MCP for Code Review

GitLab MCP for Code Review

Features

Installation

Prerequisites

Quick Start

Configuration Options

Cursor IDE Integration

Claude Desktop App Integration

Available Tools

Usage Examples

Fetch a Merge Request

View Specific File Changes

Compare Branches

Add a Comment to a Merge Request

Approve a Merge Request

Troubleshooting

Contributing

License

Related MCP Servers

GitHub MCP Server

GitLab MCP Server

GitHub MCP Server

GitHub Notifications MCP Server

Appeared in Searches

New MCP Servers

MCP directory API