Owayo Gitlab MCP Server

🚀 GitLab-MCP-Server

GitLab-MCP-Server 是一個提供與 GitLab 集成功能的 Model Context Protocol (MCP) 服務器。它能夠從 GitLab 的特定項目中獲取流水線失敗信息和合並請求中的問題，並將這些信息提供給 AI 助手，幫助 AI 助手提供更精準的支持。

🚀 快速開始

這個 MCP 服務器利用 GitLab 的 API 為 AI 助手提供以下信息：

1. GitLab 流水線中失敗作業的控制檯輸出。
2. GitLab 合併請求（MR）中未解決的問題（評論）。
3. GitLab 合併請求的更改內容（與本地倉庫當前狀態的差異）。

藉助 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 合併請求從基礎提交（base_sha）到本地倉庫當前狀態的差異。

💻 使用示例

基礎用法

1. 獲取失敗作業的控制檯輸出

from mcp_server import get_pipeline_failed_jobs

jobs = get_pipeline_failed_jobs()
for job in jobs:
    print(f"Job Name: {job['name']}")
    print(f"Status: {job['status']}")
    print(f"Log: {job['log']}\n")

2. 獲取 MR 的指摘事項

from mcp_server import get_review_comments

comments = get_review_comments()
for comment in comments:
    print(f"Author: {comment['author']}")
    print(f"Time: {comment['time']}")
    print(f"Content: {comment['content']}\n")

3. 獲取 MR 的變更內容

from mcp_server import get_review_changes

changes = get_review_changes()
for change in changes:
    print(f"File: {change['file']}")
    print(f"Type: {change['type']}")
    print(f"Differences: {change['differences']}\n")

⚠️ 重要提示

• 在上述代碼示例中，請適當替換以下值：
  • your_gitlab_api_key：GitLab API 的訪問令牌。
  • /path/to/git/repo：本地 Git 倉庫的絕對路徑。
  • /path/to/this-mcp-server：此 MCP 服務器目錄的絕對路徑。