GitLab-MCP-Server

这是一个提供与 GitLab 集成功能的 Model Context Protocol (MCP) 服务器。它从 GitLab 的特定项目中获取流水线失败信息和合并请求的评论，并将其提供给 AI 助手。

概要

此 MCP 服务器利用 GitLab 的 API 向 AI 助手提供以下信息：

1. GitLab 流水线中失败的作业的控制台输出
2. GitLab MR 中未解决的评论
3. GitLab MR 的更改内容（与本地存储库当前状态的差异）

通过使用 MCP 功能，AI 助手可以直接获取 GitLab 的信息，从而提供更准确的帮助。

安装

# 安装 uv
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/this-mcp-server
# 安装库
$ uv sync

准备

需要 GitLab 的访问令牌。 请在 GitLab 的设置 -> 访问令牌中生成访问令牌。 生成时，请勾选 read_api。

功能

1. 获取流水线失败信息并进行修复 (get_pipeline_failed_jobs)

获取 GitLab 流水线中失败的作业的控制台输出。 基于获取的信息，AI 助手将进行修复。

输出:

• 失败的作业的控制台输出（包括作业名称、状态和详细日志）

2. 获取 MR 的评论并进行修复 (get_review_comments)

获取 GitLab MR 中未解决的评论并进行处理。 已解决的评论或未与文件关联的评论将被排除。

输出:

• MR 中未解决且与文件关联的评论（包括评论者、时间、评论内容、文件位置信息等）

3. 获取 MR 的更改内容并进行审查 (get_review_changes)

获取 GitLab MR 的基础提交（base_sha）到当前本地存储库状态的差异。 可以获取本地最新状态（包括未提交的更改）的差异，而不是远程差异。 获取的差异将用于审查。

输出:

• MR 的基础提交到当前本地状态的更改内容（每个文件的更改类型和差异）

AI 助手との連携

AI 助手（例如 Claude）可以调用此 MCP 服务器的以下函数：

• get_pipeline_failed_jobs(): 获取流水线失败信息
• get_review_comments(): 获取 MR 的评论
• get_review_changes(): 获取 MR 的更改内容

这些函数会自动获取与当前分支相关的 MR 信息。

Claude for Desktop 中的设置

请将以下设置添加到 claude_desktop_config.json 中：

{
    "mcpServers": {
        "gitlab-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/this-mcp-server",
                "run",
                "main.py"
            ],
            "env": {
                "GITLAB_URL": "your_gitlab_url",
                "GITLAB_PROJECT_NAME": "gitlab_project_name",
                "GITLAB_API_KEY": "your_gitlab_api_key",
                "GIT_REPO_PATH": "/path/to/git/repo"
            }
        }
    }
}

Cursor 中的设置

请将以下设置添加到项目根目录的 .cursor/mcp.json 中：

{
    "mcpServers": {
        "gitlab-mcp": {
            "command": "env",
            "args": [
                "GITLAB_URL=your_gitlab_url",
                "GITLAB_PROJECT_NAME=gitlab_project_name",
                "GITLAB_API_KEY=your_gitlab_api_key",
                "GIT_REPO_PATH=/path/to/git/repo",
                "uv",
                "--directory",
                "/path/to/this-mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

注意：在上面的配置示例中，请适当替换以下值：

• your_gitlab_api_key: GitLab API 的访问令牌
• /path/to/git/repo: 本地 Git 存储库的绝对路径
• /path/to/this-mcp-server: 此 MCP 服务器目录的绝对路径