bambu-cloud-mcp

あらゆるMCPクライアントからBambu Lab 3Dプリンターを制御 — クラウド経由でどこからでも、さらにLAN上ではライブのチャンバーカメラ映像も取得できます。

MCP（Model Context Protocol）サーバーです。AIアシスタント（Claude Code、Claude Desktop、その他のMCPクライアント）がBambu Labプリンターの監視と操作を行えるようにします。MQTTを介してプリンターと通信し、LAN上またはBambuクラウドブローカー（us.mqtt.bambulab.com / cn.mqtt.bambulab.com）経由のどちらでも動作するため、プリンターをLAN-Onlyモードにしなくても、どこからでもステータス確認と操作が可能です。ステータス、印刷制御、温度、AMS/フィラメント、ファイル、そしてLAN上のライブチャンバーカメラスナップショットをカバーする31のツールを備えています。

他のBambu MCPサーバーと比べて、これが選ばれる理由

多くのコミュニティ製Bambu MCPサーバーはLAN制御のみ、または読み取り専用のクラウドステータスのみに対応しています。このサーバーは、通常それらが提供しない2つのことを行います：

• フルクラウド制御 — すべてのコマンド（一時停止、再開、停止、温度設定、フィラメント交換、生のG-code…）がインターネット経由で動作します。BambuクラウドMQTTブローカーがローカルと同じコマンドトピック（device/<serial>/request）を受け付けるためです。アカウントで一度ログインすれば、バインド済みのプリンターが自動接続されます。

• ライブチャンバーカメラ — get_camera_frame がA1 / A1 Mini / P1P / P1SプリンターからLAN経由で実際のJPEGスナップショットを取得し、MCPクライアントが表示できる画像として返します。

カメラはLAN限定です。 Bambuはクラウドビデオフィードを独自のP2Pシステム（TUTK）でトンネリングしており、オープンに再実装することはできません。そのため、カメラはお使いのマシンがプリンターと同じネットワーク上にある場合にのみ動作します。ステータス確認と制御はどこからでも可能です。

Related MCP server: 3D Printer MCP Server

対応プリンター

• 制御（LAN + クラウド）: A1、A1 Mini、P1P、P1S、X1C、X1E、H2D、およびその他の現行モデル。

• カメラ（LANのみ）: A1、A1 Mini、P1P、P1S（ポート6000のチャンバー画像プロトコル経由）。X1/H2シリーズは代わりにRTSPを使用するため、まだ対応していません — PR歓迎です。

ツール

全31ツールを分野別にまとめました：

クラウド

プリンター管理

ステータス

印刷制御

ハードウェア

AMS / フィラメント

G-code

ファイル（LAN、FTPS）

カメラ（LANのみ）

署名

必要条件

• Node.js 18以上

• クラウド制御の場合: Bambu Labアカウント（プリンターがバインドされているアカウント）。開発者トークンは不要です — メールで送信されるコード、パスワード、または2FAでログインします。

• カメラの場合: プリンターと同じLAN上にマシンがあり、プリンターの設定で**「LAN Mode Liveview」が有効**になっていること。これは完全なLAN-Onlyモードとは独立しているため、Bambu Handyアプリは引き続き動作します。

インストール

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

これによりTypeScriptが dist/ にコンパイルされます。MCPエントリポイントは dist/index.js です。

設定

MCPクライアントにサーバーを登録する

Claude Code（ユーザースコープ — すべてのプロジェクトで利用可能）:

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

Claude Desktop — claude_desktop_config.json に追加:

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

クライアントを再起動（または新しいセッションを開始）して、サーバーを認識させます。

環境変数

すべてオプションです：

クライアントで設定ディレクトリを設定するには、サーバーエントリに env ブロックを追加します：

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

クラウドログイン（リモート制御用）

対話型ログインを自分のターミナルで実行してください（プロンプトを表示する必要があるため、MCPクライアント内では実行できません）：

npm run login

• リージョンを選択（デフォルトはUS）。

• アカウントのメールアドレスを入力。

• 方法1（メールコード） を選択 — パスワードは不要で、ワンタイムコードがメールで送信されます。パスワードとTOTP-2FAにも対応しています。

認証情報は ~/.bambu-mcp/cloud.json（モード 0600）に書き込まれます。パスワードを使用する場合、それはBambuのログインエンドポイントにのみ送信され、保存されることはありません。次回サーバー起動時に、バインド済みのプリンターが自動検出されクラウド経由で接続されます。また、sync_cloud_printers ツールを使っていつでも手動で実行できます。

カメラアクセス（オプション、LANのみ）

カメラを使用するには、各プリンターの8文字のLANアクセスコード（プリンター画面 → Settings → WLAN）が必要です。set_camera_access ツールで一度保存します（またはアシスタントに依頼するだけでもOK）。プリンターのLAN IPはステータスから自動検出されるため、ハードコードする必要はありません。その後、get_camera_frame でライブスナップショットを取得できます。

使い方

サーバーが登録されログインが完了したら、アシスタントに自然言語で指示します。例：

• 「Bambuプリンターの一覧とステータスを表示して。」

• 「P1Sの印刷進捗はどう？」

• 「プリンター mini-1 の印刷を一時停止して。」

• 「X1Cのノズル温度を220°Cに設定して。」

• 「A1のカメラスナップショットを見せて。」

• 「すべてのプリンターで benchy.3mf を開始して。」

• 「フィラメントをアンロードして、次にスロット2をロードして。」

LAN専用プリンターを直接追加する場合（クラウドアカウントなし）：「192.168.1.50 のプリンターをアクセスコード 12345678、シリアル 01P00A123456789 で追加して。」

仕組み

プリンターの mode によって、MQTTクライアントの接続方法が決まります：

• LANモード — ユーザー名 bblp + プリンターのアクセスコードでプリンターのIPに接続。

• クラウドモード — ユーザー名 u_<uid> + アカウントトークンで us.mqtt.bambulab.com（中国では cn.）に接続。

コマンドトピック（device/<serial>/request と /report）は両方で同一であるため、すべての制御ツールはクラウドでもLANでも同じように動作します。ファイル操作はFTPS（basic-ftp）を使用し、チャンバーカメラはプリンターのTLSポート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

すべての認証情報は ~/.bambu-mcp/（cloud.json、cameras.json、printers.json）にローカルに保持され、モード 0600 で書き込まれ、gitの管理対象外です。Bambu自身のAPIとMQTTブローカー以外には何も送信されません。

トラブルシューティング

• クラウドログイン403 — BambuのAPIはCloudflareの背後にあります。少し待って再試行してください。

• sync_cloud_printers が0台のプリンターを返す — バインド済みプリンターのないアカウントにログインしています。Bambu Handyアプリで使用しているアカウントでログインしてください。

• カメラの ECONNREFUSED — そのプリンターで「LAN Mode Liveview」が有効になっていないか、プリンターがオフラインです（IPはステータスから自動検出されます）。

• カメラのタイムアウト — マシンがプリンターと同じネットワーク上にありません。カメラはLAN専用です。

• LANでの connack timeout / ECONNRESET — BambuプリンターはローカルMQTTクライアントを1つしか許可しません。BambuStudio / OrcaSlicer / Home Assistantを閉じて再試行してください。

コントリビューション

コントリビューションを歓迎します — 開発環境のセットアップ、ビルド手順、Conventional Commits規約については CONTRIBUTING.md を参照してください。AIコーディングエージェントを使用している場合は、AGENTS.md にリポジトリ固有のメモがあります。

クレジット

• LAN制御ベース: griches/bambu-mcp — このプロジェクトがフォークして基盤としている、元のMQTT制御レイヤーおよびローカルツールセット。

• クラウド制御、パスワードレスログイン、LANカメラキャプチャ は、このフォークでの独自の追加機能です。

• クラウドプロトコルの詳細は ha-bambulab / pybambu に基づいています；カメラプロトコルは、Bambu Lab フォーラム に文書化されたコミュニティのリバースエンジニアリングに従っています。

ライセンス

MIT。アップストリームのベース（griches/bambu-mcp）は明示的なライセンスを公開していません。このフォークはそれを目立つようにクレジットし、独自の追加部分をMITライセンスで提供します。もしアップストリームの作者で、別の扱いを希望される場合は、issueを開いてください。