GitLab PR 分析 MCP 服务器

此项目提供一个 MCP（模型控制协议）服务器，它将 GitLab 合并请求分析与 Confluence 文档集成。该服务器允许您获取合并请求详细信息、分析代码更改，并将结果存储在 Confluence 页面中。

功能

• 获取 GitLab 的合并请求详细信息
• 分析合并请求中的代码更改
• 生成详细报告，包括：
  • 基本合并请求信息
  • 代码更改统计信息
  • 文件类型分析
  • 详细文件更改
• 将分析结果存储在 Confluence 中
• 全面日志记录以用于调试

先决条件

• Python 3.8 或更高版本
• 带有 API 访问权限的 GitLab 账户
• Confluence 账户（可选，用于存储分析结果）
• 访问所需的 GitLab 项目

安装

1. 克隆仓库：

git https://github.com/CodeByWaqas/MRConfluenceLinker-mcp-server.git
cd MRConfluenceLinker-mcp-server

2. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上，使用：.venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

或

uv add "mcp[cli]" python-gitlab python-dotenv atlassian-python-api

配置

创建 config.py 文件并添加以下内容：

# config.py
from mcp_server import resources

resources.initialize()

使用方法

1. 运行服务器：

uvicorn --reload mcp_server.server:app

2. 访问文档：在默认浏览器中打开 http://localhost:8000/docs

3. 使用 API 端点：

   • /api/v1/prs：获取所有合并请求
   • /api/v1/pr/{pr_id}：获取特定合并请求的详细信息

项目结构

MRConfluenceLinker-mcp-server/
├── src/                           # 源代码目录
│   └── mcp_server/              # 主服务器包
│       ├── resources/            # 资源模块
│       │   ├── __init__.py
│       │   ├── client.py        # 客户端实现 / GitLab PR 集成
│       ├── server.py             # 主服务器实现
│       └── mcp_server.log       # 服务器日志
├── __pycache__/                 # Python 缓存文件
├── .git/                        # Git 仓库
├── .gitignore                   # Git 忽略规则
├── CONTRIBUTING.md              # 贡献指南
├── LICENSE                      # 项目许可证
├── README.md                    # 项目文档
├── pyproject.toml              # Python 项目配置
├── requirements.txt            # 项目依赖项
└── uv.lock                     # 依赖项锁定文件

关键组件

• 源代码：位于 src/mcp_server/ 目录中

  • server.py：主要 MCP 服务器实现
  • resources/client.py：客户端实现，包含 GitLab PR 集成

• 配置文件：

  • requirements.txt：Python 包依赖项
  • pyproject.toml：项目元数据和构建配置
  • uv.lock：锁定的依赖版本
  • .env.example：环境变量模板