Repolode
Enviar
zereight

zereight/gitlab-mcp

Servidor MCP que oferece aos assistentes de IA ferramentas estruturadas para trabalhar com projetos, merge requests, issues, pipelines, wikis e muito mais no GitLab.

Ver no GitHubSite
Estrelas
2,089
Forks
368
Issues abertas
11
Último commit
ontem

O que é?

gitlab-mcp é um servidor Model Context Protocol que conecta clientes de IA como Claude, Cursor, VS Code e Copilot a uma instância do GitLab. Ele disponibiliza cerca de 280 ferramentas para projetos, merge requests, issues, pipelines, wikis, releases, tags e milestones, com base nas APIs REST e GraphQL do GitLab. Por padrão, apenas um conjunto enxuto de cerca de 40 ferramentas é carregado, e conjuntos adicionais podem ser ativados durante a sessão para manter pequena a lista de ferramentas do modelo.

O servidor funciona via stdio para clientes locais e via Streamable HTTP ou SSE em implantações compartilhadas ou hospedadas. As opções de autenticação incluem um personal access token, um fluxo local de OAuth2 pelo navegador, um proxy MCP OAuth para clientes remotos e o encaminhamento de tokens por requisição em configurações multiusuário. Modos de permissão (readonly, modify, full), filtros de permissão e bloqueio de ferramentas e restrições por grupo ou projeto limitam o que um agente pode alterar.

Para revisar merge requests, um fluxo em duas etapas lista os arquivos alterados e depois busca os diffs em lotes. A filtragem opcional com JMESPath e a compactação dos resultados reduzem respostas grandes. O mesmo binário também oferece uma interface de linha de comando para acessar payloads completos, como diffs e logs de jobs, e funciona tanto com o GitLab.com quanto com instâncias autogerenciadas.

Recursos principais

  • 01Cerca de 280 ferramentas para projetos, merge requests, issues, pipelines, wikis e releases
  • 02Conjunto enxuto de ferramentas por padrão, com ativação sob demanda de ferramentas adicionais
  • 03Transportes por stdio, SSE e Streamable HTTP
  • 04Personal access token, OAuth2 e autorização remota por requisição
  • 05Modos de permissão readonly e modify, com filtros de ferramentas e projetos
  • 06Revisão de merge requests em duas etapas, com busca de diffs em lotes

Casos de uso

  • Pedir a um assistente de programação com IA que revise os arquivos alterados e os diffs de uma merge request
  • Permitir que um agente confira logs de jobs do pipeline ou acione ações de CI no GitLab
  • Compartilhar um endpoint MCP hospedado do GitLab com uma equipe, usando tokens individuais
  • Executar uma integração somente leitura com o GitLab para relatórios ou triagem

Início rápido

  1. 1

    Instale o binário pelo npm

    npm install -g @zereight/mcp-gitlab
  2. 2

    Defina seu token de acesso pessoal do GitLab (o que você digitar não será exibido na tela)

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    Registre o servidor no Claude Code

    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

Antes de usar

  • O conjunto de ferramentas padrão expõe apenas cerca de 40 ferramentas; as demais precisam ser ativadas com discover_tools.
  • O conjunto de ferramentas api é arriscado porque ignora as listas de permissões e as verificações de segurança.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IAServidores MCP

Tópicos

#mcp#gitlab#ai-agent#llm#code-review#devops#model-context-protocol#ai#claude#cursor

Perguntas frequentes

O que é gitlab-mcp?
Servidor MCP que oferece aos assistentes de IA ferramentas estruturadas para trabalhar com projetos, merge requests, issues, pipelines, wikis e muito mais no GitLab. gitlab-mcp é um servidor Model Context Protocol que conecta clientes de IA como Claude, Cursor, VS Code e Copilot a uma instância do GitLab. Ele disponibiliza cerca de 280 ferramentas para projetos, merge requests, issues, pipelines, wikis, releases, tags e milestones, com base nas APIs REST e GraphQL do GitLab. Por padrão, apenas um conjunto enxuto de cerca de 40 ferramentas é carregado, e conjuntos adicionais podem ser ativados durante a sessão para manter pequena a lista de ferramentas do modelo.
gitlab-mcp é gratuito? Qual é a licença?
gitlab-mcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
gitlab-mcp ainda é mantido?
Manutenção ativa. O último commit de gitlab-mcp foi em 6 de nov. de 2026.
Para que posso usar gitlab-mcp?
Pedir a um assistente de programação com IA que revise os arquivos alterados e os diffs de uma merge request Permitir que um agente confira logs de jobs do pipeline ou acione ações de CI no GitLab Compartilhar um endpoint MCP hospedado do GitLab com uma equipe, usando tokens individuais Executar uma integração somente leitura com o GitLab para relatórios ou triagem
Como instalar gitlab-mcp?
Instale o binário pelo npm: npm install -g @zereight/mcp-gitlab Defina seu token de acesso pessoal do GitLab (o que você digitar não será exibido na tela): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Registre o servidor no Claude Code: 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
Onde consigo gitlab-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/zereight/gitlab-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados