Gitlab Mr MCP

🚀 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)

📖 设置

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",
      "MR_MCP_GITLAB_HOST": "your_gitlab_host"
    }
  }
}

📚 详细文档

🛠️ 可用工具

🏗️ 开发

🔍 运行 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 禁止），请检查：

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

📄 许可证

MIT

🤝 贡献

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