https://github.com/kopfrechner/gitlab-mr-mcp
https://github.com/kopfrechner/gitlab-mr-mcp
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kopfrechner/gitlab-mr-mcp
- Owner: kopfrechner
- Created: 2025-03-24T20:02:10.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-28T20:39:10.000Z (11 months ago)
- Last Synced: 2025-03-28T21:25:53.115Z (11 months ago)
- Language: JavaScript
- Size: 39.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp - kopfrechner/gitlab-mr-mcp
- best-of-mcp-servers - GitHub - 37% open · ⏱️ 23.01.2026) (Version Control)
- awesome-devops-mcp-servers - kopfrechner/gitlab-mr-mcp - Interact seamlessly with issues and merge requests of your GitLab projects. (Cloud Infrastructure / 🔄 Version Control)
- awesome-mcp-servers - gitlab-mr-mcp - MCP server for seamless interaction with issues and merge requests in GitLab projects. Illustrates an MCP Server for GitLab. ([Read more](/details/gitlab-mr-mcp.md)) `mcp` `gitlab` `project-management` `issues` (Project Management MCP Servers)
- awesome-ccamel - kopfrechner/gitlab-mr-mcp - Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease. (JavaScript)
- awesome-mcp-zh - kopfrechner/gitlab-mr-mcp
- awesome-mcp-servers - kopfrechner/gitlab-mr-mcp - GitLabプロジェクトの課題やマージリクエストとシームレスにやり取りできます。 (サーバー実装 / 🔄 <a name="version-control"></a>バージョン管理)
- metorial-index - GitLab Merge Request Integration - Interact seamlessly with GitLab repositories to manage merge requests and issues, fetch details, and add comments to streamline the code review process. (Developer Tools)
- awesome-devops-mcp - kopfrechner/gitlab-mr-mcp - Interact with GitLab issues and merge requests (🔄 CI/CD & Version Control)
- awesome-mcp-servers - **gitlab-mr-mcp** - Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease. `javascript` `gitlab` `mcp` `mcp-server` `merge-requests` `npm install kopfrechner/gitlab-mr-mcp` (🌐 Web Development)
- awesome-mcp-servers - GitLab Merge Request MCP - Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease. (Table of Contents / Version Control)
- awesome-mcp-servers - kopfrechner/gitlab-mr-mcp - GitLabプロジェクトの課題やマージリクエストとシームレスにやり取りできます。 (サーバー実装 / 🔄 <a name="version-control"></a>バージョン管理)
- awesome-mcp-security - kopfrechner/gitlab-mr-mcp - Interact seamlessly with issues and merge requests of your GitLab projects. (Cloud Infrastructure / 🔄 Version Control)
README
[](https://mseep.ai/app/kopfrechner-gitlab-mr-mcp)
[](https://github.com/kopfrechner/gitlab-mr-mcp/stargazers)
[](LICENSE)
[](https://smithery.ai/server/@kopfrechner/gitlab-mr-mcp)
# 🚀 GitLab MR MCP
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:
```bash
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:
```bash
npm install
```
3. Add the following to your MCP client configuration:
```json
{
"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
# Optional evn vars to filter the projects the `get_projects` tool has access to:
# https://docs.gitlab.com/api/access_requests/#valid-access-levels
export MR_MCP_MIN_ACCESS_LEVEL=min_access_level
# Search term that should match the project path or name
export MR_MCP_PROJECT_SEARCH_TERM=term
```
For use with MCP clients, you can run:
```bash
npx -y @modelcontextprotocol/inspector npm start
```
## 🛠️ Troubleshooting
If you encounter permissions issues (403 Forbidden), check:
1. Your GitLab token has the proper scopes (api, read_api)
2. The token user has proper access to the projects
3. The project IDs are correct
## 📜 License
[MIT](LICENSE)
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.