🚀 GitLab MR MCP

🚀 GitLab MR MCP

site icon
2025.04.16 17
JavaScriptGitLab 集成合并请求管理问题跟踪交流协作
GitLab MR MCP 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 GitLab 的合并请求(Merge Requests)和问题(Issues)进行交互。它提供了一系列工具,使得 AI 代理能够高效地管理 GitLab 仓库中的合并请求和问题。
View on GitHub

Overview

基本能力

产品定位

GitLab MR MCP 是一个专门为 GitLab 设计的 MCP 服务器,旨在通过 AI 代理自动化管理 GitLab 仓库中的合并请求和问题。

核心功能

  • 列出可用的 GitLab 项目
  • 获取合并请求的详细信息和评论
  • 获取合并请求的差异(diff)
  • 向合并请求添加评论
  • 向合并请求的代码差异中添加行级评论
  • 获取问题的详细信息

适用场景

  • 自动化代码审查流程
  • 团队协作中的合并请求管理
  • 问题跟踪和解决

工具列表

  • 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: 获取特定问题的详细信息

常见问题解答

  • 权限问题(403 Forbidden): 检查 GitLab 令牌是否具有正确的范围(api, read_api),令牌用户是否有项目访问权限,以及项目 ID 是否正确。

使用教程

使用依赖

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

安装教程

使用 Smithery 自动安装

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

手动安装

  1. 克隆仓库
  2. 安装依赖
npm install
  1. 配置 MCP 客户端
{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"]
    }
    "env": {
      "MR_MCP_GITLAB_TOKEN": "your_gitlab_token"
    }
  }
}

调试方式

设置环境变量

export MR_MCP_GITLAB_TOKEN=your_gitlab_token

运行 Inspector

npx -y @modelcontextprotocol/inspector npm start

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。