Gitlab Code Review

🚀 GitLab MCP 代碼審查

本項目是一個 MCP（模型上下文協議）服務器，旨在將 AI 助手（如Claude）與 GitLab 的合併請求集成，使 AI 助手能借助 GitLab API 直接審查代碼更改。項目從 cayirtepeomer/gerrit-code-review-mcp 叉分而來，並針對 GitLab 集成做了適應性修改。

🚀 快速開始

此項目依賴 Python 3.10+、GitLab 個人訪問令牌（需具備 API 權限，即 read_api 和 api 範圍）以及 Cursor IDE 以實現 MCP 完全集成。以下是具體的安裝步驟：

1. 克隆倉庫：

git clone https://github.com/yourusername/gitlab-mcp.git
cd gitlab-mcp

2. 安裝依賴項： 使用 pip 安裝所需的 Python 包：

pip install -r requirements.txt

3. 配置環境變量 創建一個 .env 文件，並添加以下內容，替換為實際的 GitLab 令牌：

GITLAB_TOKEN=your_gitlab_token_here

4. 運行應用程序： 啟動 MCP 服務器：

python run.py

✨ 主要特性

• 完整的合併請求分析：獲取有關合並請求的完整詳細信息，包括差異、提交和評論
• 特定文件的差異：分析合併請求中特定文件的更改
• 版本比較：比較不同分支、標籤或提交
• 審查管理：添加評論、批准或取消批准合併請求
• 項目概覽：獲取項目中所有合併請求的列表

📦 安裝指南

先決條件

• Python 3.10+
• GitLab 個人訪問令牌（具有 API 權限，即 read_api 和 api 範圍）
• Cursor IDE 實現 MCP 完全集成

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/gitlab-mcp.git
cd gitlab-mcp

2. 安裝依賴項： 使用 pip 安裝所需的 Python 包：

pip install -r requirements.txt

3. 配置環境變量 創建一個 .env 文件，並添加以下內容，替換為實際的 GitLab 令牌：

GITLAB_TOKEN=your_gitlab_token_here

4. 運行應用程序： 啟動 MCP 服務器：

python run.py

💻 使用示例

基礎用法

配置文件示例

# .env 文件示例
GITLAB_TOKEN=your_actual_token
LOG_LEVEL=INFO
API_VERSION=v4

命令行選項

高級用法

查看項目列表

python run.py -t your_token

審查合併請求

python review.py --project-id 123 --merge-request-id 456

📚 詳細文檔

貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 文件瞭解詳細開發流程。

📄 許可證

此項目使用 MIT 許可證，詳情請參閱 LICENSE 文件。