Sign inSign up

zereight050/gitlab-mcp

By zereight050

Updated about 8 hours ago

GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more

Image
0

100K+

zereight050/gitlab-mcp repository overview

GitLab MCP Server

Agent-workflow-optimized GitLab MCP server — manage projects, merge requests, issues, pipelines, wiki, releases, tags, milestones, and more from AI clients such as Claude Code, VS Code, Cursor, and Copilot.

  • 232 tools + discover_tools for on-demand activation
  • Personal Access Token, OAuth2, read-only mode, and remote authorization
  • stdio, SSE, and Streamable HTTP transports
  • Works with gitlab.com and self-hosted instances

Quick start

docker pull zereight050/gitlab-mcp:latest

docker run -d --name gitlab-mcp -p 127.0.0.1:3002:3002 \
  -e GITLAB_PERSONAL_ACCESS_TOKEN="<your-token>" \
  -e GITLAB_API_URL="https://gitlab.com/api/v4" \
  -e STREAMABLE_HTTP=true \
  -e HOST=0.0.0.0 \
  zereight050/gitlab-mcp:latest

With Docker Compose, copy the compose file from the repository, set at least GITLAB_PERSONAL_ACCESS_TOKEN, STREAMABLE_HTTP=true, and HOST=0.0.0.0 in your .env (or environment), and run docker compose up -d. Without HOST=0.0.0.0 the server binds to container loopback and the published port stays unreachable.

Environment variables

VariableDefaultDescription
GITLAB_PERSONAL_ACCESS_TOKENGitLab personal access token (required for PAT)
GITLAB_API_URLhttps://gitlab.com/api/v4GitLab API endpoint, self-hosted supported
STREAMABLE_HTTPfalseSet true for Streamable HTTP transport (port 3002)
SSEfalseSet true for legacy SSE transport
HOST127.0.0.1Set 0.0.0.0 inside containers
PORT3002HTTP port for SSE / Streamable HTTP
GITLAB_READ_ONLY_MODEfalseSet true to expose read-only tools
GITLAB_ALLOWED_PROJECT_IDSComma-separated project allowlist
REMOTE_AUTHORIZATIONfalseMulti-user mode, each caller sends its own token

Full list: environment variables.

Tags

  • latest — latest stable release
  • vX.Y.Z — pinned releases, e.g. zereight050/gitlab-mcp:v2.1.59

Tag summary

Content type

Image

Digest

sha256:126398a2d

Size

65.4 MB

Last updated

about 8 hours ago

docker pull zereight050/gitlab-mcp