Integrations
Enables interaction with GitLab's API to analyze and manage merge requests, including fetching diffs, comparing versions, adding comments, and approving/unapproving merge requests.
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 for full MCP integration
Quick Start
- Clone this repository:
- Create and activate a virtual environment:
- Install dependencies:
- Create a
.env
file with your GitLab configuration (see.env.example
for all options):
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:
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
View Specific File Changes
Compare Branches
Add a Comment to a Merge Request
Approve a Merge Request
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
An MCP server that integrates AI assistants like Claude with GitLab's merge requests, allowing them to review code changes, add comments, and approve/unapprove merge requests directly through the GitLab API.
Related MCP Servers
- AsecurityAlicenseAqualityMCP Server for the GitLab API, enabling project management, file operations, and more.Last updated -92,67443,961JavaScriptMIT License
- -securityFlicense-qualityA custom server implementation that allows AI assistants to interact with GitLab repositories, providing capabilities for searching, fetching files, creating/updating content, and managing issues and merge requests.Last updated -JavaScript
- -securityFlicense-qualityAn 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 -20JavaScript
- AsecurityFlicenseAqualityAn MCP server that enables AI assistants to manage GitHub Actions workflows by providing tools for listing, viewing, triggering, canceling, and rerunning workflows through the GitHub API.Last updated -924TypeScript