git-mcp

Volver al inicio

git-mcp es un servidor de Protocolo de Contexto de Modelo (MCP) 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.

Requisitos previos ​

• 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:

bash

npx @selfagency/git-mcp

Instalación global ​

bash

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

Desde el código fuente ​

bash

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

Conexión a 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

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 a 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)"):

json

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

.vscode/mcp.json del espacio de trabajo ​

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

json

{
  "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:

bash

GIT_REPO_PATH=/home/user/myproject git-mcp

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

bash

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?"

"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 ​

• Referencia de configuración: todas las variables de entorno
• Recursos MCP: datos de solo lectura direccionables por URI
• Referencia de herramientas: documentación completa de parámetros para cada herramienta
• Modelo de seguridad: cómo git-mcp protege contra operaciones destructivas