Gitlab MR Confluence Linker

一個集成GitLab合併請求分析與Confluence文檔存儲的MCP服務器項目

開發者工具知識管理與記憶 #代碼分析 #文檔存儲 #GitLab集成 #Confluence .Python

評分 : 2分

下載量 : 8.5K

更新時間 : 2025-04-28

打開站點

什麼是 GitLab PR 分析與 Confluence 集成 MCP 服務器？

該服務器通過分析 GitLab 的合併請求（Merge Requests），生成詳細的代碼變更報告，並將結果存儲到 Confluence 中，方便團隊協作與文檔管理。

如何使用 GitLab PR 分析與 Confluence 集成 MCP 服務器？

您可以通過命令行或圖形界面發送指令，服務器會自動獲取合併請求信息並生成分析報告。

適用場景

適合需要高效代碼審查、自動化文檔生成以及團隊協作的軟件開發項目。

主要功能

獲取合併請求詳情

從 GitLab 獲取指定項目的合併請求詳情。

代碼變更分析

對指定合併請求的代碼變更進行詳細統計，包括新增、刪除和修改的文件數量。

Confluence 存儲

將合併請求的分析結果直接存儲到 Confluence 頁面。

優勢

自動化的代碼變更分析減少人工工作量。

支持將分析結果無縫集成到 Confluence 中。

多維度的報告有助於團隊協作與決策。

靈活的配置選項適應不同項目需求。

侷限性

需要配置 GitLab 和 Confluence 的 API 憑證。

對大規模項目的分析可能消耗較多時間。

依賴網絡連接，斷網時無法運行。

如何使用

安裝 MCP 服務器

克隆代碼倉庫並設置虛擬環境。

配置環境變量

編輯 .env 文件並填寫 GitLab 和 Confluence 的 API 憑證。

啟動服務器

運行服務器腳本並開始交互。

使用案例

獲取合併請求詳情

從 GitLab 獲取指定項目的合併請求詳情。

分析代碼變更

分析指定合併請求的代碼變更情況。

存儲到 Confluence

將合併請求的分析結果存儲到 Confluence 頁面。

常見問題

如何獲取 GitLab API Token？

如果 Confluence 頁面已存在，如何更新內容？

服務器啟動失敗怎麼辦？

🚀 GitLab PR 分析 MCP 服務器

本項目提供了一個 MCP（模型控制協議）服務器，它將 GitLab 合併請求分析與 Confluence 文檔進行了集成。藉助該服務器，您能夠從 GitLab 拉取合併請求的詳細信息、分析代碼更改，並將分析結果存儲在 Confluence 頁面中。

🚀 快速開始

先決條件

Python 3.8 或更高版本
GitLab 賬戶和 API 訪問權限
Confluence 賬戶和 REST API 訪問權限

安裝步驟

克隆該項目：

git clone https://git.example.com/gitlab-pr-analysis.git
cd gitlab-pr-analysis

激活虛擬環境（推薦）：

python -m venv env
source env/bin/activate  # 在 macOS/Linux 上
.\env\Scripts\activate  # 在 Windows 上

安裝依賴項：
```
pip install -r requirements.txt
```

配置環境變量：

創建 .env 文件並填寫以下內容：

GITHUB_TOKEN=your_github_token
CONFLUENCE_BASE_URL=https://your.confluence.url
CONFLUENCE_API_KEY=your_confluence_api_key

啟動 MCP 服務器：

python src/MRConfluenceLinker-mcp-server/server.py

✨ 主要特性

從 GitLab 獲取合併請求詳細信息
分析合併請求中的代碼更改
生成包含以下內容的詳細報告：
- 基本合併請求信息
- 代碼更改統計信息
- 文件類型分析
- 詳細的文件更改
將分析結果存儲在 Confluence 中
全面的日誌記錄以備調試

💻 使用示例

配置與集成

將 MCP 服務器與 Claude Desktop 集成，請參考 CONTRIBUTING.md 文件中的指導。
更新 pyproject.toml 和 requirements.txt 文件以管理項目依賴關係。

工具使用

以下是 MCP 服務器的主要功能：

拉取合併請求詳細信息：
- 使用 GitLab API 獲取指定倉庫的合併請求列表和詳細信息。
分析代碼更改：
- 掃描合併請求中的代碼變更，生成差異報告並識別潛在問題。
存儲到 Confluence：
- 將分析結果自動上傳到 Confluence 頁面中，便於團隊協作和審查。

📚 詳細文檔

項目結構

MRConfluenceLinker-mcp-server/
├── src/                           # 源代碼目錄
│   └── MRConfluenceLinker-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/MRConfluenceLinker-mcp-server/ 目錄中
- server.py：主 MCP 服務器實現
- resources/client.py：客戶端實現，包含 GitLab PR 集成
配置文件：
- requirements.txt：Python 包依賴項
- pyproject.toml：項目元數據和構建配置
- uv.lock：鎖定的依賴版本
- .env.example：環境變量模板