O que é Git (reference server)?
O servidor Git é um servidor de referência em Python mantido pelo projeto MCP. Em outubro de 2026, ele continua sendo um dos sete servidores do repositório principal modelcontextprotocol/servers; não estava entre os servidores de referência aposentados e movidos para o repositório arquivado servers-archived. Ele é mantido ativamente: a versão 2026.10.19 no PyPI o reconstruiu sobre o Python SDK 2.x, e agora ele fala as revisões de protocolo 2025-11-25 e 2026-07-28.
Ele expõe 12 ferramentas: git_status, git_diff_unstaged, git_diff_staged, git_diff, git_commit, git_add, git_reset, git_log, git_create_branch, git_checkout, git_show e git_branch. Não há git_init; um aviso de dezembro de 2025 mostrou que o antigo podia criar repositórios em qualquer lugar do disco.
Você o executa com uvx mcp-server-git --repository path/to/repo, com pip ou com a imagem Docker mcp/git. Ele só funciona com repositórios locais; não tem ferramentas de rede e não fala com o GitHub nem com nenhum outro host.
Como instalar Git (reference server)
uvx mcp-server-git --repository path/to/repoGit (reference server) vale a pena?
Este servidor justifica seu lugar em uma situação: um cliente como o Claude Desktop, que não consegue executar comandos de shell, mas deveria poder ler diffs e fazer commits. Ali ele faz o trabalho com entradas tipadas e saída em texto simples, e uma chamada com falha devolve uma mensagem de erro que o modelo consegue ler e corrigir. No Claude Code, no Cursor ou em qualquer agente com terminal, ele duplica o próprio git com menos opções.
O escopo termina na árvore de trabalho local. Não há push, pull, fetch, merge, rebase nem stash, então o modelo pode preparar e commitar o trabalho, mas uma pessoa ainda o publica, o que algumas equipes vão considerar um recurso de segurança. O README ainda chama o servidor de desenvolvimento inicial e avisa que as ferramentas podem mudar, e mudaram: a reconstrução de outubro de 2026 alterou como nomes de ferramenta desconhecidos são reportados e fez as chamadas de ferramentas rodarem uma de cada vez.
Seu histórico de segurança recomenda manter-se atualizado. Quatro avisos foram publicados contra o mcp-server-git: três problemas de severidade média em dezembro de 2025, cobrindo injeção de argumentos em git_diff e git_checkout, falta de validação de caminho para --repository e a ferramenta git_init sem restrições, e uma travessia de caminho no git_add em fevereiro de 2026 que podia preparar arquivos fora do repositório. Cada um saiu com correção, e os releases de outubro também exigem GitPython 3.1.60 ou posterior por causa de avisos upstream.
O escopo é mais grosseiro do que a flag sugere. O --repository sobe até a raiz do repositório, então apontá-lo para uma subpasta concede o repositório inteiro, e sem a flag cada chamada pode indicar qualquer repo_path da máquina. O git_reset só tira arquivos do stage, mas o git_checkout pode trocar de branch debaixo de um editor com trabalho não salvo, e o servidor não pede confirmação; isso fica a cargo dos prompts de aprovação do cliente. O que o modelo lê aqui é o seu próprio histórico e os seus arquivos, uma superfície de injeção de prompt muito menor do que a de um servidor que busca páginas da web.
Onde ele se destaca
Uma gerente de produto editando um repositório de documentação pelo Claude Desktop
Ver o que mudou desde a semana passada e fazer commit de uma correção de texto
git_log com start_timestamp definido como '1 week ago', git_diff contra a main, depois git_add e git_commit. Gratuito; o principal risco é fazer commit no branch errado, então mantenha os prompts de aprovação ligados para escritas.
Uma equipe de plataforma criando um agente interno de revisão de código sem acesso a shell
Deixar o agente ler diffs e histórico de um repositório clonado e nada mais
Rode a imagem Docker mcp/git com só esse repositório montado e permita no cliente apenas as ferramentas de leitura (status, diff, log, show, branch). Isso evita ter de isolar um shell, e o push fica com o CI.
Antes de decidir
- Configuração
- uvx mcp-server-git --repository /path/to/repo, pip install mcp-server-git ou a imagem Docker mcp/git com o repositório montado via bind mount. O README tem configurações para Claude Desktop, VS Code, Zed e Zencoder; as ferramentas aparecem quando o cliente é reiniciado.
- Integrações
- 12 ferramentas. Leitura: git_status, git_diff_unstaged, git_diff_staged, git_diff, git_log, git_show, git_branch. Escrita: git_add, git_commit, git_reset (só tira do stage), git_create_branch, git_checkout.
- Dados e privacidade
- Roda localmente com as permissões de arquivo do seu usuário e não faz chamadas de rede, mas os diffs e o conteúdo de arquivos que ele devolve vão para o provedor de modelo que o seu cliente usar. Quatro avisos entre dezembro de 2025 e fevereiro de 2026 cobriram injeção de argumentos, travessia de caminho e caminhos de repositório não validados.
- Custo em escala
- Gratuito e de código aberto. O custo é o contexto: git_diff e git_show devolvem o texto completo, então um diff grande cai inteiro na janela de contexto; context_lines e max_count são os únicos controles de tamanho.
- Limites
- Sem operações remotas nem ferramentas de stash, merge, blame ou tag; só stdio, então não pode ser compartilhado como servidor remoto; as chamadas de ferramentas são serializadas, então chamadas paralelas entram em fila.
O que é bom
- 12 ferramentas tipadas para status, diffs, commits, branches e log
- Não faz chamadas de rede próprias
- Mantido ativamente; suporta as versões de protocolo 2025-11-25 e 2026-07-28
- Os avisos publicados foram corrigidos rapidamente
O que não é
- Sem push, pull, merge, rebase nem stash
- O --repository abrange o repositório inteiro, e omiti-lo permite qualquer caminho
- Ainda rotulado como desenvolvimento inicial; o comportamento mudou entre releases
- Redundante para agentes com terminal
Ideal para
Quem usa clientes MCP no estilo chat e quer que o modelo inspecione e faça commit de mudanças locais sem acesso a shell.
Alternativas ao Git (reference server)
Git (reference server): perguntas frequentes
- Git (reference server) vale a pena?
- Um jeito organizado e bem corrigido de dar Git a um cliente de chat sem shell, embora qualquer agente com terminal já tenha um melhor. Damos nota 3.8 de 5.
- Quanto custa Git (reference server)?
- Gratuito e de código aberto.
- Quais são as desvantagens de Git (reference server)?
- Sem push, pull, merge, rebase nem stash; o --repository abrange o repositório inteiro, e omiti-lo permite qualquer caminho; ainda rotulado como desenvolvimento inicial; o comportamento mudou entre releases; redundante para agentes com terminal.
- Para quem Git (reference server) é indicado?
- Quem usa clientes MCP no estilo chat e quer que o modelo inspecione e faça commit de mudanças locais sem acesso a shell.
- Quanto custa Git (reference server) para uma equipe ou em produção?
- Gratuito e de código aberto. O custo é o contexto: git_diff e git_show devolvem o texto completo, então um diff grande cai inteiro na janela de contexto; context_lines e max_count são os únicos controles de tamanho.
- Git (reference server) é seguro para dados da empresa?
- Roda localmente com as permissões de arquivo do seu usuário e não faz chamadas de rede, mas os diffs e o conteúdo de arquivos que ele devolve vão para o provedor de modelo que o seu cliente usar. Quatro avisos entre dezembro de 2025 e fevereiro de 2026 cobriram injeção de argumentos, travessia de caminho e caminhos de repositório não validados.
- Quais são as melhores alternativas ao Git (reference server)?
- As alternativas mais próximas que analisamos são GitHub MCP Server e Filesystem (reference server).
Respostas verificadas em 23 de out. de 2026.