GitLab MR MCP

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/kopfrechner-gitlab-mr-mcp-badge.png)](https://mseep.ai/app/kopfrechner-gitlab-mr-mcp)
2 
3[![GitHub stars](https://img.shields.io/github/stars/kopfrechner/gitlab-mr-mcp?style=flat)](https://github.com/kopfrechner/gitlab-mr-mcp/stargazers)
4[![License](https://img.shields.io/github/license/kopfrechner/gitlab-mr-mcp)](LICENSE)
5[![smithery badge](https://smithery.ai/badge/@kopfrechner/gitlab-mr-mcp)](https://smithery.ai/server/@kopfrechner/gitlab-mr-mcp)
6 
7# 🚀 GitLab MR MCP
8 
9A Model Context Protocol (MCP) server for interacting with GitLab merge requests and issues.
10 
11## 📌 Overview
12 
13This project implements a server using the Model Context Protocol (MCP) that allows AI agents to interact with GitLab repositories. It provides tools for:
14 
15- Listing available GitLab projects
16- Fetching merge request details and comments
17- Getting merge request diffs
18- Adding comments to merge requests
19- Adding line-specific comments to code in merge request diffs
20- Fetching issue details
21- Setting merge request title and description
22 
23## 📦 Installation
24 
25### ⚡ Using Smithery
26 
27To install GitLab MR MCP for Claude Desktop automatically via Smithery:
28 
29```bash
30npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}"'
31```
32 
33### 🛠️ Manual Installation
34 
35#### 🔧 Prerequisites
36 
37- Node.js
38- GitLab access token with API access
39- GitLab project ID(s)
40 
41#### 📖 Setup
42 
431. Clone this repository
442. Install dependencies:
45 
46```bash
47npm install
48```
49 
503. Add the following to your MCP client configuration:
51```json
52{
53  "mcpServers": {
54    "gitlab-mr-mcp": {
55      "command": "node",
56      "args": ["/path/to/gitlab-mr-mcp/index.js"],
57      "env": {
58        "MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
59        "MR_MCP_GITLAB_HOST": "your_gitlab_host"
60      }
61    }
62  }
63}
64```
65 
66## 🛠️ Available Tools
67 
68* `get_projects`
69  Gets a list of GitLab projects accessible with your token.
70 
71* `list_open_merge_requests`
72  Lists all open merge requests in the specified project.
73 
74* `get_merge_request_details`
75  Gets detailed information about a specific merge request.
76 
77* `get_merge_request_comments`
78  Gets comments from a specific merge request, including discussion notes and diff notes.
79 
80* `add_merge_request_comment`
81  Adds a general comment to a merge request.
82 
83* `add_merge_request_diff_comment`
84  Adds a comment to a specific line in a file within a merge request.
85 
86* `get_merge_request_diff`
87  Gets the diff for a merge request.
88 
89* `get_issue_details`
90  Gets detailed information about a specific issue.
91 
92* `set_merge_request_title`
93  Set the title of a merge request
94 
95* `set_merge_request_description`
96  Set the description of a merge request
97 
98## 🏗️ Development
99 
100### 🔍 Running Inspector
101 
102Set up environment variables:
103 
104```bash
105export MR_MCP_GITLAB_TOKEN=your_gitlab_token
106export MR_MCP_GITLAB_HOST=your_gitlab_host
107 
108# Optional env vars to filter the projects the `get_projects` tool has access to:
109# https://docs.gitlab.com/api/access_requests/#valid-access-levels
110export MR_MCP_MIN_ACCESS_LEVEL=min_access_level
111# Search term that should match the project path or name 
112export MR_MCP_PROJECT_SEARCH_TERM=term 
113```
114 
115For use with MCP clients, you can run:
116 
117```bash
118npx -y @modelcontextprotocol/inspector npm start
119```
120 
121## 🛠️ Troubleshooting
122 
123If you encounter permissions issues (403 Forbidden), check:
124 
1251. Your GitLab token has the proper scopes (api, read_api)
1262. The token user has proper access to the projects
1273. The project IDs are correct
128 
129## 📜 License
130 
131[MIT](LICENSE)
132 
133## 🤝 Contributing
134 
135Contributions are welcome! Please feel free to submit a Pull Request.
136 
137