项目简介

GitLab MCP 服务器是一个基于Model Context Protocol的实现，专门用于将AI助手连接到GitLab平台，让用户可以直接在聊天界面中查询和管理GitLab项目信息。

主要功能

• 合并请求管理：列出、查看详细信息、按分支查找合并请求
• 测试报告分析：获取详细的测试失败报告和轻量级测试摘要
• 流水线监控：查看CI/CD流水线状态和作业详细信息
• 代码评审交互：查看讨论、回复评论、创建新讨论、解决讨论
• 提交讨论查看：获取特定提交的详细讨论历史
• 作业日志获取：查看特定流水线作业的完整输出和错误信息

安装步骤

1. 安装依赖管理工具：使用uv进行Python包管理
2. 克隆并安装服务器：

   git clone https://github.com/amirsina-mandegari/gitlab-mcp-server.git
   cd gitlab-mcp-server
   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

服务器配置

在MCP客户端配置文件中添加GitLab服务器信息：

• 服务器名称：gitlab-mcp
• 启动命令：指向项目目录中的run-mcp.sh脚本
• 工作目录：设置为你的项目根目录

基本使用方法

1. 获取GitLab访问令牌：在GitLab设置中创建具有'read_api'权限的访问令牌
2. 配置项目信息：在项目目录创建gitlab-mcp.env文件，设置项目ID、访问令牌和GitLab地址
3. 连接AI客户端：配置完成后重启客户端即可开始使用
4. 常用查询示例：
   • "列出所有打开的合并请求"
   • "显示合并请求#123的详细信息"
   • "获取合并请求#456的测试报告"
5. 交互式评审：查看讨论后使用讨论ID进行回复或解决

典型工作流程：

• 查看合并请求列表 → 选择特定MR查看详细信息 → 检查测试失败情况 → 查看具体作业日志 → 参与讨论