GitLab MCP Server
GitLab MCP Server — 透過 Model Context Protocol 讓 AI 助手（Claude Code、Cursor 等）直接操作自架 GitLab。
支援 GitLab 14.x+ REST API v4，使用 Personal Access Token 認證。
安裝與部署
前置需求
- Docker
- GitLab Personal Access Token（權限範圍：
api,read_user）- 取得方式：GitLab > User Settings > Access Tokens
Docker 部署
# 1. 建置 image
docker compose build
# 2. 建立 .env 檔案
cp .env.example .env
# 編輯 .env，填入 GITLAB_URL 和 GITLAB_TOKEN
# 3. 啟動服務
docker compose up -d
或直接使用 docker run：
docker run -d --name gitlab-mcp \
-p 8001:8000 \
-e GITLAB_URL=https://your-gitlab.example.com \
-e GITLAB_TOKEN=your_token_here \
-e GITLAB_MCP_TRANSPORT=sse \
--restart unless-stopped \
gitlab-mcp
MCP 客戶端設定
在 Claude Code 或其他 MCP 客戶端中加入：
{
"mcpServers": {
"gitlab": {
"type": "sse",
"url": "http://localhost:8001/sse"
}
}
}
環境變數
| 變數 | 必填 | 預設值 | 說明 |
|---|---|---|---|
GITLAB_URL | Yes | — | GitLab 位址 |
GITLAB_TOKEN | Yes | — | Personal Access Token |
GITLAB_MCP_TRANSPORT | No | stdio | 傳輸模式（stdio / sse） |
GITLAB_MCP_HOST | No | 0.0.0.0 | SSE 監聽位址 |
GITLAB_MCP_PORT | No | 8000 | SSE 監聽端口 |
GITLAB_MCP_LOG_LEVEL | No | INFO | 日誌等級 |
GITLAB_TIMEOUT | No | 30 | API 請求逾時（秒） |
功能列表（30 tools）
管理工具
| Tool | 說明 |
|---|---|
server_info | 取得伺服器資訊與 GitLab 版本 |
health_check | 檢查連線狀態 |
Projects
| Tool | 說明 |
|---|---|
list_projects | 列出可存取的專案（支援搜尋） |
get_project | 取得專案詳情 |
list_project_members | 列出專案成員 |
Merge Requests
| Tool | 說明 |
|---|---|
list_merge_requests | 列出 MR（可依狀態篩選） |
get_merge_request | 取得 MR 詳情 |
create_merge_request | 建立 MR |
update_merge_request | 更新 MR（標題、描述、指派、狀態） |
merge_merge_request | 執行合併 |
approve_merge_request | 核准 MR |
get_merge_request_changes | 取得 MR 檔案變更（diff） |
get_merge_request_commits | 取得 MR 包含的 commits |
list_merge_request_notes | 列出 MR 留言 |
create_merge_request_note | 新增 MR 留言 |
CI/CD Pipelines & Jobs
| Tool | 說明 |
|---|---|
list_pipelines | 列出 Pipelines（可依狀態、分支篩選） |
get_pipeline | 取得 Pipeline 詳情 |
create_pipeline | 觸發新 Pipeline |
retry_pipeline | 重試 Pipeline |
cancel_pipeline | 取消 Pipeline |
list_pipeline_jobs | 列出 Pipeline 的 Jobs |
get_job | 取得 Job 詳情 |
get_job_log | 取得 Job 執行日誌 |
retry_job | 重試單一 Job |
Repository
| Tool | 說明 |
|---|---|
list_branches | 列出分支 |
get_branch | 取得分支詳情 |
list_commits | 列出 Commits |
get_commit | 取得 Commit 詳情 |
compare_branches | 比較兩個分支差異 |
list_repository_tree | 瀏覽檔案結構 |
開發
# 安裝依賴（需要 uv）
uv sync
# 本地啟動（stdio 模式）
uv run gitlab-mcp
# 本地啟動（SSE 模式）
uv run gitlab-mcp --transport sse --port 8001
License
MIT