gitlab-mcp
GitLab 的 MCP 伺服器:透過 GitLab REST/GraphQL API 提供 288 個工具,用於專案、合併請求、議題、管線、Wiki 等
gitlab-mcp 是什麼?
GitLab 的 MCP 伺服器:透過 GitLab REST/GraphQL API 提供 288 個工具,用於專案、合併請求、議題、管線、Wiki 等
gitlab-mcp 概覽
這是什麼
GitLab MCP Server 是一個 MCP(模型上下文協定)伺服器,透過 GitLab 的 REST 與 GraphQL API 提供操作工具。預設提供 40 個工具(38 個核心工具加上 discover_tools 與 help),總共有 290 個工具。支援 stdio、SSE 與 Streamable HTTP 傳輸方式,可搭配 Claude、Cursor、VS Code、GitHub Copilot 等 MCP 用戶端使用。
主要功能
- 290 個工具涵蓋專案、合併請求、議題、管線、Wiki、發行版、標籤、里程碑等 - 預設 40 個工具以節省 token 預算;呼叫
discover_tools可在當前工作階段啟用更多類別 - 支援多種驗證方式:個人存取權杖(PAT)、OAuth、唯讀模式、遠端授權 - 可動態設定 API URL - 提供 Skill + CLI 路徑,無需註冊 MCP - 提供代理貼上提示,便於在新工作區快速設定
使用情境
- 審查合併請求:使用
list_merge_request_changed_files再批次呼叫get_merge_request_file_diff - 檢查管線工作紀錄:使用
get_pipeline_job_output搭配分頁 - 使用 URL 編碼的project_id與merge_request_iid指定專案與合併請求
快速開始
安裝二進位檔: bash npm install -g @zereight/mcp-gitlab 或透過 Homebrew: bash brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp brew install zereight/gitlab-mcp/zereight-mcp-gitlab 設定 GitLab 個人存取權杖: bash read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN 將 MCP 伺服器加入用戶端(以 Claude Code 為例): bash claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN=$GITLAB_PERSONAL_ACCESS_TOKEN --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab Codex 範例: bash codex mcp add gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN=$GITLAB_PERSONAL_ACCESS_TOKEN --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab 一行指令:npx -y @zereight/mcp-gitlab@latest
授權與價格
授權:MIT。價格:開放原始碼(免費)。
內容整理自該專案公開的 README 與儲存庫資訊。