butterstack-mcp

Ein Model Context Protocol (MCP)-Server für ButterStack: Geben Sie einem KI-Assistenten Lese- und Schreibzugriff auf Ihre Game-Dev-Pipeline, Aufgaben, Builds und Asset-Freigaben.

Keine Laufzeitabhängigkeiten. Nur Node.js-Builtins.

Installation

Fügen Sie dies zur Konfiguration Ihres MCP-Clients hinzu. Keine globale Installation nötig, npx lädt es bei Bedarf:

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"]
    }
  }
}

Claude Desktop

Bearbeiten Sie claude_desktop_config.json (Einstellungen -> Entwickler -> Konfiguration bearbeiten) und fügen Sie den obigen Block unter mcpServers ein. Anschließend starten Sie Claude Desktop neu.

Cursor

Fügen Sie den gleichen Block zu .cursor/mcp.json in Ihrem Projekt oder zu Ihren globalen Cursor-MCP-Einstellungen unter mcpServers hinzu.

Antigravity

Fügen Sie den gleichen Block zur Antigravity-MCP-Konfiguration unter mcpServers hinzu.

Authentifizierung

Setzen Sie BUTTERSTACK_API_TOKEN in der MCP-Server-Umgebung Ihres Clients. Das ist die primäre und empfohlene Authentifizierungsmethode: Sie funktioniert eigenständig, ohne dass irgendetwas anderes installiert sein muss.

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"],
      "env": {
        "BUTTERSTACK_API_TOKEN": "your-token-here"
      }
    }
  }
}

Erzeugen Sie einen Token in den Kontoeinstellungen von ButterStack.

Wenn Sie separat die ButterStack CLI installiert haben und bereits butter auth login ausgeführt haben, übernimmt dieser Server auch die Zugangsdaten, die die CLI auf dem Datenträger gespeichert hat (~/.config/butterstack/credentials.json). Sie müssen einen Token also nicht zweimal konfigurieren. Die CLI ist allerdings keine Abhängigkeit dieses Pakets und muss nicht installiert werden: BUTTERSTACK_API_TOKEN allein genügt.

Host

Standardmäßig kommuniziert der Server mit https://www.butterstack.com. Um ihn auf eine selbst gehostete oder lokale Instanz auszurichten, setzen Sie BUTTERSTACK_HOST:

{
  "env": {
    "BUTTERSTACK_API_TOKEN": "your-token-here",
    "BUTTERSTACK_HOST": "http://localhost:3000"
  }
}

Der Server sendet gespeicherte Zugangsdaten nicht an einen anderen Host als den, für den sie ausgestellt wurden. Wenn der Fehler „Refusing to send the stored credential“ angezeigt wird, setzen Sie BUTTERSTACK_HOST so, dass er mit dem Host übereinstimmt, für den Ihre Zugangsdaten ausgestellt wurden, oder erzeugen Sie neue Zugangsdaten für den Host, auf den Sie zeigen.

Tools

Jedes Tool erwartet eine project_id (außer projects_list), die entweder eine numerische Projekt-ID oder einen Projektnamen akzeptiert.

Prompts

Ressourcen

Anforderungen

Node 18 oder neuer. Das ist eine unterstützte-Version-Richtlinie, keine zwingende technische Untergrenze: Der Server verwendet nur eingebaute Module, die bis Node 10.9.0 kompatibel sind, aber 18 ist die älteste Version, gegen die dieses Paket tatsächlich getestet wird.

Lizenz

MIT