git-mcp

Um servidor MCP Git que não é ruim

Ver em self.agencyExperimente este MCPPatrocinado

Documentação

git-mcp é um servidor Model Context Protocol de nível de produção que dá aos agentes de IA acesso completo a fluxos de trabalho Git. Ele usa simple-git internamente e requer apenas uma instalação Git no sistema — sem outras dependências.

Ele é especialmente útil para agentes de codificação que rodam dentro do GitHub Copilot, Claude Code, Cursor e OpenAI Codex, onde inspeção Git confiável e mutação segura importam mais do que "vibes" e roleta de shell.

Pré-requisitos

  • Node.js 20 ou superior
  • Git instalado e disponível no PATH
  • Um agente de IA ou host de agente de codificação compatível com MCP (Claude Desktop, GitHub Copilot no VS Code, Cursor, OpenAI Codex, etc.)

Instalação

npx (sem necessidade de instalação)

Execute git-mcp sob demanda sem instalar nada globalmente:

npx @selfagency/git-mcp

Instalação global

npm install -g @selfagency/git-mcp
git-mcp

A partir do código-fonte

git clone https://github.com/selfagency/git-mcp.git
cd git-mcp
pnpm install
pnpm build
pnpm start

Conectando ao Claude Desktop

Edite o 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": "npx",
      "args": ["-y", "@selfagency/git-mcp"],
      "env": {
        "GIT_REPO_PATH": "/path/to/your/repo"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar o arquivo. Você deve ver um ícone de martelo na barra de ferramentas do chat indicando que as ferramentas MCP estão disponíveis.

Conectando ao VS Code (GitHub Copilot)

Configurações do usuário

Adicione ao seu settings.json do VS Code (Cmd+Shift+P → "Abrir Configurações do Usuário (JSON)"):

{
  "mcp": {
    "servers": {
      "git": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@selfagency/git-mcp"],
        "env": {
          "GIT_REPO_PATH": "${workspaceFolder}"
        }
      }
    }
  }
}

Workspace.vscode/mcp.json

Para configuração por projeto, crie .vscode/mcp.json na raiz do seu repositório:

{
  "servers": {
    "git": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@selfagency/git-mcp"],
      "env": {
        "GIT_REPO_PATH": "${workspaceFolder}"
      }
    }
  }
}

Definindo um Repositório Padrão

A variável de ambiente GIT_REPO_PATH define o caminho do repositório padrão usado por todas as ferramentas quando repo_path não é fornecido na chamada da ferramenta:

GIT_REPO_PATH=/home/user/myproject git-mcp

Você também pode passá-la pela linha de comando:

npx @selfagency/git-mcp --repo-path /home/user/myproject

Se nenhuma for definida, a IA deve fornecer repo_path explicitamente em cada chamada de ferramenta.

Verificando a Instalação

Pergunte ao seu agente de IA:

"Qual é o status git deste repositório?"

ou

"Mostre-me os últimos 5 commits."

O agente de IA chamará git_status ou git_log e transmitirá os resultados de volta. Se você vir um erro sobre repo_path, defina GIT_REPO_PATH na configuração do servidor.

Próximos Passos