GitLab MCP 服务器

这是一个基于模型上下文协议（MCP）的服务器，允许您与您的 GitLab 账户进行交互。获取差异、分析合并请求、审查代码、挑选更改等。这是来自 Model Context Protocol 项目的 MCP GitLab 服务器 的扩展版本。

<a href="https://glama.ai/mcp/servers/@rifqi96/mcp-gitlab"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=3596427274,3351377076&fm=3081&app=3181&f=PNG?w=760&h=400" alt="GitLab Server MCP 服务器" /> </a>

功能

此 MCP 服务器提供了与 GitLab 存储库交互的全面工具，包括：

核心存储库功能

• 列出项目并检索详细信息
• 管理分支和存储库
• 处理合并请求和差异
• 在合并请求中添加评论和内部注释
• 更新合并请求属性
• 列出并处理问题
• 获取和比较存储库文件内容

项目设置及集成

• 管理项目集成和服务
• 配置和控制 Slack 集成
• 设置、更新和测试 Webhook

CI/CD 管理

• 处理管道触发令牌
• 管理 CI/CD 变量
• 触发和控制管道

用户及组管理

• 列出和管理用户
• 处理组和组成员资格
• 管理项目成员及其访问级别

安装

先决条件

• Node.js（v16 或更高版本）
• npm
• 带有 API 令牌的 GitLab 账户

设置

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

4. 安装 git 钩子（可选，但推荐给贡献者）：

npm run install-hooks

这会安装一个预提交钩子，在 src/utils/tools-data.ts 发生变化时自动重新生成 TOOLS.md。

5. 配置您的 GitLab API 令牌： 您需要在 MCP 设置配置文件中提供您的 GitLab API 令牌。该令牌用于与 GitLab API 进行身份验证。

对于 Cursor/Roo Cline，请在您的 MCP 设置文件 (~/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json) 中添加以下内容：

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

对于 Claude Desktop，请在您的 MCP 设置文件 (~/Library/Application Support/Claude/claude_desktop_config.json) 中添加以下内容：

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

将 YOUR_GITLAB_API_TOKEN 替换为您实际的 GitLab API 令牌。您可以在 GitLab 账户的设置 > 访问令牌下生成一个令牌。

可用工具

完整的可用工具列表及其参数，请参阅 TOOLS.md。

示例使用

这里有一些如何使用这些工具与支持 MCP 的 AI 助手的例子：

列出您的项目

你能列出我的 GitLab 项目吗？

获取特定合并请求的信息

你能显示项目 'mygroup/myproject' 中合并请求 ID 123 的详情吗？

向合并请求添加评论

请在项目 'mygroup/myproject' 的合并请求 123 中添加评论：“这看起来不错，但请增加更多的测试。”

向合并请求添加内部注释

在项目 'mygroup/myproject' 的合并请求 123 中添加内部注释：“在合并前需要进行安全审查。”确保只有团队成员可见。

更新合并请求标题和描述

将项目 'mygroup/myproject' 中合并请求 123 的标题更新为“修复登录页面性能问题”，并将描述更新为“此 PR 通过优化数据库查询解决了登录页面加载缓慢的问题。”

比较分支

比较项目 'mygroup/myproject' 中的 'feature-branch' 和 'main' 分支，并显示差异。

实用工作流程

审查合并请求

1. 显示项目 'mygroup/myproject' 中的合并请求 123
2. 显示此合并请求的更改
3. 添加包含我评审意见的内部注释
4. 更新合并请求标题以更好地反映更改

项目探索

1. 列出所有我的 GitLab 项目
2. 显示项目 'mygroup/myproject' 的详细信息
3. 列出该项目中的所有分支
4. 显示主分支中的 README.md 文件的内容

可用资源

gitlab://projects

使用您的 API 令牌可以访问的 GitLab 项目列表。

与 AI 助手的集成

GitLab MCP 服务器与支持模型上下文协议（MCP）的 AI 助手集成。

能力

当连接到 AI 助手时，此服务器使助手能够：

1. 查看和分析代码：助手可以获取文件内容、查看分支差异并检查合并请求更改，以更好地理解代码。
2. 提供代码审查：助手可以分析合并请求并通过评论或内部注释提供反馈。
3. 管理项目工作流：助手可以更新合并请求属性、添加评论并帮助完成存储库管理任务。
4. 探索项目结构：助手可以浏览项目、分支和文件以了解代码库结构。
5. 配置 CI/CD 和集成：助手可以帮助设置 Webhook、管理 CI/CD 变量并配置项目集成。

最大化 AI 助手集成的价值

• 当询问项目、合并请求或文件时要具体
• 尽可能提供项目 ID 或路径
• 使用助手进行代码审查，要求它分析特定的合并请求
• 让助手帮助完成存储库配置和管理任务
• 使用内部注释对合并请求提供仅限团队成员的反馈

许可证

MIT