🚀 GitLab MR MCP
About
Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease.
Details
- Transport
- SSE
- License
- MIT
Explore
- List accessible GitLab projects
- View open merge requests and detailed information
- Retrieve and add general comments to merge requests
- Get merge request diffs and add line-specific comments
- Fetch issue details
- Modify merge request title and description
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🚀 GitLab MR MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Clone this repository
2. Install dependencies:
npm install
3. Add the following to your MCP client configuration:
{
"mcpServers": {
"gitlab-mr-mcp": {
"command": "node",
"args": ["/path/to/gitlab-mr-mcp/index.js"],
"env": {
"MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
"MR_MCP_GITLAB_HOST": "your_gitlab_host"
}
}
}
}
- Node.js
- GitLab access token with API access
- GitLab project ID(s)
Set up environment variables:
```bash
export MR_MCP_GITLAB_TOKEN=your_gitlab_token
export MR_MCP_GITLAB_HOST=your_gitlab_host
get_projects
Gets a list of GitLab projects accessible with your token.
list_open_merge_requests
Lists all open merge requests in the specified project.
get_merge_request_details
Gets detailed information about a specific merge request.
get_merge_request_comments
Gets comments from a specific merge request, including discussion notes and diff notes.
add_merge_request_comment
Adds a general comment to a merge request.
add_merge_request_diff_comment
Adds a comment to a specific line in a file within a merge request.
get_merge_request_diff
Gets the diff for a merge request.
get_issue_details
Gets detailed information about a specific issue.
set_merge_request_title
Set the title of a merge request
set_merge_request_description
Set the description of a merge request
get_projects
Gets a list of GitLab projects accessible with your token.
list_open_merge_requests
Lists all open merge requests in the specified project.
get_merge_request_details
Gets detailed information about a specific merge request.
get_merge_request_comments
Gets comments from a specific merge request, including discussion notes and diff notes.
add_merge_request_comment
Adds a general comment to a merge request.
add_merge_request_diff_comment
Adds a comment to a specific line in a file within a merge request.
get_merge_request_diff
Gets the diff for a merge request.
get_issue_details
Gets detailed information about a specific issue.
set_merge_request_title
Set the title of a merge request
set_merge_request_description
Set the description of a merge request
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83d\ude80 gitlab mr mcp": {
"gitlab-mr-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"install",
"@kopfrechner/gitlab-mr-mcp",
"--client",
"claude",
"--config",
"\"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}\""
]
}
}
}
}McpServers
{
"gitlab-mr-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"install",
"@kopfrechner/gitlab-mr-mcp",
"--client",
"claude",
"--config",
"\"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}\""
]
}
}A Model Context Protocol (MCP) server for interacting with GitLab merge requests and issues.
📌 Overview
This project implements a server using the Model Context Protocol (MCP) that allows AI agents to interact with GitLab repositories. It provides tools for:
- Listing available GitLab projects
- Fetching merge request details and comments
- Getting merge request diffs
- Adding comments to merge requests
- Adding line-specific comments to code in merge request diffs
- Fetching issue details
- Setting merge request title and description
📦 Installation
⚡ Using Smithery
To install GitLab MR MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}"'
🛠️ Manual Installation
🔧 Prerequisites
- Node.js
- GitLab access token with API access
- GitLab project ID(s)
📖 Setup
1. Clone this repository
2. Install dependencies:
npm install
3. Add the following to your MCP client configuration:
{
"mcpServers": {
"gitlab-mr-mcp": {
"command": "node",
"args": ["/path/to/gitlab-mr-mcp/index.js"],
"env": {
"MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
"MR_MCP_GITLAB_HOST": "your_gitlab_host"
}
}
}
}
🛠️ Available Tools
get_projects
Gets a list of GitLab projects accessible with your token.
list_open_merge_requests
Lists all open merge requests in the specified project.
get_merge_request_details
Gets detailed information about a specific merge request.
get_merge_request_comments
Gets comments from a specific merge request, including discussion notes and diff notes.
add_merge_request_comment
Adds a general comment to a merge request.
add_merge_request_diff_comment
Adds a comment to a specific line in a file within a merge request.
get_merge_request_diff
Gets the diff for a merge request.
get_issue_details
Gets detailed information about a specific issue.
set_merge_request_title
Set the title of a merge request
set_merge_request_description
Set the description of a merge request
🏗️ Development
🔍 Running Inspector
Set up environment variables:
```bash
export MR_MCP_GITLAB_TOKEN=your_gitlab_token
export MR_MCP_GITLAB_HOST=your_gitlab_host
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
