git-mcp

Un servidor MCP de Git que no apesta

Ver en self.agencyPrueba este MCPPatrocinado

Documentación

git-mcp es un servidor de Model Context Protocol de nivel de producción que brinda a los agentes de IA acceso completo a los flujos de trabajo de Git. Utiliza simple-git internamente y solo requiere una instalación de Git en el sistema, sin otras dependencias.

Es especialmente útil para agentes de codificación que se ejecutan dentro de GitHub Copilot, Claude Code, Cursor y OpenAI Codex, donde la inspección confiable de Git y las mutaciones seguras importan más que las conjeturas y la ruleta de shell.

Prerrequisitos

  • Node.js 20 o posterior
  • Git instalado y disponible en PATH
  • Un agente de IA o host de agente de codificación compatible con MCP (Claude Desktop, GitHub Copilot en VS Code, Cursor, OpenAI Codex, etc.)

Instalación

npx (sin instalación requerida)

Ejecuta git-mcp bajo demanda sin instalar nada globalmente:

npx @selfagency/git-mcp

Instalación global

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

Desde el código fuente

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

Conexión con Claude Desktop

Edita tu archivo de configuración de 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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar el archivo. Deberías ver un ícono de martillo en la barra de herramientas del chat que indica que las herramientas MCP están disponibles.

Conexión con VS Code (GitHub Copilot)

Configuración de usuario

Agrega a tu settings.json de VS Code (Cmd+Shift+P → "Abrir configuración de usuario (JSON)"):

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

Workspace.vscode/mcp.json

Para configuración por proyecto, crea .vscode/mcp.json en la raíz de tu repositorio:

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

Configuración de un Repositorio Predeterminado

La variable de entorno GIT_REPO_PATH establece la ruta del repositorio predeterminado utilizada por todas las herramientas cuando repo_path no se proporciona en la llamada a la herramienta:

GIT_REPO_PATH=/home/user/myproject git-mcp

También puedes pasarla en la línea de comandos:

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

Si no se establece ninguna, la IA debe proporcionar repo_path explícitamente en cada llamada a la herramienta.

Verificación de la Instalación

Pregunta a tu agente de IA:

"¿Cuál es el estado de git de este repositorio?"

o

"Muéstrame los últimos 5 commits."

El agente de IA llamará a git_status o git_log y transmitirá los resultados de vuelta. Si ves un error sobre repo_path, establece GIT_REPO_PATH en la configuración del servidor.

Próximos Pasos