mcp-github-push

Leichter MCP-Server, der Claude (oder anderen MCP-Clients) die Möglichkeit gibt, Projekte direkt auf GitHub zu pushen, ohne git clone/git pull auf deinem Computer. Entwickelt als Alternative zum GitHub-Connector, die weniger Tokens verbraucht und keinen lokalen Speicher füllt.

Es ist ein Terminal-CLI – installiere es über npm, richte das Token einmal ein und registriere es dann bei deinem MCP-Client.

Warum ist das anders als der eingebaute GitHub-Connector?

• Klont das Repo nicht auf die Festplatte. Alle Operationen laufen direkt über die GitHub-REST-/Git-Data-API, sodass kein lokaler Speicher belegt wird.

• Ein Commit für viele Dateien. Nutzt die Git-Data-API (Blob → Tree → Commit → Ref), sodass Änderungen an vielen Dateien in einem sauberen Commit zusammengefasst werden, statt eines Commit-Spams pro Datei.

• Bestätigung vor dem Push erforderlich. Es gibt das Tool github_preview_push, das zuerst aufgerufen werden muss, um eine Zusammenfassung der Änderungen anzuzeigen; github_push_confirmed darf nur aufgerufen werden, nachdem der Benutzer explizit zugestimmt hat.

• Token wird lokal und sicher gespeichert. Konfigurationsdatei mit Berechtigung 600, nur für den besitzenden Benutzer lesbar.

Related MCP server: ship-it-mcp

Installation

Option A – Ohne Node.js (fertige ausführbare Datei)

Du musst Node.js überhaupt nicht installieren. Lade die Binärdatei für dein Betriebssystem von der Releases-Seite herunter:

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

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

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

Führe es vom Terminal aus:

# 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

Registriere dann den vollständigen Pfad zur exe-Datei in der MCP-Client-Konfiguration:

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

Option B – Über npm (benötigt Node.js 18+)

npx @kintil555/mcp-github-push setup

Befolge die Anweisungen:

1. Erstelle einen Personal Access Token (fein abgestuft wird empfohlen) mit dem Bereich Contents: Read and write für das gewünschte Repository.

2. Füge das Token ein, wenn du dazu aufgefordert wirst (die Eingabe wird im Terminal maskiert).

3. Das Token wird automatisch verifiziert und in ~/.config/mcp-github-push/config.json gespeichert.

Bei MCP-Client registrieren

Füge es zur MCP-Client-Konfiguration hinzu (z. B. Claude Desktop claude_desktop_config.json):

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

Starte den Client neu. Die für Claude verfügbaren Tools:

Weitere CLI-Befehle

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

Aus dem Quellcode bauen

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

CI in GitHub Actions erstellt und typprüft automatisch bei jedem Push/PR zu main und veröffentlicht bei neuen Release-Tags auf npm.

Sicherheit

• Das Token wird in ~/.config/mcp-github-push/config.json mit Berechtigung 600 gespeichert.

• Verwende ein fein abgestuftes PAT, das auf bestimmte Repositories beschränkt ist, statt eines klassischen Tokens mit vollem Zugriff.

• Lege eine Ablaufzeit für das Token fest und rotiere es regelmäßig.

• github_push_confirmed ist so konzipiert, dass das KI-Modell nicht ohne den Parameter confirmed: true pushen kann – stelle sicher, dass dein MCP-Client den Tool-Aufruf dem Benutzer vor der Ausführung zur Überprüfung anzeigt.

Lizenz

MIT