bambu-printer-mcp 1.1.8 → 1.1.10

package/dist/index.js

@@ -14,7 +14,7 @@ import { BambuNetworkBridge } from "./bambu-network-bridge.js";
 import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
-import { BambuImplementation } from "./printers/bambu.js";
+import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 dotenv.config();
 const DEFAULT_HOST = process.env.BAMBU_PRINTER_HOST || process.env.PRINTER_HOST || "localhost";
 const DEFAULT_BAMBU_SERIAL = process.env.BAMBU_PRINTER_SERIAL || process.env.BAMBU_SERIAL || "";
@@ -44,7 +44,7 @@ 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", "h2c"];
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"];
 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"];
@@ -60,6 +60,7 @@ const BAMBU_MODEL_PRESETS = {
     h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
     h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
     h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
+    x2d: (n) => `Bambu Lab X2D ${n} nozzle`,
 };
 const FILAMENT_PROFILE_DIR = "/Applications/BambuStudio.app/Contents/Resources/profiles/BBL/filament";
 const FILAMENT_MODEL_CODES = {
@@ -73,6 +74,7 @@ const FILAMENT_MODEL_CODES = {
     h2d: "H2D",
     h2s: "H2S",
     h2c: "H2C",
+    x2d: "X2D",
 };
 const COLLAR_CHARM_POLICY = getCollarCharmRolePolicy();
 let filamentProfileIndexCache = null;
@@ -371,6 +373,19 @@ function extractPrinterDiagnostics(status) {
         diagnostic_fields: diagnosticFields,
     };
 }
+/** Parse "#RRGGBB;#RRGGBB" (leading '#' optional) into positional slot colours. */
+function parseFilamentColours(value) {
+    const colours = value.split(";").map((c) => c.trim()).filter(Boolean)
+        .map((c) => (c.startsWith("#") ? c : `#${c}`).toUpperCase());
+    for (const c of colours) {
+        if (!/^#[0-9A-F]{6}([0-9A-F]{2})?$/.test(c)) {
+            throw new Error(`Invalid filament colour "${c}"; expected #RRGGBB.`);
+        }
+    }
+    if (colours.length === 0)
+        throw new Error("filament_colours must list at least one colour.");
+    return colours;
+}
 function validateBambuModel(model) {
     const normalized = model.trim().toLowerCase();
     if (!VALID_BAMBU_MODELS.includes(normalized)) {
@@ -822,6 +837,7 @@ class BambuPrinterMCPServer {
                                 { const: "h2d", title: "H2D" },
                                 { const: "h2s", title: "H2S" },
                                 { const: "h2c", title: "H2C" },
+                                { const: "x2d", title: "X2D" },
                             ],
                         },
                     },
@@ -1549,6 +1565,7 @@ class BambuPrinterMCPServer {
                                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
                                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs." },
                                 load_filament_ids: { type: "string", description: "Optional filament-to-object mapping string." },
+                                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                                 ensure_on_bed: { type: "boolean", description: "Lift floating models onto the bed." },
                                 arrange: { type: "boolean", description: "Auto-arrange objects on the build plate." },
                                 orient: { type: "boolean", description: "Auto-orient model for optimal printability." },
@@ -1603,6 +1620,7 @@ class BambuPrinterMCPServer {
                                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
                                 filament_profile: { type: "string", description: "Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths." },
                                 load_filament_ids: { type: "string", description: "Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3." },
+                                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                                 enable_timelapse: { type: "boolean", description: "Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time." },
                                 allow_mix_temp: { type: "boolean", description: "Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG." },
                                 scale: { type: "number", description: "Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing." },
@@ -2107,7 +2125,7 @@ class BambuPrinterMCPServer {
                                 bambu_model: {
                                     type: "string",
                                     enum: [...VALID_BAMBU_MODELS],
-                                    description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
+                                    description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths. X2D direct printing is not supported."
                                 },
                                 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)" },
@@ -2343,23 +2361,27 @@ class BambuPrinterMCPServer {
                         }
                         break;
                     }
-                    case "upload_file":
+                    case "upload_file": {
                         if (!args?.file_path || !args?.filename) {
                             throw new Error("Missing required parameters: file_path and filename");
                         }
-                        if (Boolean(args.print ?? false)) {
-                            await this.resolveBambuModel(args?.bambu_model);
-                        }
-                        result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, String(args.file_path), String(args.filename), Boolean(args.print ?? false));
+                        const print = Boolean(args.print ?? false);
+                        const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model) : undefined;
+                        if (print)
+                            assertDirectPrintSupported(uploadModel, bambuSerial);
+                        result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, String(args.file_path), String(args.filename), print, uploadModel);
                         break;
+                    }
                     case "start_print":
-                    case "start_print_job":
+                    case "start_print_job": {
                         if (!args?.filename) {
                             throw new Error("Missing required parameter: filename");
                         }
-                        await this.resolveBambuModel(args?.bambu_model);
-                        result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename));
+                        const startModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(startModel, bambuSerial);
+                        result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename), startModel);
                         break;
+                    }
                     case "cancel_print":
                         result = await this.bambu.cancelJob(host, bambuSerial, bambuToken);
                         break;
@@ -2499,6 +2521,8 @@ class BambuPrinterMCPServer {
                         }
                         if (args?.load_filament_ids !== undefined)
                             sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.filament_colours !== undefined)
+                            sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
@@ -2576,6 +2600,8 @@ class BambuPrinterMCPServer {
                         }
                         if (args?.load_filament_ids !== undefined)
                             sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.filament_colours !== undefined)
+                            sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
@@ -2628,6 +2654,7 @@ class BambuPrinterMCPServer {
                         }
                         const { slicerType, slicerPath, slicerProfile } = this.resolveSlicerConfigFromArgs(args, "print_3mf");
                         const printModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(printModel, bambuSerial);
                         const printBedType = resolveBedType(args?.bed_type);
                         const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(args, slicerProfile || undefined, resolveTemplatePathFromName(["json", "config", "3mf"]) || explicitTemplatePath || undefined, TEMP_DIR);
@@ -2768,6 +2795,7 @@ class BambuPrinterMCPServer {
                         }
                         const { slicerType, slicerPath, slicerProfile } = this.resolveSlicerConfigFromArgs(args, "print_collar_charm");
                         const printModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(printModel, bambuSerial);
                         const printBedType = resolveBedType(args?.bed_type);
                         const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(args, slicerProfile || undefined, resolvedTemplateSourcePath || explicitTemplatePath || undefined, TEMP_DIR);

package/dist/printers/bambu.d.ts

@@ -1,3 +1,4 @@
+export declare function assertDirectPrintSupported(model: string | undefined, serial?: string): void;
 interface BambuPrintOptionsInternal {
     projectName: string;
     filePath: string;
@@ -67,8 +68,8 @@ export declare class BambuImplementation {
         name: string;
         exists: boolean;
     }>;
-    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean): Promise<Record<string, unknown>>;
-    startJob(host: string, serial: string, token: string, filename: string): Promise<{
+    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean, bambuModel?: string): Promise<Record<string, unknown>>;
+    startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string): Promise<{
         status: string;
         message: string;
         file: string;

package/dist/printers/bambu.js

@@ -37,6 +37,7 @@ const MODEL_ID_TO_NAME = {
     O1D: "H2D",
     O1E: "H2D Pro",
     O1S: "H2S",
+    N6: "X2D",
     N2S: "A1",
     A1M: "A1 Mini",
     C11: "P1P",
@@ -46,6 +47,12 @@ const MODEL_ID_TO_NAME = {
     C13: "X1E",
 };
 const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s"]);
+export function assertDirectPrintSupported(model, serial) {
+    if (model?.trim().toLowerCase() === "x2d" || serial?.trim().toUpperCase().startsWith("20P")) {
+        throw new Error("X2D direct printing is not supported pending native eMMC transport support. " +
+            "X2D status and slicing remain available; use a supported slicer to print.");
+    }
+}
 function isH2ModelName(model) {
     return H2_MODEL_NAMES.has(String(model ?? "").trim().toLowerCase().replace(/\s+/g, " "));
 }
@@ -95,6 +102,8 @@ class TolerantBambuClient extends BambuClient {
             return "H2C";
         if (sn.startsWith("31B"))
             return "H2DPRO";
+        if (sn.startsWith("20P"))
+            return "X2D";
         if (sn.startsWith("00M"))
             return "X1C";
         if (sn.startsWith("00W"))
@@ -457,6 +466,7 @@ export class BambuImplementation {
         }
     }
     async print3mf(host, serial, token, options) {
+        assertDirectPrintSupported(options.bambuModel, serial);
         if (!options.filePath.toLowerCase().endsWith(".3mf")) {
             throw new Error("print3mf requires a .3mf input file.");
         }
@@ -929,7 +939,9 @@ export class BambuImplementation {
             exists,
         };
     }
-    async uploadFile(host, serial, token, filePath, filename, print) {
+    async uploadFile(host, serial, token, filePath, filename, print, bambuModel) {
+        if (print)
+            assertDirectPrintSupported(bambuModel, serial);
         await fs.access(filePath);
         const normalizedFileName = filename.replace(/^\/+/, "");
         const remotePath = normalizedFileName.includes("/")
@@ -945,7 +957,7 @@ export class BambuImplementation {
         };
         if (print) {
             if (remotePath.toLowerCase().endsWith(".gcode")) {
-                response.startResult = await this.startJob(host, serial, token, remotePath);
+                response.startResult = await this.startJob(host, serial, token, remotePath, bambuModel);
             }
             else if (remotePath.toLowerCase().endsWith(".3mf")) {
                 response.note =
@@ -957,7 +969,8 @@ export class BambuImplementation {
         }
         return response;
     }
-    async startJob(host, serial, token, filename) {
+    async startJob(host, serial, token, filename, bambuModel) {
+        assertDirectPrintSupported(bambuModel, serial);
         const lower = filename.toLowerCase();
         if (lower.endsWith(".3mf") && !lower.endsWith(".gcode.3mf")) {
             throw new Error("Use print_3mf for .3mf project files.");
@@ -1007,7 +1020,7 @@ export class BambuImplementation {
         // P1/A1 series still use the proprietary TCP-on-6000 framed JPEG path
         // (per https://github.com/Doridian/OpenBambuAPI/blob/main/video.md).
         const TCP_CAMERA_MODELS = new Set(["a1", "a1mini", "p1s", "p1p"]);
-        // X1, P2S, AND H2 (H2S/H2D/H2C) all use RTSP on port 322. The
+        // X1, P2S, H2 (H2S/H2D/H2C), AND X2D all use RTSP on port 322. The
         // OpenBambuAPI doc only mentions X1/P2S, but the HA bambulab
         // integration's models.py shows the printer reports its own
         // `ipcam.rtsp_url` for these models, and Parker (H2S) rejects the
@@ -1015,7 +1028,7 @@ export class BambuImplementation {
         // confirmed by local H2 camera transport probes).
         const RTSP_MODELS = new Set([
             "x1", "x1c", "x1carbon", "x1e", "p2s",
-            "h2", "h2s", "h2d", "h2c", "h2dpro",
+            "h2", "h2s", "h2d", "h2c", "h2dpro", "x2d",
         ]);
         if (!model) {
             throw new Error("camera_snapshot requires bambu_model or BAMBU_MODEL so it can choose the correct Bambu camera protocol.");

package/dist/slicer/profile-flatten.d.ts

@@ -70,7 +70,21 @@ export interface FlattenOptions {
         process?: Record<string, unknown>;
         filaments?: (Record<string, unknown> | undefined)[];
     };
+    /**
+     * Positional `#RRGGBB` colour per filament slot (e.g. from the input 3MF
+     * project or the caller). Missing entries keep the profile's own colour or
+     * fall back to DEFAULT_FILAMENT_COLOUR.
+     */
+    filamentColours?: (string | undefined)[];
+    /** Saved per-plate positions, used only when the process sets no position. */
+    projectTowerPosition?: {
+        wipe_tower_x?: unknown;
+        wipe_tower_y?: unknown;
+    };
 }
+/** Best-effort extruder count for fallback nozzle_volume_type sizing. */
+/** BambuStudio's built-in filament_colour default. */
+export declare const DEFAULT_FILAMENT_COLOUR = "#00AE42";
 /**
  * Flatten the leaf profiles, post-process for CLI, and write to temp files.
  *

package/dist/slicer/profile-flatten.js

@@ -219,6 +219,86 @@ function enforceMatchingNozzles(arr) {
     }
 }
 /** Best-effort extruder count for fallback nozzle_volume_type sizing. */
+/** BambuStudio's built-in filament_colour default. */
+export const DEFAULT_FILAMENT_COLOUR = "#00AE42";
+const FILAMENT_COLOUR_RE = /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/;
+/**
+ * No BBL filament profile defines `filament_colour`; the GUI fills it from
+ * the AMS. Without it the CLI keeps a single-entry colour vector however many
+ * filaments are loaded and crashes (access violation) as soon as a slice uses
+ * any filament after the first. Give every slot exactly one colour.
+ */
+function ensureFilamentColour(flat, colour) {
+    if (colour !== undefined) {
+        if (!FILAMENT_COLOUR_RE.test(colour)) {
+            throw new Error(`Invalid filament colour "${colour}"; expected #RRGGBB.`);
+        }
+        flat["filament_colour"] = [colour];
+        return;
+    }
+    const own = flat["filament_colour"];
+    if (Array.isArray(own) && typeof own[0] === "string" && FILAMENT_COLOUR_RE.test(own[0])) {
+        flat["filament_colour"] = [own[0]];
+        return;
+    }
+    flat["filament_colour"] = [DEFAULT_FILAMENT_COLOUR];
+}
+// BambuStudio's defaults when a process sets no prime tower position/width.
+const DEFAULT_WIPE_TOWER_X = 15;
+const DEFAULT_WIPE_TOWER_Y = 220;
+const DEFAULT_PRIME_TOWER_WIDTH = 35;
+// Clearance inside the shared nozzle area for the auto-sized tower brim and
+// the CLI's own safety margin (X2D fails at 5 mm from the edge, passes at 6).
+const WIPE_TOWER_MARGIN = 15;
+function parseArea(area) {
+    const points = area.split(",").map((p) => p.trim().split("x").map(Number));
+    if (points.length < 3 || points.some((p) => p.length !== 2 || p.some((n) => !Number.isFinite(n)))) {
+        throw new Error(`Malformed extruder_printable_area entry "${area}".`);
+    }
+    const xs = points.map((p) => p[0]);
+    const ys = points.map((p) => p[1]);
+    return { minX: Math.min(...xs), maxX: Math.max(...xs), minY: Math.min(...ys), maxY: Math.max(...ys) };
+}
+/**
+ * On multi-nozzle machines (H2D, X2D) each nozzle reaches only part of the
+ * bed (`extruder_printable_area`), and the prime tower must be reachable by
+ * every nozzle. The CLI's default tower position (x=15) lies outside the
+ * X2D/H2D right-nozzle area, so slicing fails with "G-code outside of the
+ * printable area". When the process sets no position and the default does
+ * not fit, move the tower inside the area all nozzles share.
+ */
+function placePrimeTowerForAllNozzles(machineFlat, processFlat) {
+    if (processFlat["wipe_tower_x"] !== undefined || processFlat["wipe_tower_y"] !== undefined)
+        return;
+    if (["0", "false"].includes(String(processFlat["enable_prime_tower"]).toLowerCase()))
+        return;
+    const areas = machineFlat["extruder_printable_area"];
+    if (!Array.isArray(areas) || areas.length < 2)
+        return;
+    const rects = areas.map((a) => {
+        if (typeof a !== "string")
+            throw new Error("Malformed extruder_printable_area in machine profile.");
+        return parseArea(a);
+    });
+    const shared = {
+        minX: Math.max(...rects.map((r) => r.minX)) + WIPE_TOWER_MARGIN,
+        maxX: Math.min(...rects.map((r) => r.maxX)) - WIPE_TOWER_MARGIN,
+        minY: Math.max(...rects.map((r) => r.minY)) + WIPE_TOWER_MARGIN,
+        maxY: Math.min(...rects.map((r) => r.maxY)) - WIPE_TOWER_MARGIN,
+    };
+    const width = Number(processFlat["prime_tower_width"] ?? DEFAULT_PRIME_TOWER_WIDTH);
+    const size = Number.isFinite(width) && width > 0 ? width : DEFAULT_PRIME_TOWER_WIDTH;
+    if (shared.maxX - shared.minX < size || shared.maxY - shared.minY < size) {
+        throw new Error("No bed area is reachable by every nozzle for the prime tower.");
+    }
+    const clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+    const x = clamp(DEFAULT_WIPE_TOWER_X, shared.minX, shared.maxX - size);
+    const y = clamp(DEFAULT_WIPE_TOWER_Y, shared.minY, shared.maxY - size);
+    if (x === DEFAULT_WIPE_TOWER_X && y === DEFAULT_WIPE_TOWER_Y)
+        return;
+    processFlat["wipe_tower_x"] = [String(x)];
+    processFlat["wipe_tower_y"] = [String(y)];
+}
 function inferExtruderCount(flat) {
     for (const key of ["nozzle_diameter", "extruder_type", "extruder_variant_list"]) {
         const v = flat[key];
@@ -466,7 +546,15 @@ export async function flattenForCli(opts) {
     normalizeForCli(machineFlat, "machine", opts.machineLeaf);
     normalizeForCli(processFlat, "process", opts.processLeaf);
     filamentFlats.forEach((f, i) => normalizeForCli(f, "filament", opts.filamentLeaves[i]));
+    if (opts.filamentColours && opts.filamentColours.length !== filamentFlats.length) {
+        throw new Error(`${opts.filamentColours.length} filament colours were supplied for ${filamentFlats.length} filament slots.`);
+    }
+    filamentFlats.forEach((f, i) => ensureFilamentColour(f, opts.filamentColours?.[i]));
     applyBedType(processFlat, opts.bedType);
+    if (processFlat["wipe_tower_x"] === undefined && processFlat["wipe_tower_y"] === undefined) {
+        Object.assign(processFlat, opts.projectTowerPosition);
+    }
+    placePrimeTowerForAllNozzles(machineFlat, processFlat);
     // Mirror the GUI's auto-extend behavior: when the caller explicitly
     // chose a process or filament that wasn't pre-declared compatible with
     // the chosen machine (e.g. "0.20mm Standard @BBL P1P" used on a P1S),

package/dist/stl/stl-manipulator.d.ts

@@ -36,6 +36,7 @@ export interface BambuSliceOptions {
     skipObjects?: string;
     loadFilaments?: string;
     loadFilamentIds?: string;
+    filamentColours?: string[];
     bedType?: string;
     enableTimelapse?: boolean;
     allowMixTemp?: boolean;

package/dist/stl/stl-manipulator.js

@@ -382,20 +382,32 @@ export class STLManipulator extends EventEmitter {
             profilesRoot,
             tempDir: this.tempDir,
             bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
+            filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
+            projectTowerPosition: bundle.projectTowerPosition,
             sourceProfiles: {
                 machine: isBundledFile(machinePath) ? undefined : machine,
                 process: isBundledFile(processPath) ? undefined : processProfile,
                 filaments: filaments.map((profile, i) => isBundledFile(bundle.filamentPaths[i]) ? undefined : profile),
             },
         });
-        // Standalone custom files have no BBL dependencies; preserve their identity
-        // and content. Other profiles retain user values through sourceProfiles.
+        // Standalone files retain their own identity and settings, but still need
+        // the CLI colour/tower fields. Do not discard those required overlays when
+        // choosing the original profile instead of the normalized BBL output.
+        const withCliFields = (filePath, profile, flatPath, keys) => {
+            const flattened = readProfile(flatPath);
+            const fields = Object.fromEntries(keys.filter(key => flattened[key] !== undefined).map(key => [key, flattened[key]]));
+            if (Object.entries(fields).every(([key, value]) => JSON.stringify(profile[key]) === JSON.stringify(value)))
+                return filePath;
+            return this.writeTempJson(path.basename(filePath, '.json'), 'cli', { ...profile, ...fields });
+        };
         return {
             settingsArg: [
                 needsResolution(machinePath, machine) ? flat.machinePath : machinePath,
-                needsResolution(processPath, processProfile) ? flat.processPath : processPath,
+                needsResolution(processPath, processProfile) ? flat.processPath
+                    : withCliFields(processPath, processProfile, flat.processPath, ['wipe_tower_x', 'wipe_tower_y']),
             ].join(';'),
-            filamentPaths: filaments.map((profile, i) => needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i] : bundle.filamentPaths[i]),
+            filamentPaths: filaments.map((profile, i) => needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i]
+                : withCliFields(bundle.filamentPaths[i], profile, flat.filamentPaths[i], ['filament_colour'])),
         };
     }
     /** --load-filaments is positional; a single override must cover every project slot. */
@@ -417,13 +429,20 @@ export class STLManipulator extends EventEmitter {
             .map(key => Array.isArray(data[key]) ? data[key].length : 0));
         if (count === 0)
             throw new Error('Cannot determine project filament slots from project_settings.config.');
+        // Keep the project's slot colours; loaded profiles carry none of their own.
+        const colours = Array.isArray(data.filament_colour) && data.filament_colour.length === count &&
+            data.filament_colour.every(c => typeof c === 'string' && /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/.test(c))
+            ? data.filament_colour
+            : undefined;
+        const projectTowerPosition = Object.fromEntries(['wipe_tower_x', 'wipe_tower_y']
+            .filter(key => data[key] !== undefined).map(key => [key, data[key]]));
         if (bundle.filamentPaths.length === 1) {
-            return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]) };
+            return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]), filamentColours: colours, projectTowerPosition };
         }
         if (bundle.filamentPaths.length !== count) {
             throw new Error(`Project declares ${count} filament slots, but ${bundle.filamentPaths.length} profiles were supplied. Provide one profile for all slots or one per slot.`);
         }
-        return bundle;
+        return { ...bundle, filamentColours: colours, projectTowerPosition };
     }
     resolveBambuStudioBedType(bedType) {
         if (!bedType)

package/package.json

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

package/src/index.ts

@@ -29,7 +29,7 @@ import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
 import type { ThreeMFAmsRequirements } from "./types.js";
-import { BambuImplementation } from "./printers/bambu.js";
+import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 
 dotenv.config();
 
@@ -64,7 +64,7 @@ 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", "h2c"] as const;
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"] as const;
 type BambuModel = typeof VALID_BAMBU_MODELS[number];
 const H2_BAMBU_MODELS = new Set<string>(["h2d", "h2s", "h2c"]);
 
@@ -83,6 +83,7 @@ const BAMBU_MODEL_PRESETS: Record<string, (nozzle: string) => string> = {
   h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
   h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
   h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
+  x2d: (n) => `Bambu Lab X2D ${n} nozzle`,
 };
 
 const FILAMENT_PROFILE_DIR =
@@ -98,6 +99,7 @@ const FILAMENT_MODEL_CODES: Record<string, string> = {
   h2d: "H2D",
   h2s: "H2S",
   h2c: "H2C",
+  x2d: "X2D",
 };
 
 type FilamentProfileIndex = {
@@ -516,6 +518,19 @@ function extractPrinterDiagnostics(status: any): Record<string, unknown> {
   };
 }
 
+/** Parse "#RRGGBB;#RRGGBB" (leading '#' optional) into positional slot colours. */
+function parseFilamentColours(value: string): string[] {
+  const colours = value.split(";").map((c) => c.trim()).filter(Boolean)
+    .map((c) => (c.startsWith("#") ? c : `#${c}`).toUpperCase());
+  for (const c of colours) {
+    if (!/^#[0-9A-F]{6}([0-9A-F]{2})?$/.test(c)) {
+      throw new Error(`Invalid filament colour "${c}"; expected #RRGGBB.`);
+    }
+  }
+  if (colours.length === 0) throw new Error("filament_colours must list at least one colour.");
+  return colours;
+}
+
 function validateBambuModel(model: string): string {
   const normalized = model.trim().toLowerCase();
   if (!VALID_BAMBU_MODELS.includes(normalized as BambuModel)) {
@@ -1108,6 +1123,7 @@ class BambuPrinterMCPServer {
                 { const: "h2d", title: "H2D" },
                 { const: "h2s", title: "H2S" },
                 { const: "h2c", title: "H2C" },
+                { const: "x2d", title: "X2D" },
               ],
             },
           },
@@ -2045,6 +2061,7 @@ class BambuPrinterMCPServer {
                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs." },
                 load_filament_ids: { type: "string", description: "Optional filament-to-object mapping string." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 ensure_on_bed: { type: "boolean", description: "Lift floating models onto the bed." },
                 arrange: { type: "boolean", description: "Auto-arrange objects on the build plate." },
                 orient: { type: "boolean", description: "Auto-orient model for optimal printability." },
@@ -2099,6 +2116,7 @@ class BambuPrinterMCPServer {
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
                 filament_profile: { type: "string", description: "Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths." },
                 load_filament_ids: { type: "string", description: "Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 enable_timelapse: { type: "boolean", description: "Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time." },
                 allow_mix_temp: { type: "boolean", description: "Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG." },
                 scale: { type: "number", description: "Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing." },
@@ -2603,7 +2621,7 @@ class BambuPrinterMCPServer {
                 bambu_model: {
                   type: "string",
                   enum: [...VALID_BAMBU_MODELS],
-                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
+                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths. X2D direct printing is not supported."
                 },
                 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)" },
@@ -2895,28 +2913,31 @@ class BambuPrinterMCPServer {
             break;
           }
 
-          case "upload_file":
+          case "upload_file": {
             if (!args?.file_path || !args?.filename) {
               throw new Error("Missing required parameters: file_path and filename");
             }
-            if (Boolean(args.print ?? false)) {
-              await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            }
+            const print = Boolean(args.print ?? false);
+            const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model as string | undefined) : undefined;
+            if (print) assertDirectPrintSupported(uploadModel, bambuSerial);
             result = await this.bambu.uploadFile(
               host, bambuSerial, bambuToken,
               String(args.file_path), String(args.filename),
-              Boolean(args.print ?? false)
+              print, uploadModel
             );
             break;
+          }
 
           case "start_print":
-          case "start_print_job":
+          case "start_print_job": {
             if (!args?.filename) {
               throw new Error("Missing required parameter: filename");
             }
-            await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename));
+            const startModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(startModel, bambuSerial);
+            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename), startModel);
             break;
+          }
 
           case "cancel_print":
             result = await this.bambu.cancelJob(host, bambuSerial, bambuToken);
@@ -3118,6 +3139,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3203,6 +3225,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3265,6 +3288,7 @@ class BambuPrinterMCPServer {
               "print_3mf"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(
@@ -3450,6 +3474,7 @@ class BambuPrinterMCPServer {
               "print_collar_charm"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(