GitLab MCP Server

GitLab MCP Server (@sumirati/mcp-gitlab)

A robust, developer-ready, and LLM-ergonomic Model Context Protocol (MCP) server for both self-hosted GitLab Community Edition (CE) and GitLab Enterprise Edition (EE).

Mission

MCP-gitlab provides high-signal, LLM-optimized access to GitLab instances. Rather than dumping raw API payloads, it focuses on context efficiency, developer ergonomics, and native AI pair-programming workflows for codebase management, task coordination, CI/CD observability, and release delivery.

Core Pillars & Capabilities

1. Task & Project Planning

• Full Issue Lifecycle: CRUD operations, filtering by state, milestone, label, author, and assignee with clean summaries.
• Smart Milestone Management: Full CRUD with automatic resolution of human-readable milestone_title to internal numeric IDs.
• Task Dependencies (issuelinks): First-class tracking of blocks, isblockedby, and relatesto relationships for AI roadmap planning and dependency graphs.
• Discussions & Progress Tracking (issuenotes)**: Post progress logs, test results, or design rationale directly to issues without modifying descriptions.

2. CI/CD & Test Observability

• Pipelines & Job Inspection: Query pipelines by branch, commit SHA, or execution status (running, failed, success).
• Safe Job Log Tailing (getjobtrace): Safely tail test/build logs (tail_lines) so agents can inspect stack traces directly without token overflow.
• JUnit Test Reports (getpipelinetestreport)**: High-level test suite breakdowns (total, passed, failed, failure messages).

3. Release & Version Delivery

• GitLab Releases API: Create and inspect formal GitLab releases linked to Git tags, milestones, and markdown changelogs.
• Git Tags: List and create semantic version tags (vX.Y.Z).

4. Merge Request Review & Delivery

• Full MR Lifecycle: Create, inspect, update, and accept/merge MRs with branch cleanup and squash options.
• Diff Reviews (getmergerequestchanges): Review code diffs and post review comments (createmergerequestnote).

LLM-First Architectural Principles

• Context Token Economy: Lean response payloads by default returning high-signal summaries instead of thousands of lines of raw GitLab API metadata.
• Smart Auto-Resolution: Transparently resolves paths (e.g. 'group/project-name' vs numeric 31), milestone titles, and label strings/arrays.
• Self-Hosted & CE First: Zero dependencies on GitLab Duo or enterprise licenses; connects over standard v4 REST using a Personal Access Token (PAT).

Quickstart & Installation

Option 1: Run with npx (No installation needed)

npx -y @sumirati/mcp-gitlab

Option 2: Install Globally

npm install -g @sumirati/mcp-gitlab
mcp-gitlab

Option 3: Local Clone

git clone https://github.com/sumirati/mcp-gitlab.git
# Or from GitLab.com:
# git clone https://gitlab.com/sumirati/mcp-gitlab.git

cd mcp-gitlab
npm install
node index.js

Environment Configuration

Configure the following environment variables (or copy .env.example to .env):

Client Configuration

Shortened. The full README is on GitHub.