🚀 GitLab MR MCP

[![GitHub stars](https://img.shields.io/github/stars/kopfrechner/gitlab-mr-mcp?style=flat)](https://github.com/kopfrechner/gitlab-mr-mcp/stargazers)
[![License](https://img.shields.io/github/license/kopfrechner/gitlab-mr-mcp)](LICENSE)
[![smithery badge](https://smithery.ai/badge/@kopfrechner/gitlab-mr-mcp)](https://smithery.ai/server/@kopfrechner/gitlab-mr-mcp)

# 🚀 GitLab MR MCP

一个用于与 GitLab 合并请求和问题交互的模型上下文协议 (MCP) 服务器。

## 📌 概述

本项目实现了一个使用模型上下文协议 (MCP) 的服务器，允许 AI 代理与 GitLab 仓库进行交互。它提供了以下工具：

- 列出可用的 GitLab 项目
- 获取合并请求的详细信息和评论
- 获取合并请求的差异
- 向合并请求添加评论
- 向合并请求差异中的代码添加行特定评论
- 获取问题详情

## 📦 安装

### ⚡ 使用 Smithery

要通过 Smithery 为 Claude Desktop 自动安装 GitLab MR MCP，请执行以下操作：

```bash
npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\"}"'

🛠️ 手动安装

🔧 前提条件

• Node.js
• 具有 API 访问权限的 GitLab 访问令牌
• GitLab 项目 ID

📖 设置

1. 克隆此仓库
2. 安装依赖项：

npm install

3. 将以下内容添加到您的 MCP 客户端配置中：

{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"]
    }
    "env": {
      "MR_MCP_GITLAB_TOKEN": "your_gitlab_token"
    }
  }
}

🛠️ 可用工具

• get_projects 获取可以使用您的令牌访问的 GitLab 项目列表。

• list_open_merge_requests 列出指定项目中的所有打开的合并请求。

• get_merge_request_details 获取有关特定合并请求的详细信息。

• get_merge_request_comments 从特定合并请求获取评论，包括讨论注释和差异注释。

• add_merge_request_comment 向合并请求添加一般评论。

• add_merge_request_diff_comment 向合并请求中文件的特定行添加评论。

• get_merge_request_diff 获取合并请求的差异。

• get_issue_details 获取有关特定问题的详细信息。

🏗️ 开发

🔍 运行 Inspector

设置环境变量：

export MR_MCP_GITLAB_TOKEN=your_gitlab_token

为了与 MCP 客户端一起使用，您可以运行：

npx -y @modelcontextprotocol/inspector npm start

🛠️ 故障排除

如果您遇到权限问题（403 Forbidden），请检查：

1. 您的 GitLab 令牌具有正确的范围（api, read_api）
2. 令牌用户具有对项目的适当访问权限
3. 项目 ID 正确

📜 许可证

MIT

🤝 贡献

欢迎贡献！请随时提交 Pull Request。