Gitlab MCP

🚀 GitLab MCP 服務器

GitLab MCP 服務器是用於與 GitLab 進行交互的工具，可實現倉庫管理、分支操作、文件操作等功能，為開發者提供便捷的 GitLab 管理體驗。

🚀 快速開始

安裝

使用 uv

git clone https://gitlab.com/gitlab-org/mcp.git
cd mcp
uv app:start

使用 pip

pip install gitlab-mcp
mcp-server run

配置

環境變量

• GITLAB_API_URL: GitLab 實例的 URL，默認為 https://gitlab.com。
• GITLAB_PRIVATE_TOKEN: 用於身份驗證的私人訪問令牌。

MCP 配置文件

development:
  enable: true
  features:
    file_operations: true
    issue_management: true

📦 安裝指南

使用 uv

通過 uv 可以快速克隆項目並啟動應用。

git clone https://gitlab.com/gitlab-org/mcp.git
cd mcp
uv app:start

使用 pip

使用 pip 可以直接安裝 gitlab-mcp 並啟動服務。

pip install gitlab-mcp
mcp-server run

📚 詳細文檔

項目結構

src/
├── api/           # API交互層
│   ├── controllers/      # 控制器邏輯
│   └── models/         # 數據模型定義
├── core/          # 核心業務邏輯
│   ├── commands/       # 業務命令處理
│   └── validators/     # 數據驗證規則
└── infra/         # 基礎設施配置
    ├── config/        # 應用配置文件
    └── dependencies/  # 第三方依賴管理

工具

倉庫管理

• create_repository: 創建新存儲庫。
• delete_repository: 刪除現有存儲庫。

分支操作

• list_branches: 列出所有分支。
• create_branch: 創建新分支。
• delete_branch: 刪除指定分支。

文件操作

• upload_file: 上傳文件到存儲庫。
• download_file: 下載指定文件。
• update_file_contents: 更新現有文件內容。
• delete_file: 刪除指定文件。

🔧 技術細節

故障排除

常見問題

• 身份驗證錯誤: 確保 GITLAB_PRIVATE_TOKEN 有效且具有正確權限。
• 服務未啟動: 檢查安裝日誌或重新運行安裝命令。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參閱 LICENSE 文件。