Servidor MCP Gitlab | PlugMCP
Saltar al contenido Del publicador
Documentación GitLab MCP Server
A Model Context Protocol (MCP) server for GitLab that enables AI assistants to interact with GitLab APIs in a structured and secure way.
Features
Multiple Transport Support : Stdio, SSE (Server-Sent Events), and Streamable
Secure Operations : Restricted operations to prevent accidental modifications to protected branches
gitlab operator mcp server for AI agent
Conecta cualquier herramienta a cualquier agente. Directorio MCP para quien no escribe servidores.
Producto
Directorio
Desarrolladores
Empresa
Estrellas 1
Herramientas —
Disponibilidad —
GitLab Integration : Full support for common GitLab operations
Docker Support : Easy deployment with Docker
Supported Operations
Read Operations (Always Allowed)
List projects
Get project details
List merge requests
Get merge request details
Get file content
List commits
List pipelines
List issues
Write Operations (With Restrictions)
Create merge request note (comment on MR)
Create merge request (source/target cannot be master/test)
Restricted Operations
Merge code (blocked)
Push to master/test branches (blocked)
Modify configurations (blocked)
Delete operations (blocked)
Installation
From Source git clone https://github.com/yourusername/gitlab-mcp-server.git
cd gitlab-mcp-server
go build -o gitlab-mcp-server ./cmd/server
Using Docker # Build the image
docker build -t gitlab-mcp-server .
# Run with environment variables
docker run -e GITLAB_TOKEN="your-token" \
-e GITLAB_HOST="https://gitlab.com" \
gitlab-mcp-server
Pull from Docker Hub docker pull codyrao/gitlab-mcp-server:latest
docker run -e GITLAB_TOKEN="your-token" \
-e GITLAB_HOST="https://gitlab.com" \
codyrao/gitlab-mcp-server:latest
Configuration
Configuration File (config.yaml) server:
host: "0.0.0.0"
port: 8080
transport: "stdio"
gitlab:
host: "https://gitlab.com"
token: "your-gitlab-token-here"
logging:
level: "info"
Environment Variables
Usage
STDIO Transport (Default) For Claude Desktop or other MCP clients:
{
"mcpServers": {
"gitlab": {
"command": "docker run --rm -i -e GITLAB_TOKEN codyrao/gitlab-mcp-server:latest",
"args": ["-transport", "stdio"]
}
}
}
{
"mcpServers": {
"gitlab": {
"command": "./gitlab-mcp-server",
"args": ["-config", "config.yaml", "-transport", "stdio"]
}
}
}
SSE Transport # Using config file
./gitlab-mcp-server -config config.yaml -transport sse -port 8080
# Using environment variables
docker run -p 8080:8080 \
-e GITLAB_TOKEN="your-token" \
-e GITLAB_MCP_TRANSPORT="sse" \
-e GITLAB_MCP_PORT="8080" \
codyrao/gitlab-mcp-server:latest
Then configure your MCP client to connect to:
SSE: http://localhost:8080/connect
Available Tools
gitlab_list_projects List GitLab projects for the authenticated user.
membership (boolean): Limit to projects where the authenticated user is a member
owned (boolean): Limit to projects owned by the authenticated user
search (string): Search projects by name
per_page (integer): Number of results per page
gitlab_get_project Get details of a GitLab project.
project_id (string): The project ID or path (e.g., 'group/project')
gitlab_list_mrs List merge requests in a GitLab project.
project_id (string): The project ID or path
state (string): Filter by state (opened, closed, merged, all)
per_page (integer): Number of results per page
gitlab_get_mr_details Get detailed information about a merge request.
project_id (string): The project ID or path
mr_iid (integer): The merge request IID
gitlab_create_MR_note Create a comment on a merge request.
project_id (string): The project ID or path
mr_iid (integer): The merge request IID
body (string): The comment text
gitlab_get_file_content Get the content of a file from a GitLab repository.
project_id (string): The project ID or path
file_path (string): Path to the file in the repository
ref (string): The branch, tag, or commit reference
gitlab_list_commits List commits in a GitLab project.
project_id (string): The project ID or path
ref_name (string): The branch or tag name
per_page (integer): Number of results per page
gitlab_list_pipelines List pipelines in a GitLab project.
project_id (string): The project ID or path
per_page (integer): Number of results per page
gitlab_create_mr Create a new merge request. Cannot create MR to or from master/test branches.
project_id (string): The project ID or path
source_branch (string): The source branch name
target_branch (string): The target branch name (cannot be master or test)
title (string): The merge request title
description (string): The merge request description
gitlab_list_issues List issues in a GitLab project.
project_id (string): The project ID or path
state (string): Filter by state (opened, closed, all)
per_page (integer): Number of results per page
Security Restrictions This MCP server implements strict security restrictions to prevent accidental modifications:
Protected Branches : Operations on master, main, test, develop, and release branches are blocked
Merge Operations : Merge requests cannot be merged through this server
Delete Operations : All delete operations are blocked
Configuration Changes : Project settings cannot be modified
Branch Creation : Creating branches with protected names is blocked
GitLab Token Permissions Your GitLab personal access token needs the following permissions:
api: Full API access
read_api: Read API access
read_repository: Read repository access
write_repository: Write repository access (for create MR operations)
Development
Running Locally # Install dependencies
go mod download
# Run the server
go run ./cmd/server -config config.yaml -transport stdio
Building for Docker # Build the image
docker build -t gitlab-mcp-server .
# Push to Docker Hub
docker login -u codyrao
docker tag gitlab-mcp-server codyrao/gitlab-mcp-server:latest
docker push codyrao/gitlab-mcp-server:latest
License
Contributing Contributions are welcome! Please feel free to submit a Pull Request.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas ¿Cómo instalo Gitlab? Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Gitlab necesita una clave de API? Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Gitlab? Gitlab se ejecuta localmente por stdio.
¿Cuándo se comprobó Gitlab por última vez? Última comprobación: 2026-10-28. gitlab operator mcp server for AI agent
Las herramientas tienen descripción 0 de 6