shebang-mcp

Ein MCP-Server und eine CLI zum Hosten von Seiten, Teilen von Dateien, Erstellen von Kurzlinks, Betreiben einer Postgres-Datenbank und Verwalten von API-Schlüsseln – alles über einen einzigen shb_…-Schlüssel für Konten auf shebang.pro.

Schnellstart

Claude Code:

claude mcp add shebang -- npx -y github:New-Kringster/shebang-mcp
npx -y github:New-Kringster/shebang-mcp login

Für jede andere stdio-basierte MCP-Harness fügen Sie diesen Server-Eintrag hinzu:

{
  "mcpServers": {
    "shebang": {
      "command": "npx",
      "args": ["-y", "github:New-Kringster/shebang-mcp"]
    }
  }
}

Führen Sie dann einmal npx -y github:New-Kringster/shebang-mcp login von einem Terminal auf derselben Maschine aus (oder setzen Sie SHEBANG_API_KEY direkt – siehe Umgebungsvariablen).

Die Veröffentlichung im npm-Registry ist geplant, aber noch nicht aktiv – installieren Sie bis dahin über die obige GitHub-Kurzform.

Related MCP server: Modular MCP Server

Der Anmeldeablauf

login startet einen Ablauf zur Geräteautorisierung gegenüber der shebang-Plattform:

1. Die CLI ruft die Plattform auf, erhält einen kurzen Code und eine Verifizierungs-URL und gibt beides aus – anschließend versucht sie, Ihren Browser automatisch mit dieser URL zu öffnen.

2. Im Browser melden Sie sich bei Ihrem shebang.pro-Konto an (falls nicht bereits) und sehen eine Seite, die den Gerätenamen und denselben Code zeigt, den das Terminal ausgegeben hat – prüfen Sie, ob beide übereinstimmen, und klicken Sie dann auf Genehmigen (oder Ablehnen).

3. Die CLI hat währenddessen im Hintergrund gepollt; sobald die Genehmigung erteilt ist, schreibt sie den ausgestellten Schlüssel nach ~/.config/shebang/credentials.json (Modus 0600) und gibt das Präfix des Schlüssels aus.

Von da an erkennt jede Harness auf dieser Maschine, die diesen Server ausführt, den Schlüssel automatisch – keine projektspezifische Konfiguration.

$ npx -y github:New-Kringster/shebang-mcp login

  Confirm this code in your browser:

    x 7 w y 6 x 3 a

  https://dash.shebang.pro/authorize-agent?code=x7wy6x3a

Opening your browser… (if nothing opens, visit the URL above)
Waiting for approval....
Logged in. Key: shb_examplexxxxxxxx… (master)
Saved to ~/.config/shebang/credentials.json

Your agent can now use shebang.

shebang-mcp status zeigt das Präfix und die Stufe des aktuellen Schlüssels; shebang-mcp logout löscht die lokale Zugangsdaten-Datei (er widerruft den Schlüssel nicht – siehe unten).

Schlüsselstufen

• Master – das, was login ausstellt. Volle Autorität über das Konto: jede App, plus Ausstellen und Widerrufen weiterer Schlüssel. Ein Master-Schlüssel pro Anmeldung.

• App – beschränkt auf eine Teilmenge von page, serve, link und base. Erstellen Sie einen solchen Schlüssel für einen Sub-Agenten über das Tool key_create_app, damit er nur die Zugriffe erhält, die er benötigt; der Klartext-Schlüssel wird in der Antwort genau einmal angezeigt.

Ein Schlüssel kann nicht sich selbst widerrufen, während er derjenige ist, der den Aufruf authentifiziert – widerrufen Sie einen Schlüssel also mit einem anderen Schlüssel (normalerweise dem Master-Schlüssel, der ihn ausgestellt hat, über das Tool key_revoke) oder über die Kontoseite des shebang.pro-Dashboards. shebang-mcp logout vergisst den Schlüssel nur lokal; es gibt denselben Hinweis aus.

Tool-Referenz

Seiten (sher page)

Dateien (sherserve)

Kurzlinks (sherlink)

Datenbanken (sherbase)

Schlüssel (nur Master)

OAuth (nur Master)

Umgebungsvariablen

Die Plattform

Der MCP-Server und die CLI in diesem Repository sind nur ein Client – keine Geheimnisse, kein Server-Code, nichts, das direkt mit einer Datenbank spricht. Die Plattform selbst (Konten, Schlüssel, Seiten, Dateien, Links, Datenbanken, OAuth) wird auf shebang.pro betrieben; ein Konto dort ist erforderlich, um diesen Client zu nutzen.

Lizenz

MIT – siehe LICENSE.