JinDaGe - gitlab-mr-mcp MCP Details

article

README

🚀 GitLab MR MCP

一个使用 Model Context Protocol (MCP) 实现与 GitLab 合并请求和问题交互的服务器，借助该服务器，可让 AI 代理与 GitLab 仓库进行交互。

🚀 快速开始

该项目实现了一个基于 Model Context Protocol (MCP) 的服务器，允许 AI 代理与 GitLab 仓库进行交互，能实现列出可用项目、获取合并请求详细信息等功能。

✨ 主要特性

列出可用的 GitLab 项目
获取合并请求的详细信息和评论
获取合并请求的代码差分
在合并请求上添加评论
在代码差分的特定行上添加注释
获取问题的详细信息

📦 安装指南

⚡ 使用 Smithery

要通过 Smithery 自动安装 GitLab MR MCP 以便在 Claude Desktop 上使用：

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

🛠️ 手动安装

🔧 先决条件

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

📖 设置

克隆此仓库
安装依赖项：

npm install

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

{
  "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"
    }
  }
}

📚 详细文档

🛠️ 可用工具

| 工具名称 | 详情 | | ---- | ---- | | 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
export MR_MCP_GITLAB_HOST=your_gitlab_host

用于与 MCP 客户端一起使用时，可以运行：

npx -y @modelcontextprotocol/inspector npm start

🛠️ 问题排除

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

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

📄 许可证

MIT

🤝 贡献

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

gitlab-mr-mcp