GitLab MR Review MCP Server
A Model Context Protocol (MCP) server for reviewing GitLab merge requests using Claude Code and other MCP clients.
Overview
This MCP server provides tools to interact with GitLab's API, enabling AI assistants to analyze merge requests, retrieve changed files, and inspect code diffs. It's designed to integrate seamlessly with Claude Code and other MCP-compatible clients for efficient code review workflows.
Setup
1. Export Environment Variables
export GITLAB_API_URL="http[s]://your_gitlab_uri/api/v4"
export GITLAB_PERSONAL_ACCESS_TOKEN="your-token-here"Get your GitLab token: Settings → Access Tokens → Create token with read_api scope
2. Install in Claude
1. Type /plugin in Claude 2. Select Add marketplace 3. Paste https://github.com/Synaps-Squad/gitlab-mr-mcp 4. Follow the prompts to complete the plugin installation
3. Run Setup (Required - One Time Only)
Before using the plugin, run the setup command in your terminal:
cd ~/.claude/plugins/marketplaces/gitlab-mr-review-marketplace/plugins/gitlab-mr-review # or wherever the plugin was installed
./start.sh --setupThis will install uv (if not present) and set up the Python environment with all dependencies.
4. Verify Installation
- Exit Claude completely and restart it
- Run
/mcpto verify the plugin is loaded
Usage
Quick Command
Use the command directly:
/gitlab-mr-review:review-gitlab-mr MR_number Project_nameOr Ask Claude
- "List my GitLab projects"
- "Review merge request !42 in project your_project_name"
- "Show me the diff for the first file in MR !42"
Available Tools
get_projects()- List all accessible GitLab projectsmerge_request_changes(project_id, merge_request_id)- List changed files in an MRmerge_request_file_diff(project_id, merge_request_id, file_index or file_path)- View file diff
Requirements
- uv (will be auto-installed during setup, or install manually: https://github.com/astral-sh/uv)
- Python 3.10+
- Dependencies:
httpx,mcp
Troubleshooting
If you see an error like "Virtual environment not found", run the setup command:
./start.sh --setupLicense
MIT License - see LICENSE file for details.
