bambu-cloud-mcp

Steuern Sie Ihre Bambu-Lab-3D-Drucker von jedem MCP-Client aus — über die Cloud, von überall, mit Live-Bildern der Innenraumkamera in Ihrem LAN.

Ein MCP (Model Context Protocol)-Server, der es einem KI-Assistenten — Claude Code, Claude Desktop oder einem beliebigen MCP-Client — ermöglicht, Bambu-Lab-Drucker zu überwachen und zu steuern. Er kommuniziert mit den Druckern über MQTT, entweder in Ihrem LAN oder über den Bambu-Cloud-Broker (us.mqtt.bambulab.com / cn.mqtt.bambulab.com), sodass Status und Steuerung von überall funktionieren, ohne den Drucker in den LAN-Only-Modus zu versetzen. Er bietet 31 Tools für Status, Drucksteuerung, Temperaturen, AMS/Filament, Dateien und einen Live-Schnappschuss der LAN-Innenraumkamera.

Warum dieses Projekt gegenüber anderen Bambu-MCP-Servern

Die meisten Community-Bambu-MCP-Server bieten nur LAN-Steuerung oder schreibgeschützten Cloud-Status. Dieser hier kann zwei Dinge, die sie normalerweise nicht können:

• Volle Cloud-Steuerung — jeder Befehl (Pause, Fortsetzen, Stopp, Temperatur setzen, Filament wechseln, roher G-Code …) funktioniert über das Internet, weil der Bambu-Cloud-MQTT-Broker dieselben Command-Topics (device/<serial>/request) akzeptiert wie der lokale. Melden Sie sich einmal mit Ihrem Konto an, und Ihre gebundenen Drucker verbinden sich automatisch.

• Live-Innenraumkamera — get_camera_frame holt einen echten JPEG-Schnappschuss von A1 / A1 Mini / P1P / P1S-Druckern über das LAN und gibt ihn als Bild zurück, das Ihr MCP-Client anzeigen kann.

Die Kamera funktioniert nur im LAN. Bambu leitet den Cloud-Videostream über ein proprietäres P2P-System (TUTK), das nicht offen nachimplementiert werden kann. Die Kamera funktioniert daher nur, wenn sich Ihr Rechner im selben Netzwerk wie der Drucker befindet. Status und Steuerung funktionieren von überall.

Related MCP server: 3D Printer MCP Server

Unterstützte Drucker

• Steuerung (LAN + Cloud): A1, A1 Mini, P1P, P1S, X1C, X1E, H2D und andere aktuelle Modelle.

• Kamera (nur LAN): A1, A1 Mini, P1P, P1S über das Innenraumkamera-Bildprotokoll auf Port 6000. Die X1/H2-Serie verwendet stattdessen RTSP und ist noch nicht angebunden — PRs willkommen.

Tools

Alle 31 Tools, gruppiert nach Bereich:

Cloud

Druckerverwaltung

Status

Drucksteuerung

Hardware

AMS / Filament

G-Code

Dateien (LAN, FTPS)

Kamera (nur LAN)

Signieren

Voraussetzungen

• Node.js 18+

• Für die Cloud-Steuerung: ein Bambu-Lab-Konto (das, an das Ihre Drucker gebunden sind). Kein Entwickler-Token erforderlich — Sie melden sich mit einem per E-Mail gesendeten Code, einem Passwort oder 2FA an.

• Für die Kamera: Ihr Rechner im selben LAN wie der Drucker, mit auf dem Drucker aktiviertem „LAN Mode Liveview" (Einstellungen). Dies ist unabhängig vom vollständigen LAN-Only-Modus, sodass die Bambu-Handy-App weiterhin funktioniert.

Installation

git clone https://github.com/dylansantwani/bambu-cloud-mcp.git
cd bambu-cloud-mcp
npm install
npm run build

Dies kompiliert TypeScript nach dist/. Der MCP-Einstiegspunkt ist dist/index.js.

Konfiguration

Den Server bei Ihrem MCP-Client registrieren

Claude Code (Benutzerbereich — in jedem Projekt verfügbar):

claude mcp add bambu -s user -- node /absolute/path/to/bambu-cloud-mcp/dist/index.js

Claude Desktop — fügen Sie es zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "bambu": {
      "command": "node",
      "args": ["/absolute/path/to/bambu-cloud-mcp/dist/index.js"]
    }
  }
}

Starten Sie den Client neu (oder beginnen Sie eine neue Sitzung), damit er den Server erkennt.

Umgebungsvariablen

Alle sind optional:

Um das Konfigurationsverzeichnis in einem Client festzulegen, fügen Sie dem Servereintrag einen env-Block hinzu:

{
  "mcpServers": {
    "bambu": {
      "command": "node",
      "args": ["/absolute/path/to/bambu-cloud-mcp/dist/index.js"],
      "env": {
        "BAMBU_MCP_CONFIG_DIR": "/absolute/path/to/config"
      }
    }
  }
}

Cloud-Anmeldung (für Fernsteuerung)

Führen Sie die interaktive Anmeldung in Ihrem eigenen Terminal aus (sie muss Sie zur Eingabe auffordern und kann daher nicht innerhalb des MCP-Clients ausgeführt werden):

npm run login

• Wählen Sie Ihre Region (Standard: US).

• Geben Sie Ihre Konto-E-Mail ein.

• Wählen Sie Methode 1 (E-Mail-Code) — kein Passwort erforderlich; Sie erhalten einen Einmalcode per E-Mail. Passwort und TOTP-2FA werden ebenfalls unterstützt.

Die Anmeldedaten werden in ~/.bambu-mcp/cloud.json geschrieben (Modus 0600). Ihr Passwort wird, falls Sie eines verwenden, ausschließlich an den Anmelde-Endpunkt von Bambu gesendet — niemals gespeichert. Beim nächsten Serverstart werden Ihre gebundenen Drucker automatisch erkannt und über die Cloud verbunden; Sie können dies jederzeit auch mit dem Tool sync_cloud_printers auslösen.

Kamera-Zugriff (optional, nur LAN)

Die Kamera benötigt den 8-stelligen LAN-Zugangscode jedes Druckers (Druckerbildschirm → Einstellungen → WLAN). Speichern Sie ihn einmal über das Tool set_camera_access (oder bitten Sie einfach Ihren Assistenten darum). Die LAN-IP des Druckers wird automatisch aus seinem Status ermittelt, sodass Sie sie nicht fest codieren müssen. Danach liefert get_camera_frame einen Live-Schnappschuss.

Verwendung

Sobald der Server registriert ist und Sie sich angemeldet haben, sprechen Sie in normaler Sprache mit Ihrem Assistenten. Beispiele:

• „Liste meine Bambu-Drucker auf und zeige ihren Status."

• „Wie ist der Fortschritt des Drucks auf meinem P1S?"

• „Pausiere den Druck auf Drucker mini-1."

• „Setze die Düsentemperatur an meinem X1C auf 220°C."

• „Zeig mir einen Kamera-Schnappschuss vom A1."

• „Starte benchy.3mf auf allen meinen Druckern."

• „Entlade das Filament und lade dann Fach 2."

Um einen Nur-LAN-Drucker direkt hinzuzufügen (ohne Cloud-Konto): „Füge einen Drucker unter 192.168.1.50 mit Zugangscode 12345678 und Seriennummer 01P00A123456789 hinzu."

So funktioniert es

Der mode eines Druckers entscheidet, wie sich sein MQTT-Client verbindet:

• LAN-Modus verbindet sich mit der IP des Druckers mit Benutzername bblp + dem Zugangscode des Druckers.

• Cloud-Modus verbindet sich mit us.mqtt.bambulab.com (oder cn. für China) mit Benutzername u_<uid> + Ihrem Kontotoken.

Die Command-Topics (device/<serial>/request und /report) sind in beiden Fällen identisch, weshalb jedes Steuerungstool über die Cloud genauso funktioniert wie im LAN. Dateioperationen verwenden FTPS (basic-ftp), und die Innenraumkamera spricht direkt das TLS-Bildprotokoll des Druckers auf Port 6000 (camera-client.ts).

src/
  index.ts            MCP server entry; registers tools, auto-connects on startup
  fleet-manager.ts    Multi-printer connection manager (LAN + cloud branches)
  mqtt-client.ts      Bambu MQTT protocol (status + all control commands)
  bambu-cloud.ts      Cloud API: login, email-code/2FA, device discovery, refresh
  cloud-store.ts      ~/.bambu-mcp/cloud.json credential store
  login-cli.ts        Interactive `npm run login`
  camera-client.ts    LAN chamber-image capture (TLS port 6000 → JPEG)
  camera-store.ts     ~/.bambu-mcp/cameras.json access-code store
  ftp-client.ts       FTPS file operations
  tools/              One file per tool group

Alle Anmeldedaten bleiben lokal in ~/.bambu-mcp/ (cloud.json, cameras.json, printers.json), werden mit 0600 geschrieben und sind git-ignoriert. Es wird nichts irgendwohin gesendet, außer an die eigene API von Bambu und den MQTT-Broker.

Fehlerbehebung

• Cloud-Anmeldung 403 — die API von Bambu liegt hinter Cloudflare; warten Sie einen Moment und versuchen Sie es erneut.

• sync_cloud_printers liefert 0 Drucker — Sie sind mit einem Konto angemeldet, das keine gebundenen Drucker hat. Melden Sie sich mit dem Konto an, das Ihre Bambu-Handy-App verwendet.

• Kamera ECONNREFUSED — „LAN Mode Liveview" ist auf diesem Drucker nicht aktiviert, oder der Drucker ist offline (die IP wird automatisch aus dem Status ermittelt).

• Kamera-Timeout — Ihr Rechner befindet sich nicht im selben Netzwerk wie der Drucker. Die Kamera funktioniert nur im LAN.

• connack timeout / ECONNRESET im LAN — ein Bambu-Drucker erlaubt nur einen lokalen MQTT-Client; schließen Sie BambuStudio / OrcaSlicer / Home Assistant und versuchen Sie es erneut.

Mitwirken

Beiträge sind willkommen — siehe CONTRIBUTING.md für Entwicklungseinrichtung, Build-Schritte und die Conventional-Commit-Konvention. Wenn Sie einen KI-Codierungsagenten verwenden, enthält AGENTS.md repospezifische Hinweise.

Danksagungen

• LAN-Steuerungsbasis: griches/bambu-mcp — die ursprüngliche MQTT-Steuerungsebene und das lokale Werkzeugset, von dem dieses Projekt abzweigt und auf dem es aufbaut.

• Cloud-Steuerung, passwortloser Login und LAN-Kameraaufnahme sind originäre Ergänzungen in diesem Fork.

• Cloud-Protokolldetails basieren auf ha-bambulab / pybambu; das Kameraprotokoll folgt dem Community-Reverse-Engineering, das in den Bambu-Lab-Foren dokumentiert ist.

Lizenz

MIT. Die Upstream-Basis (griches/bambu-mcp) veröffentlicht keine explizite Lizenz; dieser Fork weist sie prominent aus und lizenziert die originären Ergänzungen unter MIT. Wenn Sie der Upstream-Autor sind und eine andere Handhabung wünschen, eröffnen Sie bitte ein Issue.