mcp-gitlabpr

Servidor MCP para merge requests do GitLab (o "PR" do GitLab): listar, obter (com diffs) e criar. Usa a API REST v4 com personal access token e só os parâmetros que já existem na GitLab CE 10.8 (doc da 10.8.7), então também funciona em versões mais novas.

Credenciais

Para usar outro caminho, defina a variável de ambiente MCP_GITLABPR_CONFIG.

[DEFAULT]
url = https://gitlab.SEU-SERVIDOR
token = SEU_PERSONAL_ACCESS_TOKEN

O token sai de Settings → Access Tokens com o escopo api e vai no header PRIVATE-TOKEN.

Certificados: o MCP confia nas CAs da máquina e, se existir, em gitlabpr-bundle.pem na mesma pasta do gitlabpr.properties (cadeia PEM do servidor). REQUESTS_CA_BUNDLE também funciona.

Instalação

{
  "mcpServers": {
    "gitlabpr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-gitlabpr@latest"],
      "env": { "UV_SYSTEM_CERTS": "true" }
    }
  }
}

Desenvolvimento:

uv sync
uv run pytest
uv run mcp dev mcp_gitlabpr/server.py   # MCP Inspector

Tools

projeto é o caminho grupo/projeto (o MCP faz o URL-encode) ou o id numérico. Sem projeto, ele vem do remote do git da pasta em que o MCP roda (origin, ou o primeiro remote; aceita https://, ssh:// e git@host:), e origem vem da branch atual. Fora de um repositório git a tool falha pedindo que o agente pergunte ao usuário. O cliente MCP precisa iniciar o servidor na pasta do workspace; se não iniciar, informe projeto. iid é o número do MR no projeto (o !123 da tela). Autor e responsável são usernames: o MCP os converte em id por GET /users?username=, porque a 10.8 só filtra por author_id/assignee_id.

estado aceita opened, closed, merged ou all.