mcp-server-git: Git do MCP para CLIs de IA

Este guia foca no mcp-server-git, que oferece operações de Git para uma CLI compatível. Também separa o que está documentado do que ainda não foi confirmado no Bridgecode.

Na consulta de 4 de novembro de 2026, a página de atividade do repositório mostrava commit mais recente em 28 de outubro.

O release v2.2.0, publicado na mesma data, lista o pacote mcp-server-git na versão 2026.10.28.

O que é o repositório modelcontextprotocol/servers

O projeto mantém implementações de referência de servidores MCP, organizadas por servidor e com documentação e dependências próprias.

O README principal lista exemplos como Git, Filesystem e Fetch. Eles não são uma plataforma de agentes nem um gerenciador de squads.

O mcp-server-git é o componente Python que expõe operações sobre um repositório local. O README documenta consultas de estado e histórico, diferenças entre arquivos e criação de branch.

Também há ações como staging e commit. Assim, o agente recebe ferramentas para atuar no repositório, não apenas uma explicação textual sobre Git.

A documentação do componente Git declara licença MIT.

O arquivo LICENSE na raiz descreve licenciamento em transição para o conjunto.

O arquivo raiz licencia novo código e contribuições à especificação sob Apache-2.0. A documentação, exceto especificações, fica sob CC-BY-4.0; contribuições sem consentimento explícito para relicenciamento permanecem sob MIT.

O avatar pertence à organização oficial do Model Context Protocol e identifica a origem do projeto, não uma certificação de segurança.

Para quem serve o servidor Git do MCP

O mcp-server-git serve a quem usa uma CLI de programação compatível com MCP e quer que o agente consulte ou altere um repositório delimitado, por exemplo para inspecionar diferenças ou preparar mudanças para revisão.

Para aprender a adicionar um servidor a um cliente, veja o guia de configuração de MCP no VS Code.

Para entender a estrutura de um servidor, consulte o tutorial de criação de um MCP server em TypeScript.

O projeto alerta que os servidores são implementações de referência, não soluções prontas para produção sem avaliação.

O servidor Git também é descrito como em desenvolvimento inicial, então a interface e as ferramentas podem mudar. Para automações críticas, revise o código e teste em um clone descartável.

Como instalar o mcp-server-git

O README oficial do servidor Git documenta o uso de uvx.

O comando abaixo segue a forma publicada e restringe o servidor ao repositório informado:

$ uvx mcp-server-git --repository path/to/git/repo

Troque path/to/git/repo pelo caminho do repositório que você quer disponibilizar. Sem --repository, a documentação diz que o servidor pode alcançar outros repositórios Git disponíveis no ambiente.

O servidor resolve um caminho dentro da árvore Git para a raiz do repositório. Apontar para uma subpasta, portanto, não restringe o acesso apenas àquela subpasta.

Por isso, não aponte para sua pasta pessoal ou para uma área que contenha outros projetos e segredos.

O projeto lista o SDK Python do MCP como dependência, na faixa mcp>=2.3,<3. O release do repositório mantém versões próprias para cada pacote.

2026.10.28 é a versão do componente Git no release consultado, não um número universal para todos os servidores do monorepo.

Instalação não testada; os passos foram conferidos no README oficial.

Antes de executar em uma estação com dados importantes, revise a origem, a versão resolvida e as permissões concedidas.

Como usar com CLIs de IA no Bridgecode

O site do Bridgecode descreve a orquestração de agentes e o uso de diferentes CLIs.

Não encontrei instrução pública que confirme o registro automático deste servidor. Trate a integração como manual e condicional.

O Claude Code documenta a inclusão de um servidor local por stdio; o README do mcp-server-git documenta o comando e --repository. A combinação condicional é:

$ claude mcp add --transport stdio git -- uvx mcp-server-git --repository /caminho/absoluto/do/projeto

O comando não foi executado. Ele só se aplica se Claude Code e uvx estiverem disponíveis no ambiente onde a CLI inicia.

Confira a documentação MCP do Claude Code. Não há confirmação de que o Bridgecode propague essa configuração a outros agentes ou worktrees.

Se o ambiente não expuser uvx, o caminho do repositório ou a configuração local ao processo da CLI, a integração não estará pronta. Valide esses pré-requisitos no fluxo usado, sem assumir sincronização automática.

Riscos de segurança do mcp-server-git

O servidor pode ler o repositório e executar ações que alteram seu estado, como staging, commit e reset.

Uma CLI conectada entrega essas ferramentas ao agente. Permita somente as operações necessárias e revise as mudanças antes de confirmar ou publicar alterações.

O guia de segurança do MCP orienta tratar servidores locais e comandos configurados como código executado no ambiente do cliente.

--repository limita o escopo pretendido do servidor, mas não transforma o processo em sandbox do sistema operacional.

O SECURITY.md do repositório define o canal de reporte privado e declara os pacotes em src/ como escopo. Servidores arquivados não recebem correções.

O GitHub lista avisos na página de Security Advisories.

A assessoria GHSA-w766-5x43-whvw foi publicada em 28 de outubro de 2026.

Ela descreve uma falha de confinamento ligada a um .git aninhado e --repository.

O release v2.2.0 do mesmo dia corrige o pacote mcp-server-git na versão 2026.10.28. Use essa versão ou posterior e confira a assessoria antes de implantar.

O mesmo release informa que mcp-server-git não faz chamadas de rede durante a execução. Esse dado se refere ao servidor, não a outros processos da CLI ou à obtenção inicial do pacote.

A página de advisories também lista alertas para Filesystem, Fetch e Everything. Esses avisos não implicam vulnerabilidade no mcp-server-git; cada pacote tem superfície própria, e a ausência de alerta não comprova segurança.

Esta verificação cobriu os READMEs, licença, atividade, release, política e avisos de segurança publicados no GitHub.

Não foi feita auditoria completa do código, das dependências transitivas ou da configuração da máquina. Também não foram instalados nem executados pacotes, comandos ou scripts do projeto.