Git MCP Server

Git MCP Server

Um servidor Model Context Protocol (MCP) para operações Git que fornece funcionalidade Git abrangente para clientes MCP como o Claude Desktop.

Recursos

• Ciente do contexto: Detecta automaticamente o projeto atual com base no diretório de trabalho
• Operações Git abrangentes: status, branches, diffs, logs, conteúdos de arquivos, commits e mais
• Suporte a múltiplos projetos: Funciona perfeitamente em diferentes diretórios de projeto
• Tratamento de erros: Respostas de erro MCP adequadas
• Gerenciamento de branches: Criar, alternar e gerenciar branches
• Operações remotas: Push, pull e fetch de repositórios remotos

Instalação

Opção 1: Instalação Global (Recomendada)

npm install -g git-mcp-server

Opção 2: Configuração de Desenvolvimento Local

1. Clone e instale:

   git clone https://github.com/yourusername/git-mcp-server.git
   cd git-mcp-server
   npm install
   

2. Compile o projeto:

   npm run build
   

Configuração

Claude Desktop

Adicione este servidor ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": []
    }
  }
}

Outros Clientes MCP

Para outros clientes MCP, use o binário do servidor diretamente:

git-mcp-server

O servidor usará automaticamente o diretório de trabalho atual como contexto do repositório Git.

Uso

Após a configuração, você pode usar operações Git através do seu cliente MCP. O servidor detecta automaticamente o repositório Git no seu diretório de trabalho atual.

Exemplos de Comandos

Peça ao seu cliente MCP (como o Claude) para executar operações Git:

• "Qual é o status git atual?"
• "Mostre-me o diff com a branch main"
• "Crie uma nova branch chamada feature/new-feature"
• "Faça commit dessas alterações com a mensagem 'Fix bug in parser'"
• "Envie a branch atual para o origin"

Testando o Servidor

Você pode testar o servidor manualmente a partir de qualquer repositório Git:

cd /path/to/your/git/repo
git-mcp-server

Ferramentas Disponíveis

Informações do Repositório

• git_status - Obter o status git atual
• git_current_branch - Obter o nome da branch atual
• git_staged_changes - Obter alterações em staged
• git_working_directory - Obter informações do diretório de trabalho atual

Operações de Arquivo e Histórico

• git_diff - Mostrar diff entre branches/commits
• git_log - Obter histórico de commits
• git_show_file - Mostrar conteúdo de arquivos em um commit específico

Operações de Branch

• git_branches - Listar todas as branches
• git_checkout - Alternar para uma branch diferente ou criar uma nova branch

Operações de Staging e Commit

• git_add - Adicionar arquivos à área de staging
• git_commit - Criar commits com mensagem e arquivos

Operações Remotas

• git_pull - Puxar alterações do repositório remoto
• git_fetch - Buscar alterações do remoto sem fazer merge

Gerenciamento do Repositório

• git_init - Inicializar um novo repositório git

Pré-requisitos

• Node.js 18+
• npm ou yarn
• Git instalado no seu sistema

Contribuindo

1. Faça um fork do repositório
2. Crie uma branch de funcionalidade
3. Faça suas alterações
4. Adicione testes se aplicável
5. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Estrutura do Projeto

git-mcp-server/
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── src/
│   └── index.ts         # Main server implementation
├── build/
│   └── index.js         # Compiled JavaScript (generated)
└── README.md            # This file

Desenvolvimento

• npm run build - Compilar o código TypeScript
• npm run dev - Modo de observação para desenvolvimento
• npm start - Executar o servidor compilado