bambu-printer-mcp 1.1.2 → 1.1.4

package/README.md

@@ -11,7 +11,7 @@ A Bambu Lab-focused MCP server for controlling Bambu printers, manipulating STL
 
 This is a stripped-down, Bambu-only fork of [mcp-3D-printer-server](https://github.com/DMontgomery40/mcp-3D-printer-server). All OctoPrint, Klipper, Duet, Repetier, Prusa Connect, and Creality Cloud support has been removed. What remains is a focused, lean implementation for Bambu Lab hardware.
 
-Local handoff note: see [REMOTE-DEPLOYMENT.md](./REMOTE-DEPLOYMENT.md) for the custom H2D/H2S patches, per-printer MCP split, and remote deployment plan used in this clone.
+Local handoff note: see [REMOTE-DEPLOYMENT.md](./REMOTE-DEPLOYMENT.md) for the custom H2D/H2S/H2C patches, per-printer MCP split, and remote deployment plan used in this clone.
 
 ---
 
@@ -29,7 +29,7 @@ This fork adds a substantial set of printer control tools beyond the upstream `m
 - **Skip objects** (`skip_objects`) — skip specific object IDs during a running multi-object print. IDs from `list_3mf_plate_objects`.
 - **HMS diagnostics** (`printer://{host}/hms` MCP resource) — read-only error summary with automatic settle retry.
 - **Utility controls** — `set_print_speed` (silent/standard/sport/ludicrous), `clear_hms_errors`, `reread_ams_rfid`, `set_airduct_mode` (cooling/heating for H2/P2).
-- **H2/H2D-safe print path** — correct `project_file` format with `ams_mapping2` parallel array, H2 firmware quirks handled.
+- **H2-family-safe print path** — correct `project_file` format with `ams_mapping2` parallel array, H2 firmware quirks handled.
 - **BambuStudio CLI auto-flatten** (`BAMBU_CLI_FLATTEN=true`) — works around upstream profile inheritance bugs.
 - **Print collar charm** (`print_collar_charm`) — specialized two-color wrapper with fixed tray policy.
 
@@ -100,8 +100,8 @@ This fork adds a substantial set of printer control tools beyond the upstream `m
 - List, upload, and delete files on the printer's SD card via FTPS
 - Capture a JPEG snapshot from the chamber camera. Supports A1, A1 mini, P1S, P1P (TCP-on-6000), and X1, X1C, X1E, P2S, H2, H2S, H2D, H2C, H2D Pro (RTSP via ffmpeg). Requires ffmpeg in PATH for the RTSP path.
 - Upload and print pre-sliced `.gcode.3mf` files with full plate selection and calibration flag control (recommended path — see [docs/SLICING.md](./docs/SLICING.md))
-- Optional single-color auto-slice path via BambuStudio CLI. Set `BAMBU_CLI_FLATTEN=true` to enable a workaround that flattens BBL profile inheritance before invoking the CLI — works around upstream bugs in BambuStudio CLI mode ([#9636](https://github.com/bambulab/BambuStudio/issues/9636), [#9968](https://github.com/bambulab/BambuStudio/issues/9968)). Single-color smoke is verified on H2S/H2D/X1C/P1S. H2D two-color CLI slicing is blocked upstream ([#10408](https://github.com/bambulab/BambuStudio/issues/10408)); use a GUI-sliced `.gcode.3mf` for that workflow. Default off; Path A (GUI-slice) remains the recommended workflow for non-BBL profiles, multi-color H2D jobs, or first-time prints. See [docs/SLICING.md](./docs/SLICING.md).
-- Parse AMS mapping from the 3MF's embedded slicer metadata (`Metadata/plate_<n>.json` + gcode filament header) and send it correctly formatted per the OpenBambuAPI spec, with correct H2S/H2D `ams_mapping2` parallel array format
+- Optional single-color auto-slice path via BambuStudio CLI. Set `BAMBU_CLI_FLATTEN=true` to enable a workaround that flattens BBL profile inheritance before invoking the CLI — works around upstream bugs in BambuStudio CLI mode ([#9636](https://github.com/bambulab/BambuStudio/issues/9636), [#9968](https://github.com/bambulab/BambuStudio/issues/9968)). Single-color smoke is verified on H2S/H2D/X1C/P1S; H2C requires Bambu Studio 2.4.0 or newer and should use `BAMBU_MODEL=h2c`, not an H2D fallback. H2D two-color CLI slicing is blocked upstream ([#10408](https://github.com/bambulab/BambuStudio/issues/10408)); use a GUI-sliced `.gcode.3mf` for that workflow. Default off; Path A (GUI-slice) remains the recommended workflow for non-BBL profiles, multi-color H2 jobs, or first-time prints. See [docs/SLICING.md](./docs/SLICING.md).
+- Parse AMS mapping from the 3MF's embedded slicer metadata (`Metadata/plate_<n>.json` + gcode filament header) and send it correctly formatted per the OpenBambuAPI spec, with correct H2S/H2D/H2C `ams_mapping2` parallel array format
 - **Auto-match AMS slots by RFID** (`auto_match_ams` flag on `print_3mf`). Resolves required `tray_info_idx` from the sliced 3MF against live AMS inventory. Handles same-SKU different-color filaments by matching on `(tray_info_idx, tray_color)` and tracking already-claimed slots. Dry-run with `resolve_3mf_ams_slots` before printing.
 - Cancel, pause, and resume in-progress print jobs via MQTT
 - Skip specific objects during a running multi-object print via `skip_objects` (use `list_3mf_plate_objects` to find object IDs first)
@@ -178,7 +178,7 @@ BAMBU_TOKEN=your_access_token     # LAN access token from printer touchscreen
 # BAMBU_PRINTER_HOST / BAMBU_PRINTER_SERIAL / BAMBU_PRINTER_ACCESS_TOKEN
 
 # --- Printer model (CRITICAL for safe operation) ---
-BAMBU_MODEL=p1s                   # Your printer model: p1s, p1p, x1c, x1e, a1, a1mini, h2d, h2s
+BAMBU_MODEL=p1s                   # Your printer model: p1s, p1p, p2s, x1c, x1e, a1, a1mini, h2d, h2s, h2c
 # Alias also accepted: BAMBU_PRINTER_MODEL
 BED_TYPE=textured_plate           # Bed plate type: textured_plate, cool_plate, engineering_plate, hot_plate, supertack_plate
 NOZZLE_DIAMETER=0.4               # Nozzle diameter in mm (default: 0.4)
@@ -215,7 +215,7 @@ BLENDER_MCP_BRIDGE_COMMAND=       # Shell command to invoke your Blender MCP bri
 | `PRINTER_HOST` | `localhost` | Yes | IP address of the Bambu printer. Alias: `BAMBU_PRINTER_HOST` |
 | `BAMBU_SERIAL` | | Yes | Printer serial number. Alias: `BAMBU_PRINTER_SERIAL` |
 | `BAMBU_TOKEN` | | Yes | LAN access token. Alias: `BAMBU_PRINTER_ACCESS_TOKEN` |
-| `BAMBU_MODEL` | | **Yes** | Printer model: `p1s`, `p1p`, `x1c`, `x1e`, `a1`, `a1mini`, `h2d`, `h2s`. **Required for safe operation** -- determines the correct G-code generation. Alias: `BAMBU_PRINTER_MODEL`. If omitted and the MCP client supports elicitation, the server will ask you interactively. |
+| `BAMBU_MODEL` | | **Yes** | Printer model: `p1s`, `p1p`, `p2s`, `x1c`, `x1e`, `a1`, `a1mini`, `h2d`, `h2s`, `h2c`. **Required for safe operation** -- determines the correct G-code generation. Alias: `BAMBU_PRINTER_MODEL`. If omitted and the MCP client supports elicitation, the server will ask you interactively. Use `h2c` for H2C; do not use `h2d` as a fallback. |
 | `BED_TYPE` | `textured_plate` | No | Bed plate type: `textured_plate`, `cool_plate`, `engineering_plate`, `hot_plate`, `supertack_plate` |
 | `NOZZLE_DIAMETER` | `0.4` | No | Nozzle diameter in mm. Used to select the correct BambuStudio machine preset. |
 | `SLICER_TYPE` | `bambustudio` | No | Slicer to use for slicing operations |
@@ -230,7 +230,7 @@ BLENDER_MCP_BRIDGE_COMMAND=       # Shell command to invoke your Blender MCP bri
 | `MCP_HTTP_JSON_RESPONSE` | `true` | No | Return structured JSON alongside text responses |
 | `MCP_HTTP_ALLOWED_ORIGINS` | | No | Comma-separated list of allowed CORS origins |
 | `BLENDER_MCP_BRIDGE_COMMAND` | | No | Command to invoke Blender MCP bridge |
-| `BAMBU_CLI_FLATTEN` | `false` | No | When `true`, the MCP flattens BBL profile inheritance before invoking the BambuStudio CLI. Workaround for upstream issues [#9636](https://github.com/bambulab/BambuStudio/issues/9636) / [#9968](https://github.com/bambulab/BambuStudio/issues/9968). BBL printers only. Single-color smoke verified on H2S/H2D/X1C/P1S; H2D two-color CLI slicing remains blocked by [#10408](https://github.com/bambulab/BambuStudio/issues/10408). See [docs/SLICING.md](./docs/SLICING.md). |
+| `BAMBU_CLI_FLATTEN` | `false` | No | When `true`, the MCP flattens BBL profile inheritance before invoking the BambuStudio CLI. Workaround for upstream issues [#9636](https://github.com/bambulab/BambuStudio/issues/9636) / [#9968](https://github.com/bambulab/BambuStudio/issues/9968). BBL printers only. Single-color smoke verified on H2S/H2D/X1C/P1S; H2C requires Bambu Studio 2.4.0 or newer. H2D two-color CLI slicing remains blocked by [#10408](https://github.com/bambulab/BambuStudio/issues/10408). See [docs/SLICING.md](./docs/SLICING.md). |
 | `BAMBU_PROFILES_ROOT` | derived from `SLICER_PATH` | No | Override path to the BambuStudio `Resources/profiles` directory used by the CLI flattener. Useful for non-standard installs or dev environments. |
 
 SuperTack can be passed for pre-sliced print jobs, but BambuStudio CLI slicing currently fails fast for `supertack_plate` because the accepted CLI bed identifier is not verified. Use a pre-sliced 3MF for SuperTack until this is confirmed.
@@ -513,7 +513,7 @@ This fork sends the `project_file` command directly via `bambu-node` (bypassing
 // P1/A1/X1-series: 5-element project lookup table
 ams_mapping = [0, -1, -1, -1, -1];
 
-// H2S/H2D: project-length lookup table + parallel ams_mapping2
+// H2S/H2D/H2C: project-length lookup table + parallel ams_mapping2
 ams_mapping = [-1, 1, -1, -1];
 ams_mapping2 = [
   { ams_id: 255, slot_id: 255 },
@@ -1026,7 +1026,7 @@ The primary tool for starting a Bambu print. **Recommended input: a pre-sliced `
 3. Parses the sliced 3MF to extract the correct plate file and compute its MD5 hash.
 4. Also parses `Metadata/project_settings.config` to read AMS mapping embedded by Bambu Studio.
 5. Uploads the 3MF to the printer's `cache/` directory via FTPS using `basic-ftp` directly (avoiding the bambu-js double-path bug).
-6. Sends the correct MQTT print command for the target printer family. For H2S/H2D that means `project_file` with project-length `ams_mapping`, parallel `ams_mapping2`, and H2-compatible calibration flags.
+6. Sends the correct MQTT print command for the target printer family. For H2S/H2D/H2C that means `project_file` with project-length `ams_mapping`, parallel `ams_mapping2`, and H2-compatible calibration flags.
 
 ```json
 {

package/dist/index.js

@@ -25,7 +25,8 @@ const DEFAULT_BAMBU_MODEL = process.env.BAMBU_PRINTER_MODEL?.trim().toLowerCase(
     "";
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
-const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"];
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c"];
+const H2_BAMBU_MODELS = new Set(["h2d", "h2s", "h2c"]);
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"];
 const VALID_BAMBUSTUDIO_CLI_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate"];
 // Map model IDs to BambuStudio --load-machine preset names
@@ -39,6 +40,7 @@ const BAMBU_MODEL_PRESETS = {
     a1mini: (n) => `Bambu Lab A1 mini ${n} nozzle`,
     h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
     h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
+    h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
 };
 const FILAMENT_PROFILE_DIR = "/Applications/BambuStudio.app/Contents/Resources/profiles/BBL/filament";
 const FILAMENT_MODEL_CODES = {
@@ -51,6 +53,7 @@ const FILAMENT_MODEL_CODES = {
     a1mini: "A1M",
     h2d: "H2D",
     h2s: "H2S",
+    h2c: "H2C",
 };
 const COLLAR_CHARM_POLICY = getCollarCharmRolePolicy();
 let filamentProfileIndexCache = null;
@@ -794,6 +797,7 @@ class BambuPrinterMCPServer {
                                 { const: "a1mini", title: "A1 Mini" },
                                 { const: "h2d", title: "H2D" },
                                 { const: "h2s", title: "H2S" },
+                                { const: "h2c", title: "H2C" },
                             ],
                         },
                     },
@@ -1311,7 +1315,7 @@ class BambuPrinterMCPServer {
                                 },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "Optional model hint used to resolve Bambu/Orca filament profile JSONs for each tray."
                                 },
                                 nozzle_diameter: {
@@ -1331,7 +1335,7 @@ class BambuPrinterMCPServer {
                                 plate_index: { type: "number", description: "0-based plate index to inspect (default: 0)" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "Optional model hint used to resolve Bambu/Orca filament profile JSONs for each tray."
                                 },
                                 nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
@@ -1472,7 +1476,7 @@ class BambuPrinterMCPServer {
                                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                                 },
                                 slicer_type: {
@@ -1518,7 +1522,7 @@ class BambuPrinterMCPServer {
                                 stl_path: { type: "string", description: "Path to the STL or 3MF file to slice" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                                 },
                                 slicer_type: {
@@ -1615,7 +1619,7 @@ class BambuPrinterMCPServer {
                                 three_mf_path: { type: "string", description: "Path to the 3MF file to print; unsliced 3MFs are auto-sliced before sending." },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                                 },
                                 connection_type: { type: "string", enum: ["cloud", "lan"], description: "BambuNetwork connection type to put in FULU PrintParams; cloud uses restored internet printing, lan uses local bridge printing." },
@@ -1730,7 +1734,7 @@ class BambuPrinterMCPServer {
                                 print: { type: "boolean", description: "Start printing after upload (default: false)" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "Required when print is true. Bambu Lab printer model used as a safety confirmation before starting the uploaded file."
                                 },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -1749,7 +1753,7 @@ class BambuPrinterMCPServer {
                                 filename: { type: "string", description: "Name of the file to print" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Starting G-code for the wrong model can damage the printer."
                                 },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -1768,7 +1772,7 @@ class BambuPrinterMCPServer {
                                 filename: { type: "string", description: "Name of the file to print" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Starting G-code for the wrong model can damage the printer."
                                 },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -1981,7 +1985,7 @@ class BambuPrinterMCPServer {
                                 three_mf_path: { type: "string", description: "Path to the 3MF file to print" },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                                    enum: [...VALID_BAMBU_MODELS],
                                     description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                                 },
                                 connection_mode: {
@@ -2051,8 +2055,8 @@ class BambuPrinterMCPServer {
                                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },
                                 bambu_model: {
                                     type: "string",
-                                    enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
-                                    description: "REQUIRED: Bambu Lab printer model. H2D and H2S are the primary intended paths."
+                                    enum: [...VALID_BAMBU_MODELS],
+                                    description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
                                 },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -2590,7 +2594,7 @@ class BambuPrinterMCPServer {
                             console.warn("Could not check/slice 3MF, proceeding with original:", sliceCheckErr.message);
                         }
                         const parsed3MFData = await parse3MF(threeMFPath);
-                        const isH2Print = printModel === "h2s" || printModel === "h2d";
+                        const isH2Print = H2_BAMBU_MODELS.has(printModel);
                         let parsedAmsMapping;
                         if (!isH2Print && parsed3MFData.slicerConfig?.ams_mapping) {
                             const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping);
@@ -2661,6 +2665,7 @@ class BambuPrinterMCPServer {
                         result = await this.bambu.print3mf(host, bambuSerial, bambuToken, {
                             projectName,
                             filePath: threeMFPath,
+                            bambuModel: printModel,
                             plateIndex,
                             useAMS: useAMS,
                             amsMapping: finalAmsMapping,
@@ -2696,6 +2701,7 @@ class BambuPrinterMCPServer {
                         result = await this.bambu.print3mf(host, bambuSerial, bambuToken, {
                             projectName,
                             filePath: preparedThreeMFPath,
+                            bambuModel: printModel,
                             plateIndex: collarAnalysis.plateIndex,
                             useAMS: true,
                             amsSlots: collarAnalysis.amsSlots,

package/dist/printers/bambu.d.ts

@@ -1,6 +1,7 @@
 interface BambuPrintOptionsInternal {
     projectName: string;
     filePath: string;
+    bambuModel?: string;
     useAMS?: boolean;
     plateIndex?: number;
     bedType?: string;
@@ -94,7 +95,7 @@ export declare class BambuImplementation {
      *     [16..16+payloadSize] JPEG (FF D8 ... FF D9)
      *
      * Verified models per upstream docs: A1, A1 mini, P1S, P1P. X1/X1C/X1E
-     * and P2S use RTSP on port 322 instead -- not implemented yet. H2/H2S/H2D
+     * and P2S use RTSP on port 322 instead. H2/H2S/H2D/H2C
      * are not documented; we fail fast rather than guess at the protocol.
      *
      * Read-only; no confirm gate. Default 8s timeout for cold-start latency.

package/dist/printers/bambu.js

@@ -32,6 +32,8 @@ function loadClientCreds() {
 const CLIENT_CREDS = loadClientCreds();
 const COMMAND_SETTLE_MS = 300;
 const MODEL_ID_TO_NAME = {
+    O1C: "H2C",
+    O1C2: "H2C",
     O1D: "H2D",
     O1E: "H2D Pro",
     O1S: "H2S",
@@ -43,6 +45,10 @@ const MODEL_ID_TO_NAME = {
     "BL-P002": "X1",
     C13: "X1E",
 };
+const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s"]);
+function isH2ModelName(model) {
+    return H2_MODEL_NAMES.has(String(model ?? "").trim().toLowerCase().replace(/\s+/g, " "));
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -72,7 +78,7 @@ class TolerantBambuClient extends BambuClient {
         await subscribe(`device/${this.config.serialNumber}/report`);
     }
     /**
-     * H2S/H2D printers don't respond to get_version with module info.
+     * H2-series printers don't respond to get_version with module info.
      * Infer model from serial number prefix so downstream code (Job, status
      * parsing, etc.) has a valid printerModel instead of undefined.
      */
@@ -155,7 +161,7 @@ class TolerantBambuClient extends BambuClient {
                 reject(err);
             });
         });
-        // H2S/H2D printers don't respond to get_version with module info.
+        // H2-series printers don't respond to get_version with module info.
         // Infer model from serial number prefix so downstream code works.
         if (!this.data.model) {
             const inferred = this.inferModelFromSerial();
@@ -450,9 +456,11 @@ export class BambuImplementation {
         // the container format from the extension.
         let remoteFileName = path.basename(options.filePath);
         remoteFileName = remoteFileName.replace(/\.gcode\.3mf\.gcode\.3mf$/i, ".gcode.3mf");
-        // H2S/H2D land files at the FTP root and reference them via ftp:///<name>.
+        // H2-series printers land files at the FTP root and reference them via ftp:///<name>.
         // P1/A1/X1 use /cache/<name> and file:///sdcard/cache/<name>.
-        const isH2 = serial.startsWith("093") || serial.startsWith("094");
+        const isH2 = serial.startsWith("093") ||
+            serial.startsWith("094") ||
+            isH2ModelName(options.bambuModel);
         const remoteProjectPath = isH2 ? remoteFileName : `cache/${remoteFileName}`;
         const remoteUploadPath = isH2 ? `/${remoteFileName}` : `/cache/${remoteFileName}`;
         const projectUrl = isH2
@@ -463,7 +471,7 @@ export class BambuImplementation {
         // Pre-sliced .gcode.3mf files: routing depends on firmware generation.
         // P1/A1/X1 series: project_file returns 405004002 for .gcode.3mf (firmware
         // doesn't recognise the container), so use gcode_file instead.
-        // H2S/H2D: gcode_file is not supported; project_file works because the
+        // H2-series: gcode_file is not supported; project_file works because the
         // firmware can open the zip and find Metadata/plate_<n>.gcode directly.
         if (options.filePath.toLowerCase().endsWith(".gcode.3mf")) {
             if (!isH2) {
@@ -475,7 +483,7 @@ export class BambuImplementation {
                     remoteProjectPath,
                 };
             }
-            // H2S/H2D: fall through to project_file path below
+            // H2-series: fall through to project_file path below
         }
         const projectMetadata = await this.resolveProjectFileMetadata(options.filePath, options.plateIndex);
         // Send project_file command via bambu-node MQTT (bypasses bambu-js
@@ -970,7 +978,7 @@ export class BambuImplementation {
      *     [16..16+payloadSize] JPEG (FF D8 ... FF D9)
      *
      * Verified models per upstream docs: A1, A1 mini, P1S, P1P. X1/X1C/X1E
-     * and P2S use RTSP on port 322 instead -- not implemented yet. H2/H2S/H2D
+     * and P2S use RTSP on port 322 instead. H2/H2S/H2D/H2C
      * are not documented; we fail fast rather than guess at the protocol.
      *
      * Read-only; no confirm gate. Default 8s timeout for cold-start latency.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "MCP server for Bambu Lab 3D printers with STL manipulation, slicing, and print management",
   "main": "dist/index.js",
   "repository": {

package/src/index.ts

@@ -46,8 +46,9 @@ const DEFAULT_BAMBU_MODEL =
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
 
-const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"] as const;
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c"] as const;
 type BambuModel = typeof VALID_BAMBU_MODELS[number];
+const H2_BAMBU_MODELS = new Set<string>(["h2d", "h2s", "h2c"]);
 
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"] as const;
 const VALID_BAMBUSTUDIO_CLI_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate"] as const;
@@ -63,6 +64,7 @@ const BAMBU_MODEL_PRESETS: Record<string, (nozzle: string) => string> = {
   a1mini: (n) => `Bambu Lab A1 mini ${n} nozzle`,
   h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
   h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
+  h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
 };
 
 const FILAMENT_PROFILE_DIR =
@@ -77,6 +79,7 @@ const FILAMENT_MODEL_CODES: Record<string, string> = {
   a1mini: "A1M",
   h2d: "H2D",
   h2s: "H2S",
+  h2c: "H2C",
 };
 
 type FilamentProfileIndex = {
@@ -1078,6 +1081,7 @@ class BambuPrinterMCPServer {
                 { const: "a1mini", title: "A1 Mini" },
                 { const: "h2d", title: "H2D" },
                 { const: "h2s", title: "H2S" },
+                { const: "h2c", title: "H2C" },
               ],
             },
           },
@@ -1776,7 +1780,7 @@ class BambuPrinterMCPServer {
                 },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "Optional model hint used to resolve Bambu/Orca filament profile JSONs for each tray."
                 },
                 nozzle_diameter: {
@@ -1796,7 +1800,7 @@ class BambuPrinterMCPServer {
                 plate_index: { type: "number", description: "0-based plate index to inspect (default: 0)" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "Optional model hint used to resolve Bambu/Orca filament profile JSONs for each tray."
                 },
                 nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
@@ -1937,7 +1941,7 @@ class BambuPrinterMCPServer {
                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                 },
                 slicer_type: {
@@ -1983,7 +1987,7 @@ class BambuPrinterMCPServer {
                 stl_path: { type: "string", description: "Path to the STL or 3MF file to slice" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                 },
                 slicer_type: {
@@ -2080,7 +2084,7 @@ class BambuPrinterMCPServer {
                 three_mf_path: { type: "string", description: "Path to the 3MF file to print; unsliced 3MFs are auto-sliced before sending." },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                 },
                 connection_type: { type: "string", enum: ["cloud", "lan"], description: "BambuNetwork connection type to put in FULU PrintParams; cloud uses restored internet printing, lan uses local bridge printing." },
@@ -2195,7 +2199,7 @@ class BambuPrinterMCPServer {
                 print: { type: "boolean", description: "Start printing after upload (default: false)" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "Required when print is true. Bambu Lab printer model used as a safety confirmation before starting the uploaded file."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -2214,7 +2218,7 @@ class BambuPrinterMCPServer {
                 filename: { type: "string", description: "Name of the file to print" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Starting G-code for the wrong model can damage the printer."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -2233,7 +2237,7 @@ class BambuPrinterMCPServer {
                 filename: { type: "string", description: "Name of the file to print" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Starting G-code for the wrong model can damage the printer."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
@@ -2446,7 +2450,7 @@ class BambuPrinterMCPServer {
                 three_mf_path: { type: "string", description: "Path to the 3MF file to print" },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
+                  enum: [...VALID_BAMBU_MODELS],
                   description: "REQUIRED: Bambu Lab printer model. Ask the user if not known. Using the wrong model can damage the printer."
                 },
                 connection_mode: {
@@ -2516,8 +2520,8 @@ class BambuPrinterMCPServer {
                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },
                 bambu_model: {
                   type: "string",
-                  enum: ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s"],
-                  description: "REQUIRED: Bambu Lab printer model. H2D and H2S are the primary intended paths."
+                  enum: [...VALID_BAMBU_MODELS],
+                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -3201,7 +3205,7 @@ class BambuPrinterMCPServer {
             }
 
             const parsed3MFData = await parse3MF(threeMFPath);
-            const isH2Print = printModel === "h2s" || printModel === "h2d";
+            const isH2Print = H2_BAMBU_MODELS.has(printModel);
             let parsedAmsMapping: number[] | undefined;
             if (!isH2Print && parsed3MFData.slicerConfig?.ams_mapping) {
               const slots = normalizeAmsMappingObject(parsed3MFData.slicerConfig.ams_mapping as Record<string, unknown>);
@@ -3290,6 +3294,7 @@ class BambuPrinterMCPServer {
             result = await this.bambu.print3mf(host, bambuSerial, bambuToken, {
               projectName,
               filePath: threeMFPath,
+              bambuModel: printModel,
               plateIndex,
               useAMS: useAMS,
               amsMapping: finalAmsMapping,
@@ -3353,6 +3358,7 @@ class BambuPrinterMCPServer {
             result = await this.bambu.print3mf(host, bambuSerial, bambuToken, {
               projectName,
               filePath: preparedThreeMFPath,
+              bambuModel: printModel,
               plateIndex: collarAnalysis.plateIndex,
               useAMS: true,
               amsSlots: collarAnalysis.amsSlots,

package/src/printers/bambu.ts

@@ -42,6 +42,8 @@ const CLIENT_CREDS = loadClientCreds();
 const COMMAND_SETTLE_MS = 300;
 
 const MODEL_ID_TO_NAME: Record<string, string> = {
+  O1C: "H2C",
+  O1C2: "H2C",
   O1D: "H2D",
   O1E: "H2D Pro",
   O1S: "H2S",
@@ -54,9 +56,16 @@ const MODEL_ID_TO_NAME: Record<string, string> = {
   C13: "X1E",
 };
 
+const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s"]);
+
+function isH2ModelName(model: unknown): boolean {
+  return H2_MODEL_NAMES.has(String(model ?? "").trim().toLowerCase().replace(/\s+/g, " "));
+}
+
 interface BambuPrintOptionsInternal {
   projectName: string;
   filePath: string;
+  bambuModel?: string;
   useAMS?: boolean;
   plateIndex?: number;
   bedType?: string;
@@ -128,7 +137,7 @@ class TolerantBambuClient extends BambuClient {
   }
 
   /**
-   * H2S/H2D printers don't respond to get_version with module info.
+   * H2-series printers don't respond to get_version with module info.
    * Infer model from serial number prefix so downstream code (Job, status
    * parsing, etc.) has a valid printerModel instead of undefined.
    */
@@ -205,7 +214,7 @@ class TolerantBambuClient extends BambuClient {
         reject(err);
       });
     });
-    // H2S/H2D printers don't respond to get_version with module info.
+    // H2-series printers don't respond to get_version with module info.
     // Infer model from serial number prefix so downstream code works.
     if (!this.data.model) {
       const inferred = this.inferModelFromSerial();
@@ -562,9 +571,12 @@ export class BambuImplementation {
     let remoteFileName = path.basename(options.filePath);
     remoteFileName = remoteFileName.replace(/\.gcode\.3mf\.gcode\.3mf$/i, ".gcode.3mf");
 
-    // H2S/H2D land files at the FTP root and reference them via ftp:///<name>.
+    // H2-series printers land files at the FTP root and reference them via ftp:///<name>.
     // P1/A1/X1 use /cache/<name> and file:///sdcard/cache/<name>.
-    const isH2 = serial.startsWith("093") || serial.startsWith("094");
+    const isH2 =
+      serial.startsWith("093") ||
+      serial.startsWith("094") ||
+      isH2ModelName(options.bambuModel);
     const remoteProjectPath = isH2 ? remoteFileName : `cache/${remoteFileName}`;
     const remoteUploadPath = isH2 ? `/${remoteFileName}` : `/cache/${remoteFileName}`;
     const projectUrl = isH2
@@ -577,7 +589,7 @@ export class BambuImplementation {
     // Pre-sliced .gcode.3mf files: routing depends on firmware generation.
     // P1/A1/X1 series: project_file returns 405004002 for .gcode.3mf (firmware
     // doesn't recognise the container), so use gcode_file instead.
-    // H2S/H2D: gcode_file is not supported; project_file works because the
+    // H2-series: gcode_file is not supported; project_file works because the
     // firmware can open the zip and find Metadata/plate_<n>.gcode directly.
     if (options.filePath.toLowerCase().endsWith(".gcode.3mf")) {
       if (!isH2) {
@@ -589,7 +601,7 @@ export class BambuImplementation {
           remoteProjectPath,
         };
       }
-      // H2S/H2D: fall through to project_file path below
+      // H2-series: fall through to project_file path below
     }
 
     const projectMetadata = await this.resolveProjectFileMetadata(
@@ -1210,7 +1222,7 @@ export class BambuImplementation {
    *     [16..16+payloadSize] JPEG (FF D8 ... FF D9)
    *
    * Verified models per upstream docs: A1, A1 mini, P1S, P1P. X1/X1C/X1E
-   * and P2S use RTSP on port 322 instead -- not implemented yet. H2/H2S/H2D
+   * and P2S use RTSP on port 322 instead. H2/H2S/H2D/H2C
    * are not documented; we fail fast rather than guess at the protocol.
    *
    * Read-only; no confirm gate. Default 8s timeout for cold-start latency.