mcp-github-push

Servidor MCP ligero que le da a Claude (u otro cliente MCP) la capacidad de hacer push de proyectos directamente a GitHub, sin git clone/git pull en tu ordenador. Creado como una alternativa al conector de GitHub que ahorra tokens y no llena el almacenamiento local.

Tiene forma de CLI de terminal: se instala vía npm, se configura el token una vez y luego se registra en tu cliente MCP.

¿Por qué es diferente del conector de GitHub integrado?

• No clona el repositorio en el disco. Todas las operaciones se hacen directamente a través de la API REST/Git Data de GitHub, así que no ocupa almacenamiento local.

• Un solo commit para muchos archivos. Usa la Git Data API (blob → tree → commit → ref) para que los cambios de varios archivos queden en un solo commit ordenado, en lugar de spam de commits por archivo.

• Confirmación obligatoria antes del push. Existe la herramienta github_preview_push que debe llamarse primero para mostrar un resumen de los cambios; github_push_confirmed solo puede llamarse después de que el usuario apruebe explícitamente.

• Token almacenado localmente, seguro. El archivo de configuración tiene permiso 600, solo puede leerlo el usuario propietario.

Related MCP server: ship-it-mcp

Instalación

Opción A — Sin Node.js (ejecutable listo para usar)

No necesitas instalar Node.js en absoluto. Descarga el binario correspondiente a tu sistema operativo desde la página de Releases:

• Windows: mcp-github-push-win-x64.exe

• Linux: mcp-github-push-linux-x64

• macOS: mcp-github-push-macos-x64

Ejecuta desde la terminal:

# Windows (PowerShell/CMD)
mcp-github-push-win-x64.exe setup

# Linux/macOS
chmod +x mcp-github-push-linux-x64
./mcp-github-push-linux-x64 setup

Luego registra la ruta completa al archivo exe en la configuración del cliente MCP:

{
  "mcpServers": {
    "github-push": {
      "command": "C:\\path\\ke\\mcp-github-push-win-x64.exe",
      "args": ["start"]
    }
  }
}

Opción B — Vía npm (requiere Node.js 18+)

npx @kintil555/mcp-github-push setup

Sigue las instrucciones:

1. Crea un Personal Access Token (se recomienda fine-grained) con el scope Contents: Read and write para el repositorio que quieras usar.

2. Pega el token cuando se te pida (la entrada se oculta en la terminal).

3. El token se verifica automáticamente y se guarda en ~/.config/mcp-github-push/config.json.

Regístrate en el cliente MCP

Añádelo a la configuración de tu cliente MCP (p. ej., Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "github-push": {
      "command": "npx",
      "args": ["-y", "@kintil555/mcp-github-push", "start"]
    }
  }
}

Reinicia el cliente. Las herramientas disponibles para Claude son:

Otros comandos CLI

npx @kintil555/mcp-github-push status   # cek token masih valid
npx @kintil555/mcp-github-push logout   # hapus token tersimpan

Compilar desde el código fuente

git clone https://github.com/kintil555/mcp-github-push.git
cd mcp-github-push
npm install
npm run build

El CI en GitHub Actions compila y verifica tipos automáticamente en cada push/PR a main, y publica en npm cuando se crea una nueva etiqueta de release.

Seguridad

• El token se guarda en ~/.config/mcp-github-push/config.json con permiso 600.

• Usa un PAT fine-grained limitado a repositorios específicos, no un token clásico con acceso completo.

• Establece una fecha de caducidad para el token y rota periódicamente.

• github_push_confirmed está diseñado para que el modelo de IA no pueda hacer push sin el parámetro confirmed: true; asegúrate de que tu cliente MCP también muestre la llamada a la herramienta para que el usuario la revise antes de ejecutarse.

Licencia

MIT