Gitlab MCP

🚀 GitLab API 文檔

本項目提供了一系列與 GitLab 交互的 API 接口，涵蓋項目管理、組織項目管理、標籤管理等功能，幫助開發者更高效地使用 GitLab 服務。

🚀 快速開始

在使用這些 API 之前，你需要在運行服務器之前設置以下環境變量：

GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token
GITLAB_API_URL=your_gitlab_api_url  # 默認: https://gitlab.com/api/v4
GITLAB_READ_ONLY_MODE=true          # 可選: 啟用只讀模式

✨ 主要特性

• 提供項目列表的獲取和創建接口，方便對項目進行管理。
• 支持組織項目列表的查詢，可按條件篩選項目。
• 具備標籤管理功能，能列出項目的標籤。
• 可通過環境變量配置來靈活使用 API。

📚 詳細文檔

項目列表

獲取單個項目

• 接口：/projects/{project_id}
• 方法：GET
• 參數：
  • include_subgroups：是否包含子組中的項目，默認為false
  • statistics：是否返回項目統計信息，可選值：true 或 false

創建新項目

• 接口：/projects
• 方法：POST
• 請求體：

{
    "name": string,
    "description": string,
    "visibility": string,
    "namespace": string,
    "ssh_url": string,
    "http_url": string,
    "auto_clone": boolean
}

組織項目列表

獲取單個組的項目

• 接口：/groups/{group_id}/projects
• 方法：GET
• 參數：
  • include_subgroups：是否包含子組中的項目，默認為false
  • search：搜索關鍵字，按項目名稱或描述篩選
  • archived：是否包括已存檔的項目，默認為false

標籤管理

列出項目標籤

• 接口：/projects/{project_id}/labels
• 方法：GET
• 參數：
  • with_counts：是否包含標籤的 Issue 和合並請求數量，默認為false
  • include_ancestor_groups：是否包括祖先組中的標籤，默認為false

📄 許可證

本項目採用 MIT License。