GitLab MCP Server

GitLab MCP 服务器

一个模型上下文协议 (MCP) 服务器，使您能够与您的 GitLab 帐户进行交互。获取差异、分析合并请求、审查代码、cherry-pick 更改等等。这是模型上下文协议项目中 MCP GitLab 服务器的扩展版本。

功能

此 MCP 服务器提供用于与 GitLab 存储库交互的综合工具，包括：

核心存储库功能

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

项目设置和集成

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

CI/CD 管理

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

用户和组管理

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

安装

前提条件

Node.js (v16 或更高版本)
npm
具有 API 令牌的 GitLab 帐户

设置

克隆存储库：

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

安装依赖项：

npm install

构建服务器：

npm run build

安装 git hooks（可选，但建议贡献者使用）：

npm run install-hooks

这会安装一个 pre-commit hook，当 src/utils/tools-data.ts 更改时，它会自动重新生成 TOOLS.md。

配置您的 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 助手一起使用的示例：

列出您的项目

Could you list my GitLab projects?

获取有关特定合并请求的信息

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

向合并请求添加评论

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

向合并请求添加内部注释

Add an internal note to merge request 123 in project 'mygroup/myproject' that says "Needs security review before merging." Make sure it's only visible to team members.

更新合并请求标题和描述

Update the title of merge request 123 in project 'mygroup/myproject' to "Fix login page performance issues" and update the description to include "This PR addresses the slow loading times on the login page by optimizing database queries."

比较分支

Compare the 'feature-branch' with 'main' in the project 'mygroup/myproject' and show me the differences.

实际工作流程

审查合并请求

1. Show me merge request 123 in project 'mygroup/myproject'
2. Show me the changes for this merge request
3. Add an internal note with my review comments
4. Update the merge request title to better reflect the changes

项目探索

1. List all my GitLab projects
2. Show me the details of project 'mygroup/myproject'
3. List all branches in this project
4. Show me the content of the README.md file in the main branch

可用资源

gitlab://projects

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

与 AI 助手集成

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

功能

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

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

充分利用 AI 助手集成

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

许可证

MIT