bambu-printer-mcp 1.0.2 → 1.0.4

package/README.md

@@ -716,6 +716,53 @@ Slice an STL or 3MF file using an external slicer and return the path to the out
 
 For printing on a Bambu printer, the recommended workflow is: slice with `bambustudio` to get a sliced 3MF, then pass that output path to `print_3mf`.
 
+#### BambuStudio Slicer Options
+
+When `slicer_type` is `bambustudio` (the default), these additional parameters are available on `slice_stl`:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `uptodate` | boolean | Update 3MF configs to latest BambuStudio presets |
+| `repetitions` | number | Number of copies to print |
+| `orient` | boolean | Auto-orient model for optimal printability |
+| `arrange` | boolean | Auto-arrange objects on the build plate |
+| `ensure_on_bed` | boolean | Lift floating models onto the bed |
+| `clone_objects` | string | Clone counts per object, comma-separated (e.g. `"1,3,1,10"`) |
+| `skip_objects` | string | Object indices to skip, comma-separated (e.g. `"3,5,10"`) |
+| `load_filaments` | string | Filament profile paths, semicolon-separated |
+| `load_filament_ids` | string | Filament-to-object mapping, comma-separated |
+| `enable_timelapse` | boolean | Enable timelapse-aware slicing |
+| `allow_mix_temp` | boolean | Allow mixed-temperature filaments on one plate |
+| `scale` | number | Uniform scale factor |
+| `rotate` | number | Z-axis rotation in degrees |
+| `rotate_x` | number | X-axis rotation in degrees |
+| `rotate_y` | number | Y-axis rotation in degrees |
+| `min_save` | boolean | Produce smaller output 3MF (faster uploads) |
+| `skip_modified_gcodes` | boolean | Ignore stale custom gcodes in the 3MF |
+| `slice_plate` | number | Which plate to slice (0 = all plates, default: 0) |
+
+**Example: Slice with auto-orient and 3 copies**
+```json
+{
+  "stl_path": "/path/to/model.stl",
+  "bambu_model": "p1s",
+  "orient": true,
+  "arrange": true,
+  "repetitions": 3
+}
+```
+
+#### Smart Defaults (print_3mf auto-slice)
+
+When `print_3mf` detects an unsliced 3MF and auto-slices it, these defaults are applied automatically:
+
+- `uptodate: true` -- prevents stale config bugs from downloaded 3MFs
+- `ensure_on_bed: true` -- safety net, lifts floating models onto the bed
+- `min_save: true` -- smaller output for faster FTP uploads to the printer
+- `skip_modified_gcodes: true` -- strips custom gcodes from other users' profiles
+
+These defaults keep you safe when printing downloaded models. When calling `slice_stl` directly, you have full control over every flag.
+
 </details>
 
 <details>

package/dist/index.js

@@ -333,7 +333,25 @@ class BambuPrinterMCPServer {
                                 },
                                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env)" },
                                 slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
-                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" }
+                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
+                                uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
+                                repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
+                                orient: { type: "boolean", description: "Auto-orient the model for optimal printability (minimize supports, maximize bed adhesion). Recommended for raw STL imports that lack a pre-set orientation." },
+                                arrange: { type: "boolean", description: "Auto-arrange all objects on the build plate with optimal spacing. Recommended when importing STLs or adding multiple objects. Set false to preserve existing plate layout." },
+                                ensure_on_bed: { type: "boolean", description: "Detect models floating above the bed and lower them onto the build surface. Safety net for imported models with incorrect Z origins." },
+                                clone_objects: { type: "string", description: "Duplicate specific objects on the plate. Comma-separated clone counts per object index, e.g. '1,3,1,10' clones object 0 once, object 1 three times, etc." },
+                                skip_objects: { type: "string", description: "Skip specific objects during slicing by index. Comma-separated, e.g. '3,5,10'. Useful for multi-object 3MFs where you only want to print some parts." },
+                                load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
+                                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." },
+                                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." },
+                                rotate: { type: "number", description: "Rotate the model around the Z-axis (vertical) by this many degrees before slicing. Positive = counterclockwise when viewed from above." },
+                                rotate_x: { type: "number", description: "Rotate the model around the X-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                                rotate_y: { type: "number", description: "Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                                min_save: { type: "boolean", description: "Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer." },
+                                skip_modified_gcodes: { type: "boolean", description: "Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer." },
+                                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
                             },
                             required: ["stl_path", "bambu_model"]
                         }
@@ -599,8 +617,45 @@ class BambuPrinterMCPServer {
                         const nozzleDiam = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         // Resolve printer preset for BambuStudio slicer
                         const printerPreset = BAMBU_MODEL_PRESETS[sliceModel]?.(nozzleDiam);
+                        const sliceBambuOptions = {};
+                        if (args?.uptodate !== undefined)
+                            sliceBambuOptions.uptodate = Boolean(args.uptodate);
+                        if (args?.repetitions !== undefined)
+                            sliceBambuOptions.repetitions = Number(args.repetitions);
+                        if (args?.orient !== undefined)
+                            sliceBambuOptions.orient = Boolean(args.orient);
+                        if (args?.arrange !== undefined)
+                            sliceBambuOptions.arrange = Boolean(args.arrange);
+                        if (args?.ensure_on_bed !== undefined)
+                            sliceBambuOptions.ensureOnBed = Boolean(args.ensure_on_bed);
+                        if (args?.clone_objects !== undefined)
+                            sliceBambuOptions.cloneObjects = String(args.clone_objects);
+                        if (args?.skip_objects !== undefined)
+                            sliceBambuOptions.skipObjects = String(args.skip_objects);
+                        if (args?.load_filaments !== undefined)
+                            sliceBambuOptions.loadFilaments = String(args.load_filaments);
+                        if (args?.load_filament_ids !== undefined)
+                            sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.enable_timelapse !== undefined)
+                            sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
+                        if (args?.allow_mix_temp !== undefined)
+                            sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
+                        if (args?.scale !== undefined)
+                            sliceBambuOptions.scale = Number(args.scale);
+                        if (args?.rotate !== undefined)
+                            sliceBambuOptions.rotate = Number(args.rotate);
+                        if (args?.rotate_x !== undefined)
+                            sliceBambuOptions.rotateX = Number(args.rotate_x);
+                        if (args?.rotate_y !== undefined)
+                            sliceBambuOptions.rotateY = Number(args.rotate_y);
+                        if (args?.min_save !== undefined)
+                            sliceBambuOptions.minSave = Boolean(args.min_save);
+                        if (args?.skip_modified_gcodes !== undefined)
+                            sliceBambuOptions.skipModifiedGcodes = Boolean(args.skip_modified_gcodes);
+                        if (args?.slice_plate !== undefined)
+                            sliceBambuOptions.slicePlate = Number(args.slice_plate);
                         result = await this.stlManipulator.sliceSTL(String(args.stl_path), slicerType, slicerPath, slicerProfile || undefined, undefined, // progressCallback
-                        printerPreset);
+                        printerPreset, sliceBambuOptions);
                         break;
                     }
                     case "print_3mf": {
@@ -623,8 +678,14 @@ class BambuPrinterMCPServer {
                             const hasGcode = Object.keys(zip.files).some(f => f.match(/Metadata\/plate_\d+\.gcode/i) || f.endsWith('.gcode'));
                             if (!hasGcode) {
                                 console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
+                                const autoSliceOptions = {
+                                    uptodate: true,
+                                    ensureOnBed: true,
+                                    minSave: true,
+                                    skipModifiedGcodes: true,
+                                };
                                 threeMFPath = await this.stlManipulator.sliceSTL(threeMFPath, slicerType, slicerPath, slicerProfile || undefined, undefined, // progressCallback
-                                printPreset);
+                                printPreset, autoSliceOptions);
                                 console.log("Auto-sliced to: " + threeMFPath);
                             }
                         }

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

@@ -22,6 +22,26 @@ export type TransformationParams = {
     relative?: boolean;
     selectionBounds?: THREE.Box3;
 };
+export interface BambuSliceOptions {
+    uptodate?: boolean;
+    repetitions?: number;
+    orient?: boolean;
+    arrange?: boolean;
+    ensureOnBed?: boolean;
+    cloneObjects?: string;
+    skipObjects?: string;
+    loadFilaments?: string;
+    loadFilamentIds?: string;
+    enableTimelapse?: boolean;
+    allowMixTemp?: boolean;
+    scale?: number;
+    rotate?: number;
+    rotateX?: number;
+    rotateY?: number;
+    minSave?: boolean;
+    skipModifiedGcodes?: boolean;
+    slicePlate?: number;
+}
 export declare class STLManipulator extends EventEmitter {
     private tempDir;
     private activeOperations;
@@ -48,7 +68,17 @@ export declare class STLManipulator extends EventEmitter {
         boundingBox: BoundingBox;
         vertexCount: number;
         faceCount: number;
+        objects?: Array<{
+            name: string;
+            vertexCount: number;
+            faceCount: number;
+            boundingBox: BoundingBox;
+        }>;
     }>;
+    /**
+     * Extract mesh info from a 3MF file by parsing the XML object models.
+     */
+    private get3MFInfo;
     /**
      * Scale an STL model uniformly or along specific axes
      */
@@ -97,9 +127,10 @@ export declare class STLManipulator extends EventEmitter {
      * @param slicerProfile Optional path to the slicer profile/config file
      * @param progressCallback Optional callback for progress updates
      * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+     * @param bambuOptions Optional BambuStudio-specific CLI flags
      * @returns Path to the generated G-code or sliced 3MF file
      */
-    sliceSTL(stlFilePath: string, slicerType: 'prusaslicer' | 'cura' | 'slic3r' | 'orcaslicer' | 'bambustudio', slicerPath: string, slicerProfile?: string, progressCallback?: ProgressCallback, printerPreset?: string): Promise<string>;
+    sliceSTL(stlFilePath: string, slicerType: 'prusaslicer' | 'cura' | 'slic3r' | 'orcaslicer' | 'bambustudio', slicerPath: string, slicerProfile?: string, progressCallback?: ProgressCallback, printerPreset?: string, bambuOptions?: BambuSliceOptions): Promise<string>;
     /**
      * Enhanced version of confirmTemperatures with better error handling
      * @param gcodePath Path to the G-code file

package/dist/stl/stl-manipulator.js

@@ -85,8 +85,12 @@ export class STLManipulator extends EventEmitter {
      */
     async getSTLInfo(stlFilePath) {
         try {
-            const { geometry, boundingBox } = await this.loadSTL(stlFilePath);
             const fileStats = fs.statSync(stlFilePath);
+            // Handle 3MF files: extract mesh data from embedded object models
+            if (stlFilePath.toLowerCase().endsWith('.3mf')) {
+                return await this.get3MFInfo(stlFilePath, fileStats.size);
+            }
+            const { geometry, boundingBox } = await this.loadSTL(stlFilePath);
             // Count faces (each face is a triangle in STL)
             const positionAttribute = geometry.getAttribute('position');
             const vertexCount = positionAttribute.count;
@@ -115,6 +119,89 @@ export class STLManipulator extends EventEmitter {
             throw new Error(`Failed to get STL info: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    /**
+     * Extract mesh info from a 3MF file by parsing the XML object models.
+     */
+    async get3MFInfo(filePath, fileSize) {
+        const JSZip = (await import('jszip')).default;
+        const data = fs.readFileSync(filePath);
+        const zip = await JSZip.loadAsync(data);
+        // Find all object model files
+        const objectFiles = Object.keys(zip.files).filter((name) => /^3D\/Objects\/.*\.model$/i.test(name));
+        const overallBox = new THREE.Box3(new THREE.Vector3(Infinity, Infinity, Infinity), new THREE.Vector3(-Infinity, -Infinity, -Infinity));
+        let totalVerts = 0;
+        let totalFaces = 0;
+        const objects = [];
+        for (const objFile of objectFiles) {
+            const content = await zip.file(objFile).async('string');
+            // Parse vertices from XML: <vertex x="..." y="..." z="..."/>
+            const vertexRegex = /<(?:\w+:)?vertex\s+x="([^"]+)"\s+y="([^"]+)"\s+z="([^"]+)"/g;
+            const triangleRegex = /<(?:\w+:)?triangle\s/g;
+            const objBox = new THREE.Box3(new THREE.Vector3(Infinity, Infinity, Infinity), new THREE.Vector3(-Infinity, -Infinity, -Infinity));
+            let vCount = 0;
+            let match;
+            while ((match = vertexRegex.exec(content)) !== null) {
+                const x = parseFloat(match[1]);
+                const y = parseFloat(match[2]);
+                const z = parseFloat(match[3]);
+                objBox.expandByPoint(new THREE.Vector3(x, y, z));
+                overallBox.expandByPoint(new THREE.Vector3(x, y, z));
+                vCount++;
+            }
+            let fCount = 0;
+            while (triangleRegex.exec(content) !== null)
+                fCount++;
+            totalVerts += vCount;
+            totalFaces += fCount;
+            if (vCount > 0) {
+                const center = new THREE.Vector3();
+                objBox.getCenter(center);
+                const dims = new THREE.Vector3();
+                objBox.getSize(dims);
+                objects.push({
+                    name: path.basename(objFile),
+                    vertexCount: vCount,
+                    faceCount: fCount,
+                    boundingBox: { min: objBox.min, max: objBox.max, center, dimensions: dims },
+                });
+            }
+        }
+        // If no object files found, try the main 3dmodel.model
+        if (objects.length === 0) {
+            const mainModel = zip.file('3D/3dmodel.model');
+            if (mainModel) {
+                const content = await mainModel.async('string');
+                const vertexRegex = /<(?:\w+:)?vertex\s+x="([^"]+)"\s+y="([^"]+)"\s+z="([^"]+)"/g;
+                const triangleRegex = /<(?:\w+:)?triangle\s/g;
+                let match;
+                while ((match = vertexRegex.exec(content)) !== null) {
+                    const x = parseFloat(match[1]);
+                    const y = parseFloat(match[2]);
+                    const z = parseFloat(match[3]);
+                    overallBox.expandByPoint(new THREE.Vector3(x, y, z));
+                    totalVerts++;
+                }
+                while (triangleRegex.exec(content) !== null)
+                    totalFaces++;
+            }
+        }
+        if (totalVerts === 0) {
+            throw new Error('No mesh data found in 3MF file. The archive may not contain any 3D objects.');
+        }
+        const center = new THREE.Vector3();
+        overallBox.getCenter(center);
+        const dimensions = new THREE.Vector3();
+        overallBox.getSize(dimensions);
+        return {
+            filePath,
+            fileName: path.basename(filePath),
+            fileSize,
+            boundingBox: { min: overallBox.min, max: overallBox.max, center, dimensions },
+            vertexCount: totalVerts,
+            faceCount: totalFaces,
+            objects,
+        };
+    }
     /**
      * Scale an STL model uniformly or along specific axes
      */
@@ -651,9 +738,10 @@ export class STLManipulator extends EventEmitter {
      * @param slicerProfile Optional path to the slicer profile/config file
      * @param progressCallback Optional callback for progress updates
      * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+     * @param bambuOptions Optional BambuStudio-specific CLI flags
      * @returns Path to the generated G-code or sliced 3MF file
      */
-    async sliceSTL(stlFilePath, slicerType, slicerPath, slicerProfile, progressCallback, printerPreset) {
+    async sliceSTL(stlFilePath, slicerType, slicerPath, slicerProfile, progressCallback, printerPreset, bambuOptions) {
         const operationId = this.generateOperationId();
         this.activeOperations.set(operationId, true);
         if (!fs.existsSync(slicerPath)) {
@@ -722,19 +810,57 @@ export class STLManipulator extends EventEmitter {
                         const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
                         const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
                         args = [
-                            '--slice', '0', // Slice all plates
+                            '--slice', String(bambuOptions?.slicePlate ?? 0),
                             '--export-3mf', bambuOutputPath,
                         ];
                         if (slicerProfile) {
                             args.push('--load-settings', slicerProfile);
                         }
-                        // CRITICAL: Pass printer preset so slicer generates correct G-code
-                        // for the target printer model. Without this, the slicer uses its
-                        // default which may be a completely different printer, causing
-                        // dangerous bed crashes or axis limit violations.
+                        // Always allow newer-version 3MF files (the CLI rejects them by default)
+                        args.push('--allow-newer-file');
+                        // If a printer preset name is given AND no explicit profile was provided,
+                        // write a minimal settings JSON containing the printer_settings_id so
+                        // BambuStudio resolves the correct machine profile from its built-in presets.
                         if (printerPreset && !slicerProfile) {
-                            args.push('--load-machine', printerPreset);
+                            const presetJson = path.join(this.tempDir, '_printer_preset.json');
+                            fs.writeFileSync(presetJson, JSON.stringify({ printer_settings_id: printerPreset }));
+                            args.push('--load-settings', presetJson);
                         }
+                        // BambuSliceOptions flags
+                        if (bambuOptions?.uptodate)
+                            args.push('--uptodate');
+                        if (bambuOptions?.ensureOnBed)
+                            args.push('--ensure-on-bed');
+                        if (bambuOptions?.enableTimelapse)
+                            args.push('--enable-timelapse');
+                        if (bambuOptions?.allowMixTemp)
+                            args.push('--allow-mix-temp');
+                        if (bambuOptions?.minSave)
+                            args.push('--min-save');
+                        if (bambuOptions?.skipModifiedGcodes)
+                            args.push('--skip-modified-gcodes');
+                        if (bambuOptions?.orient !== undefined)
+                            args.push('--orient', bambuOptions.orient ? '1' : '0');
+                        if (bambuOptions?.arrange !== undefined)
+                            args.push('--arrange', bambuOptions.arrange ? '1' : '0');
+                        if (bambuOptions?.repetitions !== undefined)
+                            args.push('--repetitions', String(bambuOptions.repetitions));
+                        if (bambuOptions?.scale !== undefined)
+                            args.push('--scale', String(bambuOptions.scale));
+                        if (bambuOptions?.rotate !== undefined)
+                            args.push('--rotate', String(bambuOptions.rotate));
+                        if (bambuOptions?.rotateX !== undefined)
+                            args.push('--rotate-x', String(bambuOptions.rotateX));
+                        if (bambuOptions?.rotateY !== undefined)
+                            args.push('--rotate-y', String(bambuOptions.rotateY));
+                        if (bambuOptions?.cloneObjects)
+                            args.push('--clone-objects', bambuOptions.cloneObjects);
+                        if (bambuOptions?.skipObjects)
+                            args.push('--skip-objects', bambuOptions.skipObjects);
+                        if (bambuOptions?.loadFilaments)
+                            args.push('--load-filaments', bambuOptions.loadFilaments);
+                        if (bambuOptions?.loadFilamentIds)
+                            args.push('--load-filament-ids', bambuOptions.loadFilamentIds);
                         args.push(stlFilePath);
                         // Override outputFilePath for bambustudio since it produces 3MF, not gcode
                         outputFilePath = bambuOutputPath;

package/package.json

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

package/src/index.ts

@@ -16,7 +16,7 @@ import fs from "fs";
 import path from "path";
 import { createServer as createHttpServer, type IncomingMessage, type Server as HttpServer, type ServerResponse } from "node:http";
 import { randomUUID } from "node:crypto";
-import { STLManipulator } from "./stl/stl-manipulator.js";
+import { STLManipulator, type BambuSliceOptions } from "./stl/stl-manipulator.js";
 import { parse3MF } from './3mf_parser.js';
 import { BambuImplementation } from "./printers/bambu.js";
 
@@ -405,7 +405,25 @@ class BambuPrinterMCPServer {
                 },
                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env)" },
                 slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
-                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" }
+                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
+                uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
+                repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
+                orient: { type: "boolean", description: "Auto-orient the model for optimal printability (minimize supports, maximize bed adhesion). Recommended for raw STL imports that lack a pre-set orientation." },
+                arrange: { type: "boolean", description: "Auto-arrange all objects on the build plate with optimal spacing. Recommended when importing STLs or adding multiple objects. Set false to preserve existing plate layout." },
+                ensure_on_bed: { type: "boolean", description: "Detect models floating above the bed and lower them onto the build surface. Safety net for imported models with incorrect Z origins." },
+                clone_objects: { type: "string", description: "Duplicate specific objects on the plate. Comma-separated clone counts per object index, e.g. '1,3,1,10' clones object 0 once, object 1 three times, etc." },
+                skip_objects: { type: "string", description: "Skip specific objects during slicing by index. Comma-separated, e.g. '3,5,10'. Useful for multi-object 3MFs where you only want to print some parts." },
+                load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
+                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." },
+                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." },
+                rotate: { type: "number", description: "Rotate the model around the Z-axis (vertical) by this many degrees before slicing. Positive = counterclockwise when viewed from above." },
+                rotate_x: { type: "number", description: "Rotate the model around the X-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                rotate_y: { type: "number", description: "Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                min_save: { type: "boolean", description: "Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer." },
+                skip_modified_gcodes: { type: "boolean", description: "Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer." },
+                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
               },
               required: ["stl_path", "bambu_model"]
             }
@@ -703,11 +721,33 @@ class BambuPrinterMCPServer {
             const nozzleDiam = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             // Resolve printer preset for BambuStudio slicer
             const printerPreset = BAMBU_MODEL_PRESETS[sliceModel]?.(nozzleDiam);
+
+            const sliceBambuOptions: BambuSliceOptions = {};
+            if (args?.uptodate !== undefined) sliceBambuOptions.uptodate = Boolean(args.uptodate);
+            if (args?.repetitions !== undefined) sliceBambuOptions.repetitions = Number(args.repetitions);
+            if (args?.orient !== undefined) sliceBambuOptions.orient = Boolean(args.orient);
+            if (args?.arrange !== undefined) sliceBambuOptions.arrange = Boolean(args.arrange);
+            if (args?.ensure_on_bed !== undefined) sliceBambuOptions.ensureOnBed = Boolean(args.ensure_on_bed);
+            if (args?.clone_objects !== undefined) sliceBambuOptions.cloneObjects = String(args.clone_objects);
+            if (args?.skip_objects !== undefined) sliceBambuOptions.skipObjects = String(args.skip_objects);
+            if (args?.load_filaments !== undefined) sliceBambuOptions.loadFilaments = String(args.load_filaments);
+            if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
+            if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
+            if (args?.scale !== undefined) sliceBambuOptions.scale = Number(args.scale);
+            if (args?.rotate !== undefined) sliceBambuOptions.rotate = Number(args.rotate);
+            if (args?.rotate_x !== undefined) sliceBambuOptions.rotateX = Number(args.rotate_x);
+            if (args?.rotate_y !== undefined) sliceBambuOptions.rotateY = Number(args.rotate_y);
+            if (args?.min_save !== undefined) sliceBambuOptions.minSave = Boolean(args.min_save);
+            if (args?.skip_modified_gcodes !== undefined) sliceBambuOptions.skipModifiedGcodes = Boolean(args.skip_modified_gcodes);
+            if (args?.slice_plate !== undefined) sliceBambuOptions.slicePlate = Number(args.slice_plate);
+
             result = await this.stlManipulator.sliceSTL(
               String(args.stl_path), slicerType, slicerPath,
               slicerProfile || undefined,
               undefined, // progressCallback
-              printerPreset
+              printerPreset,
+              sliceBambuOptions
             );
             break;
           }
@@ -737,10 +777,17 @@ class BambuPrinterMCPServer {
               );
               if (!hasGcode) {
                 console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
+                const autoSliceOptions: BambuSliceOptions = {
+                  uptodate: true,
+                  ensureOnBed: true,
+                  minSave: true,
+                  skipModifiedGcodes: true,
+                };
                 threeMFPath = await this.stlManipulator.sliceSTL(
                   threeMFPath, slicerType, slicerPath, slicerProfile || undefined,
                   undefined, // progressCallback
-                  printPreset
+                  printPreset,
+                  autoSliceOptions
                 );
                 console.log("Auto-sliced to: " + threeMFPath);
               }

package/src/stl/stl-manipulator.ts

@@ -40,6 +40,28 @@ export type TransformationParams = {
   selectionBounds?: THREE.Box3;
 };
 
+// BambuStudio CLI flags exposed via the slice_stl tool
+export interface BambuSliceOptions {
+  uptodate?: boolean;          // --uptodate: update 3MF configs to latest presets
+  repetitions?: number;        // --repetitions N: print N copies
+  orient?: boolean;            // --orient 1: auto-orient for printability
+  arrange?: boolean;           // --arrange 1: auto-arrange objects on plate
+  ensureOnBed?: boolean;       // --ensure-on-bed: lift floating models onto bed
+  cloneObjects?: string;       // --clone-objects "1,3,1,10": clone counts per object
+  skipObjects?: string;        // --skip-objects "3,5,10": skip specific objects
+  loadFilaments?: string;      // --load-filaments "f1.json;f2.json": filament profiles
+  loadFilamentIds?: string;    // --load-filament-ids "1,2,3,1": filament-to-object mapping
+  enableTimelapse?: boolean;   // --enable-timelapse: timelapse-aware slicing
+  allowMixTemp?: boolean;      // --allow-mix-temp: allow mixed-temp filaments
+  scale?: number;              // --scale factor: uniform scale
+  rotate?: number;             // --rotate degrees: Z-axis rotation
+  rotateX?: number;            // --rotate-x degrees
+  rotateY?: number;            // --rotate-y degrees
+  minSave?: boolean;           // --min-save: smaller output 3MF
+  skipModifiedGcodes?: boolean;// --skip-modified-gcodes: ignore stale custom gcodes
+  slicePlate?: number;         // --slice N: which plate (default: 0 = all)
+}
+
 export class STLManipulator extends EventEmitter {
   private tempDir: string;
   private activeOperations: Map<string, boolean> = new Map();
@@ -141,23 +163,30 @@ export class STLManipulator extends EventEmitter {
     boundingBox: BoundingBox;
     vertexCount: number;
     faceCount: number;
+    objects?: Array<{ name: string; vertexCount: number; faceCount: number; boundingBox: BoundingBox }>;
   }> {
     try {
-      const { geometry, boundingBox } = await this.loadSTL(stlFilePath);
       const fileStats = fs.statSync(stlFilePath);
-      
+
+      // Handle 3MF files: extract mesh data from embedded object models
+      if (stlFilePath.toLowerCase().endsWith('.3mf')) {
+        return await this.get3MFInfo(stlFilePath, fileStats.size);
+      }
+
+      const { geometry, boundingBox } = await this.loadSTL(stlFilePath);
+
       // Count faces (each face is a triangle in STL)
       const positionAttribute = geometry.getAttribute('position');
       const vertexCount = positionAttribute.count;
       const faceCount = vertexCount / 3;
-      
+
       // Calculate center and dimensions
       const center = new THREE.Vector3();
       boundingBox.getCenter(center);
-      
+
       const dimensions = new THREE.Vector3();
       boundingBox.getSize(dimensions);
-      
+
       return {
         filePath: stlFilePath,
         fileName: path.basename(stlFilePath),
@@ -177,6 +206,115 @@ export class STLManipulator extends EventEmitter {
     }
   }
 
+  /**
+   * Extract mesh info from a 3MF file by parsing the XML object models.
+   */
+  private async get3MFInfo(filePath: string, fileSize: number): Promise<{
+    filePath: string;
+    fileName: string;
+    fileSize: number;
+    boundingBox: BoundingBox;
+    vertexCount: number;
+    faceCount: number;
+    objects: Array<{ name: string; vertexCount: number; faceCount: number; boundingBox: BoundingBox }>;
+  }> {
+    const JSZip = (await import('jszip')).default;
+    const data = fs.readFileSync(filePath);
+    const zip = await JSZip.loadAsync(data);
+
+    // Find all object model files
+    const objectFiles = Object.keys(zip.files).filter(
+      (name) => /^3D\/Objects\/.*\.model$/i.test(name)
+    );
+
+    const overallBox = new THREE.Box3(
+      new THREE.Vector3(Infinity, Infinity, Infinity),
+      new THREE.Vector3(-Infinity, -Infinity, -Infinity)
+    );
+    let totalVerts = 0;
+    let totalFaces = 0;
+    const objects: Array<{ name: string; vertexCount: number; faceCount: number; boundingBox: BoundingBox }> = [];
+
+    for (const objFile of objectFiles) {
+      const content = await zip.file(objFile)!.async('string');
+      // Parse vertices from XML: <vertex x="..." y="..." z="..."/>
+      const vertexRegex = /<(?:\w+:)?vertex\s+x="([^"]+)"\s+y="([^"]+)"\s+z="([^"]+)"/g;
+      const triangleRegex = /<(?:\w+:)?triangle\s/g;
+
+      const objBox = new THREE.Box3(
+        new THREE.Vector3(Infinity, Infinity, Infinity),
+        new THREE.Vector3(-Infinity, -Infinity, -Infinity)
+      );
+      let vCount = 0;
+      let match: RegExpExecArray | null;
+      while ((match = vertexRegex.exec(content)) !== null) {
+        const x = parseFloat(match[1]);
+        const y = parseFloat(match[2]);
+        const z = parseFloat(match[3]);
+        objBox.expandByPoint(new THREE.Vector3(x, y, z));
+        overallBox.expandByPoint(new THREE.Vector3(x, y, z));
+        vCount++;
+      }
+
+      let fCount = 0;
+      while (triangleRegex.exec(content) !== null) fCount++;
+
+      totalVerts += vCount;
+      totalFaces += fCount;
+
+      if (vCount > 0) {
+        const center = new THREE.Vector3();
+        objBox.getCenter(center);
+        const dims = new THREE.Vector3();
+        objBox.getSize(dims);
+        objects.push({
+          name: path.basename(objFile),
+          vertexCount: vCount,
+          faceCount: fCount,
+          boundingBox: { min: objBox.min, max: objBox.max, center, dimensions: dims },
+        });
+      }
+    }
+
+    // If no object files found, try the main 3dmodel.model
+    if (objects.length === 0) {
+      const mainModel = zip.file('3D/3dmodel.model');
+      if (mainModel) {
+        const content = await mainModel.async('string');
+        const vertexRegex = /<(?:\w+:)?vertex\s+x="([^"]+)"\s+y="([^"]+)"\s+z="([^"]+)"/g;
+        const triangleRegex = /<(?:\w+:)?triangle\s/g;
+        let match: RegExpExecArray | null;
+        while ((match = vertexRegex.exec(content)) !== null) {
+          const x = parseFloat(match[1]);
+          const y = parseFloat(match[2]);
+          const z = parseFloat(match[3]);
+          overallBox.expandByPoint(new THREE.Vector3(x, y, z));
+          totalVerts++;
+        }
+        while (triangleRegex.exec(content) !== null) totalFaces++;
+      }
+    }
+
+    if (totalVerts === 0) {
+      throw new Error('No mesh data found in 3MF file. The archive may not contain any 3D objects.');
+    }
+
+    const center = new THREE.Vector3();
+    overallBox.getCenter(center);
+    const dimensions = new THREE.Vector3();
+    overallBox.getSize(dimensions);
+
+    return {
+      filePath,
+      fileName: path.basename(filePath),
+      fileSize,
+      boundingBox: { min: overallBox.min, max: overallBox.max, center, dimensions },
+      vertexCount: totalVerts,
+      faceCount: totalFaces,
+      objects,
+    };
+  }
+
   /**
    * Scale an STL model uniformly or along specific axes
    */
@@ -850,6 +988,7 @@ export class STLManipulator extends EventEmitter {
    * @param slicerProfile Optional path to the slicer profile/config file
    * @param progressCallback Optional callback for progress updates
    * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+   * @param bambuOptions Optional BambuStudio-specific CLI flags
    * @returns Path to the generated G-code or sliced 3MF file
    */
   async sliceSTL(
@@ -858,7 +997,8 @@ export class STLManipulator extends EventEmitter {
     slicerPath: string,
     slicerProfile?: string,
     progressCallback?: ProgressCallback,
-    printerPreset?: string
+    printerPreset?: string,
+    bambuOptions?: BambuSliceOptions
   ): Promise<string> {
     const operationId = this.generateOperationId();
     this.activeOperations.set(operationId, true);
@@ -935,19 +1075,43 @@ export class STLManipulator extends EventEmitter {
             const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
             const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
             args = [
-              '--slice', '0',  // Slice all plates
+              '--slice', String(bambuOptions?.slicePlate ?? 0),
               '--export-3mf', bambuOutputPath,
             ];
             if (slicerProfile) {
               args.push('--load-settings', slicerProfile);
             }
-            // CRITICAL: Pass printer preset so slicer generates correct G-code
-            // for the target printer model. Without this, the slicer uses its
-            // default which may be a completely different printer, causing
-            // dangerous bed crashes or axis limit violations.
+            // Always allow newer-version 3MF files (the CLI rejects them by default)
+            args.push('--allow-newer-file');
+
+            // If a printer preset name is given AND no explicit profile was provided,
+            // write a minimal settings JSON containing the printer_settings_id so
+            // BambuStudio resolves the correct machine profile from its built-in presets.
             if (printerPreset && !slicerProfile) {
-              args.push('--load-machine', printerPreset);
+              const presetJson = path.join(this.tempDir, '_printer_preset.json');
+              fs.writeFileSync(presetJson, JSON.stringify({ printer_settings_id: printerPreset }));
+              args.push('--load-settings', presetJson);
             }
+
+            // BambuSliceOptions flags
+            if (bambuOptions?.uptodate) args.push('--uptodate');
+            if (bambuOptions?.ensureOnBed) args.push('--ensure-on-bed');
+            if (bambuOptions?.enableTimelapse) args.push('--enable-timelapse');
+            if (bambuOptions?.allowMixTemp) args.push('--allow-mix-temp');
+            if (bambuOptions?.minSave) args.push('--min-save');
+            if (bambuOptions?.skipModifiedGcodes) args.push('--skip-modified-gcodes');
+            if (bambuOptions?.orient !== undefined) args.push('--orient', bambuOptions.orient ? '1' : '0');
+            if (bambuOptions?.arrange !== undefined) args.push('--arrange', bambuOptions.arrange ? '1' : '0');
+            if (bambuOptions?.repetitions !== undefined) args.push('--repetitions', String(bambuOptions.repetitions));
+            if (bambuOptions?.scale !== undefined) args.push('--scale', String(bambuOptions.scale));
+            if (bambuOptions?.rotate !== undefined) args.push('--rotate', String(bambuOptions.rotate));
+            if (bambuOptions?.rotateX !== undefined) args.push('--rotate-x', String(bambuOptions.rotateX));
+            if (bambuOptions?.rotateY !== undefined) args.push('--rotate-y', String(bambuOptions.rotateY));
+            if (bambuOptions?.cloneObjects) args.push('--clone-objects', bambuOptions.cloneObjects);
+            if (bambuOptions?.skipObjects) args.push('--skip-objects', bambuOptions.skipObjects);
+            if (bambuOptions?.loadFilaments) args.push('--load-filaments', bambuOptions.loadFilaments);
+            if (bambuOptions?.loadFilamentIds) args.push('--load-filament-ids', bambuOptions.loadFilamentIds);
+
             args.push(stlFilePath);
             // Override outputFilePath for bambustudio since it produces 3MF, not gcode
             outputFilePath = bambuOutputPath;