GitLab MCP Server

基本能力

产品定位

GitLab MCP Server 是一个用于与 GitLab 交互的工具，旨在通过 MCP 协议提供对 GitLab 项目的全面管理能力。

核心功能

1. 核心仓库功能
2. 列出项目和获取详细信息
3. 管理分支和仓库
4. 处理合并请求和差异
5. 添加评论和内部笔记到合并请求
6. 更新合并请求属性
7. 列出和处理问题

8. 获取和比较仓库文件内容

9. 项目设置与集成

10. 管理项目集成和服务
11. 配置和控制 Slack 集成

12. 设置、更新和测试 webhooks

13. CI/CD 管理

14. 处理管道触发令牌
15. 管理 CI/CD 变量

16. 触发和控制管道

17. 用户和组管理

18. 列出和管理用户
19. 处理组和组成员资格
20. 管理项目成员和访问级别

适用场景

• 代码审查和合并请求管理
• 项目探索和结构分析
• CI/CD 配置和管理
• 团队协作和项目管理

工具列表

• 列出 GitLab 项目
• 获取合并请求详细信息
• 添加评论到合并请求
• 添加内部笔记到合并请求
• 更新合并请求标题和描述
• 比较分支差异

常见问题解答

• 如何配置 GitLab API 令牌？ 在 MCP 设置文件中添加 GITLAB_API_TOKEN 和 GITLAB_API_URL 环境变量。
• 如何生成 GitLab API 令牌？ 在 GitLab 账户的 Settings > Access Tokens 中生成。

使用教程

使用依赖

• Node.js (v16 或更高版本)
• npm
• GitLab 账户和 API 令牌

安装教程

1. 克隆仓库：

git clone https://github.com/rifqi96/mcp-gitlab.git
cd mcp-gitlab

1. 安装依赖：

npm install

1. 构建服务器：

npm run build

1. 安装 git hooks（可选）：

npm run install-hooks

1. 配置 GitLab API 令牌： 在 MCP 设置文件中添加以下内容：

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "/path/to/mcp-gitlab/build/index.js"
      ],
      "env": {
        "GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

调试方式

1. 列出项目：

Could you list my GitLab projects?

1. 获取合并请求详细信息：

Can you show me the details of merge request with ID 123 in the project 'mygroup/myproject'?

1. 添加评论到合并请求：

Please add a comment to merge request 123 in project 'mygroup/myproject' saying "This looks good, but please add more tests."

许可证

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