Skip to main content
Glama
snowild

GitLab MCP Server

by snowild
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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

Install Server
A
security – no known vulnerabilities
F
license - not found
B
quality - B tier

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/snowild/gitlab-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server