bambu-printer-mcp 1.1.10 → 1.1.12

package/CONTRIBUTORS.md

@@ -19,7 +19,7 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 Thank you also to the existing contributors whose work the project builds on:
 
-- [David Montgomery (DMontgomery40)](https://github.com/DMontgomery40) — project maintainer.
+- [David Montgomery (DMontgomery40)](https://github.com/DMontgomery40) — project maintainer; flags the FULU/Orca missing-machine-preset safety gap during article review, prompting the 1.1.11 fix.
 - [rowbotik](https://github.com/rowbotik) — printer, AMS, slicing, and operational work across the existing release history.
 - [len-foss](https://github.com/len-foss) — project code contribution.
 - [thebitrock](https://github.com/thebitrock) — project code contribution.

package/README.md

@@ -13,6 +13,8 @@
 
 A Bambu Lab-focused MCP server for controlling Bambu printers, manipulating STL files, and managing end-to-end 3MF print workflows from Claude Desktop, Claude Code, or any MCP-compatible client.
 
+**[Browse the documentation site](https://dmontgomery40.github.io/bambu-printer-mcp/)** for searchable setup guides, slicing and AMS guidance, and the full tool reference. It is generated from this README and the docs folder.
+
 Built with help from our [contributors](./CONTRIBUTORS.md). Huge thanks to everyone sharing fixes, careful bug reports, and real printer testing!
 
 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.
@@ -43,8 +45,8 @@ or tokens in chat. Never guess the printer model.
 
 Use direct LAN printing by default. Explain any LAN/Developer Mode setting
 I need to enable. Prefer FULU OrcaSlicer-bambulab GUI slicing/export; discover
-an existing slicer before suggesting an install. Do not configure FULU/Orca
-CLI auto-slicing while its machine-preset safety gate is missing (see guide).
+an existing slicer before suggesting an install. For FULU/Orca CLI auto-slicing,
+require MCP 1.1.11+ and its matching installed profile tree (see guide).
 A slicer is not needed here to print a pre-sliced file. Configure the optional FULU
 BambuNetwork bridge only if I choose it, and explain its runtime/auth needs.
 X2D supports status and slicing here, but direct printing is not supported.
@@ -60,6 +62,43 @@ worked and whether I need to restart or reload the harness.
 
 [Setup reference](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SETUP.md) · [FULU guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md) · [Optional code mode](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SETUP.md#optional-code-mode)
 
+## What to ask your agent
+
+Ask for the result you want, not the steps. Current models plan across tools: they search the web, read photos, look up exact dimensions, edit models, slice, and print. Expect a question or two when a choice matters, such as which filament to use or whether to start the print.
+
+This server provides the printer, slicing, AMS, and mesh tools. Web search, photos, and Blender edits come from your agent and its other connections, such as a [Blender MCP server](#blender-mcp). Printing a model your agent edited uses CLI slicing with your installed slicer presets; see the [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md).
+
+### Start from anything
+
+- **"Here's a phone stand on MakerWorld. Make it fit the new iPhone and print it in black."**\
+  Your agent looks up Apple's published dimensions, adjusts the stand in Blender, slices it for your printer, and finds the AMS tray with black filament.
+- **"I want one of these."** *(with a photo of a planter you saw at a café)*\
+  It works out the shape and size from the photo, finds or models a matching design, and asks about anything the photo can't show.
+- **"Can you print a replacement?"** *(with a photo of a snapped dishwasher rack clip)*\
+  It asks for a measurement or two where the fit matters, models the part, and prints it in a loaded material that suits the job.
+
+### From anywhere, while it prints
+
+If your agent is always on, such as OpenClaw or Hermes Agent running on a computer at home, message it from Telegram or any other chat app. For direct LAN printing, the server runs on the printer's local network; you don't have to.
+
+- **"How's the print going? Send me a picture."**\
+  It reports progress and time remaining, and sends a snapshot from the chamber camera.
+- **"The corner is lifting. Pause it."**\
+  It pauses the job so you can decide whether to resume or cancel.
+- **"One of the parts came loose. Skip it and keep printing the rest."**\
+  It finds that object on the plate and skips only that one.
+- **"Start drying the PETG so it's ready when I get home."**\
+  On a heated AMS, it starts the drying cycle for the unit holding that spool.
+
+### Before you print
+
+- **"Take a picture and make sure the bed is clear, then start the bracket I sliced last night."**\
+  It checks the camera image before it sends the job.
+- **"What's loaded in the AMS? Print this in whatever black I have."**\
+  It reads the live AMS inventory and matches the file's filaments to your trays.
+- **"Are there any errors on the printer?"**\
+  It reads the printer's HMS diagnostics and explains them.
+
 <details>
 <summary><strong>Start here</strong></summary>
 
@@ -69,6 +108,7 @@ worked and whether I need to restart or reload the harness.
 |---|---|
 | Use open-source slicing and a cloud-free print workflow | [FULU setup: slicer, LAN, and optional bridge](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md) |
 | Connect this MCP to my agent | [Copy the setup request](#set-up-with-your-agent) |
+| See what my agent can do with it | [What to ask your agent](#what-to-ask-your-agent) |
 | Troubleshoot setup or configure it manually | [Installation, environment variables, and LAN reference](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SETUP.md) |
 | Prepare a printable file or troubleshoot slicing | [Slicing guide and model routing](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md) |
 | Choose filament trays or inspect a printer | [AMS setup](#ams-automatic-material-system-setup) and [printer tools](#printer-control-tools) |
@@ -96,6 +136,7 @@ See the [changelog](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main
 - [FULU and open-source printing](#fulu-and-open-source-printing)
 - [Features](#features)
 - [Set up with your agent](#set-up-with-your-agent)
+- [What to ask your agent](#what-to-ask-your-agent)
 - [AMS (Automatic Material System) Setup](#ams-automatic-material-system-setup)
 - [Bambu Communication Notes (MQTT and FTP)](#bambu-communication-notes-mqtt-and-ftp)
   - [What this fork fixes](#what-this-fork-fixes)
@@ -106,7 +147,6 @@ See the [changelog](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main
   - [Slicing Tools](#slicing-tools)
   - [Advanced Tools](#advanced-tools)
 - [Available Resources](#available-resources)
-- [Example Commands for Claude](#example-commands-for-claude)
 - [Bambu Lab Printer Limitations](#bambu-lab-printer-limitations)
 - [General Limitations and Considerations](#general-limitations-and-considerations)
   - [Memory usage](#memory-usage)
@@ -137,7 +177,7 @@ See the [changelog](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main
 
 ## FULU and open-source printing
 
-[FULU OrcaSlicer-bambulab](https://github.com/FULU-Foundation/OrcaSlicer-bambulab) is a supported slicer target (`SLICER_TYPE=orcaslicer-bambulab`; aliases include `fulu-orca` and `orca-studio`). Use its GUI to export a sliced project for direct LAN printing. FULU/Orca CLI aliases are recognized, but **do not use them for unattended slicing or auto-slicing** while the [machine-preset safety gate is missing](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
+[FULU OrcaSlicer-bambulab](https://github.com/FULU-Foundation/OrcaSlicer-bambulab) is a supported slicer target (`SLICER_TYPE=orcaslicer-bambulab`; aliases include `fulu-orca` and `orca-studio`). Use its GUI to export a sliced project for direct LAN printing, or configure its CLI with matching installed profiles. From 1.1.11, FULU/Orca share the [machine-preset gate and profile safety checks](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
 
 The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`, `bambu_network_call`, and `print_3mf_bambu_network`, also reachable through `print_3mf` with `connection_mode: "bambu_network"`. Slicer selection does not enable the bridge. It needs a separately installed FULU runtime and an explicit launch command; cloud printing also needs an authenticated BambuNetwork session.
 
@@ -169,7 +209,7 @@ The optional FULU **BambuNetwork bridge** exposes `bambu_network_bridge_status`,
 - Start G-code files already stored on the printer
 - **Collar charm print wrapper** (`print_collar_charm`) — specialized two-color workflow with fixed tray policy for inner (black, AMS 1 slot 1) and outer (white, AMS 2 slot 1) charm parts
 - STL manipulation: scale, rotate, extend base, merge vertices, center at origin, lay flat, and inspect model info
-- Slice STL or 3MF files using an external CLI. For Bambu headless workflows, use the validated BambuStudio profile path; FULU/Orca users should [GUI-export while the CLI safety limitation remains](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
+- Slice STL or 3MF files using an external CLI. BambuStudio, FULU, and Orca require the exact machine preset and resolve BBL dependencies before slicing; see [FULU/Orca CLI setup and validation limits](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
 - Inspect slicer settings from a saved 3MF template or extracted profile via `get_slice_settings`
 - Enumerate saved slicing templates from the local registry via `list_templates`
 - Save templates into the local registry via `save_template`
@@ -856,7 +896,7 @@ The primary tool for starting a Bambu print. **Recommended input: a pre-sliced `
 }
 ```
 
-`bambu_model` is **required** for model-specific routing and preset selection. It does not by itself validate the G-code or guarantee matching output from the FULU/Orca CLI; use GUI-exported sliced projects for those slicers while the machine-preset gate is missing. Using the wrong model can damage hardware. If `bambu_model` is not provided in the tool call and `BAMBU_MODEL` is not set in the environment, the server will ask you interactively via MCP elicitation (if your client supports it) or return a clear error.
+`bambu_model` is **required** for model-specific routing and preset selection. It does not by itself validate pre-sliced G-code. BambuStudio, FULU, and Orca CLI preparation additionally require the exact model/nozzle machine preset and reject incomplete profiles. Using the wrong model can damage hardware. If `bambu_model` is not provided in the tool call and `BAMBU_MODEL` is not set in the environment, the server will ask you interactively via MCP elicitation (if your client supports it) or return a clear error.
 
 `bed_type` defaults to `textured_plate` if omitted. `ams_slots` is the preferred override input; `ams_mapping` remains the raw escape hatch. On AMS-equipped H2 printers, `use_ams: false` does not suppress mapping lookup if the sliced file declares filaments. If no mapping is provided for an H2 pre-sliced job with declared filaments, the server fails before sending; pass explicit `ams_slots`, raw `ams_mapping`, or `auto_match_ams: true`.
 
@@ -1015,7 +1055,7 @@ Slice an STL or 3MF file using an external slicer and return the path to the out
 
 `slicer_type` options: `bambustudio`, `orcaslicer`, `orcaslicer-bambulab` (FULU), `prusaslicer`, `cura`, `slic3r`. Aliases include `fulu-orca` and `orca-studio`. When omitted, the value from the `SLICER_TYPE` environment variable is used (default: `bambustudio`).
 
-**FULU/Orca CLI limitation:** recognized slicer names do not guarantee that a missing machine preset is rejected. Use GUI-exported sliced projects instead of those CLI backends until the [machine-preset gate is implemented](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
+**FULU/Orca CLI safety:** from 1.1.11, these backends require the exact model/nozzle preset from the selected installation and stop on profile preparation failures. A process override cannot bypass that gate. See [configuration and validation limits](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/FULU.md#fulu-and-orca-cli-safety-limit).
 
 `slicer_path` and `slicer_profile` fall back to the `SLICER_PATH` and `SLICER_PROFILE` environment variables when omitted. Per-call `slicer_path` overrides require `MCP_ALLOW_EXECUTABLE_ARG=1`.
 
@@ -1165,62 +1205,6 @@ Resources follow the MCP resource protocol and can be read by calling `ReadResou
 
 </details>
 
-<details>
-<summary><strong>Example Commands for Claude</strong></summary>
-
-## Example Commands for Claude
-
-After connecting the MCP server in Claude Desktop or Claude Code, you can ask Claude to perform these operations directly in conversation.
-
-### Printer status and control
-
-- "What is the current status of my Bambu printer?"
-- "What temperature is the bed at right now?"
-- "Show me the files on my printer's SD card."
-- "Cancel the current print job."
-- "Set the nozzle temperature to 220 degrees."
-- "Set the bed to 65 degrees."
-- "Turn the chamber light on."
-- "Set the chamber fan to 40 percent."
-- "List the object IDs in this sliced 3MF."
-- "Skip object 6495 on the current print."
-- "Start the AMS drying cycle on AMS 0."
-- "Stop drying on AMS 1."
-- "Match the AMS slots for this 3MF against my loaded filaments without printing."
-- "Auto-match AMS slots and print this 3MF."
-- "Take a camera snapshot of the print bed."
-- "Show me the HMS error codes on the printer."
-- "What speed mode is the printer in?"
-- "Set the airduct to cooling mode."
-
-### Printing 3MF files
-
-- "Print the file at ~/Downloads/bracket.3mf on my Bambu printer."
-- "Upload bracket.3mf to the printer and start printing with AMS slots 0 and 1."
-- "Print my_model.3mf with bed leveling enabled and vibration calibration off."
-- "Upload this 3MF without printing it yet."
-- "Use FULU OrcaSlicer-bambulab to prepare this model, then show me the sliced output before printing."
-- "Probe the FULU BambuNetwork bridge without starting a print."
-
-### STL manipulation
-
-- "What are the dimensions of this STL file?"
-- "Scale model.stl to twice its current size."
-- "Scale this model so it is 150% as wide but stays the same height."
-- "Rotate this STL 90 degrees around the Z axis."
-- "Extend the base of this model by 3mm so it sticks to the bed better."
-- "Center this model at the origin."
-- "Orient this model so its largest flat face is on the bottom."
-- "Merge any near-duplicate vertices in this STL to clean it up."
-
-### Combined workflows
-
-- "Rotate model.stl 45 degrees around Z, extend the base by 2mm, then print it on my Bambu P1S."
-- "Take this unsliced 3MF, slice it with BambuStudio, and print the result."
-- "Scale this part to 80% of its size, lay it flat, and start a print."
-
-</details>
-
 <details>
 <summary><strong>Bambu Lab Printer Limitations</strong></summary>
 
@@ -1228,7 +1212,7 @@ After connecting the MCP server in Claude Desktop or Claude Code, you can ask Cl
 
 Understanding these constraints will help you avoid frustrating errors and set appropriate expectations.
 
-1. **Printable 3MF required for print_3mf.** The `print_3mf` tool expects a sliced 3MF containing at least one `Metadata/plate_<n>.gcode` entry. If you pass an unsliced 3MF (one exported from a CAD tool without slicing), the server attempts auto-slicing. Use the validated BambuStudio CLI path for that; FULU/Orca users must supply GUI-exported sliced files while their CLI preset gate is missing — any inspection or slicing failure stops before upload. For a previewable workflow, pre-slice in FULU OrcaSlicer-bambulab, OrcaSlicer, or Bambu Studio and pass the resulting `.gcode.3mf`. See [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md) for the full procedure.
+1. **Printable 3MF required for print_3mf.** The `print_3mf` tool expects a sliced 3MF containing at least one `Metadata/plate_<n>.gcode` entry. If you pass an unsliced 3MF (one exported from a CAD tool without slicing), the server attempts auto-slicing. BambuStudio, FULU, and Orca CLI paths require the matching machine preset and complete profile preparation; any inspection or slicing failure stops before upload. For a previewable workflow, pre-slice in FULU OrcaSlicer-bambulab, OrcaSlicer, or Bambu Studio and pass the resulting `.gcode.3mf`. See [slicing guide](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/docs/SLICING.md) for the full procedure.
 
 2. **Layer height, temperature, and slicer settings are baked in.** The `project_file` MQTT command tells the printer which plate to run. It does not support overriding layer height, temperature targets, infill percentage, or other slicing parameters at print time. These must be set in your slicer before generating the 3MF.
 

package/dist/index.js

@@ -1599,7 +1599,7 @@ class BambuPrinterMCPServer {
                                     description: "Type of slicer to use. Bambu-compatible choices (bambustudio, orcaslicer, orcaslicer-bambulab) export sliced 3MF; aliases such as fulu-orca and orca-studio are accepted."
                                 },
                                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env). Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
-                                slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
+                                slicer_profile: { type: "string", description: "Path to an optional process profile/config file. The exact bambu_model/nozzle machine preset is still required." },
                                 template_3mf_path: { type: "string", description: "Optional template 3MF whose embedded Bambu slicer settings should be reused when slicing a new STL or 3MF." },
                                 template_name: { type: "string", description: "Optional named template from the local registry. Resolves to template_3mf_path automatically." },
                                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },

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

@@ -49,6 +49,8 @@ export interface FlattenOptions {
     filamentLeaves: string[];
     /** Absolute path to `.../Resources/profiles`. */
     profilesRoot: string;
+    /** Configured BBL directories for custom process/filament dependencies only. */
+    userProfileRoots?: string[];
     /** Where to write flattened temp files. */
     tempDir: string;
     /** Vendor subdir under profilesRoot. Currently only "BBL" supported. */
@@ -82,6 +84,8 @@ export interface FlattenOptions {
         wipe_tower_y?: unknown;
     };
 }
+/** Resolve bundled machine defaults before choosing process and filament leaves. */
+export declare function resolveBblMachineProfile(profilesRoot: string, machineLeaf: string): Promise<Record<string, 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";
@@ -97,4 +101,4 @@ export declare function flattenForCli(opts: FlattenOptions): Promise<FlattenedPr
  *
  * Override via BAMBU_PROFILES_ROOT env.
  */
-export declare function detectProfilesRoot(slicerPath?: string): string;
+export declare function detectProfilesRoot(slicerPath?: string, slicerType?: string): string;

package/dist/slicer/profile-flatten.js

@@ -39,11 +39,14 @@ import crypto from "node:crypto";
  * abstract bases like `fdm_machine_common` and `fdm_bbl_3dp_001_common`,
  * because those are the parents we'll walk to.
  */
-async function buildNameIndex(profilesRoot, vendor) {
+async function buildNameIndex(profilesRoot, vendor, userProfileRoots = []) {
     const index = new Map();
     const subdirs = ["machine", "process", "filament"];
-    for (const sub of subdirs) {
-        const dir = path.join(profilesRoot, vendor, sub);
+    const directories = [
+        ...subdirs.map(sub => path.join(profilesRoot, vendor, sub)),
+        ...userProfileRoots.flatMap(root => ['process', 'filament'].map(sub => path.join(root, sub))),
+    ];
+    for (const dir of directories) {
         let entries;
         try {
             entries = await fs.readdir(dir);
@@ -72,6 +75,8 @@ async function buildNameIndex(profilesRoot, vendor) {
                 // Malformed profile -- skip, don't poison the index.
                 continue;
             }
+            if (!data || typeof data !== 'object' || Array.isArray(data))
+                continue;
             const name = data["name"];
             if (typeof name !== "string" || name.length === 0)
                 continue;
@@ -123,6 +128,10 @@ function flattenData(data, index, visiting = new Set()) {
     delete merged["include"];
     return merged;
 }
+/** Resolve bundled machine defaults before choosing process and filament leaves. */
+export async function resolveBblMachineProfile(profilesRoot, machineLeaf) {
+    return flattenByName(machineLeaf, await buildNameIndex(profilesRoot, 'BBL'));
+}
 /** Keys of an include template that describe the template, not the config. */
 const INCLUDE_METADATA_KEYS = new Set(["name", "type", "from", "instantiation", "inherits", "include", "setting_id"]);
 /**
@@ -514,14 +523,18 @@ export async function flattenForCli(opts) {
         throw new Error(`profile-flatten: profilesRoot "${opts.profilesRoot}" does not contain "${vendor}/machine". ` +
             `Set BAMBU_PROFILES_ROOT or check your BambuStudio install.`);
     }
-    const index = await buildNameIndex(opts.profilesRoot, vendor);
+    // Machine inheritance must never resolve through user process/filament files.
+    const machineIndex = await buildNameIndex(opts.profilesRoot, vendor);
+    const index = opts.userProfileRoots?.length
+        ? await buildNameIndex(opts.profilesRoot, vendor, opts.userProfileRoots)
+        : machineIndex;
     // Flatten each leaf.
     if (opts.sourceProfiles?.filaments && opts.sourceProfiles.filaments.length !== opts.filamentLeaves.length) {
         throw new Error("Every filament slot must have a source profile.");
     }
     const machineFlat = opts.sourceProfiles?.machine
-        ? flattenData(opts.sourceProfiles.machine, index)
-        : flattenByName(opts.machineLeaf, index);
+        ? flattenData(opts.sourceProfiles.machine, machineIndex)
+        : flattenByName(opts.machineLeaf, machineIndex);
     const processFlat = opts.sourceProfiles?.process
         ? flattenData(opts.sourceProfiles.process, index)
         : flattenByName(opts.processLeaf, index);
@@ -531,7 +544,7 @@ export async function flattenForCli(opts) {
     });
     // CLI-specific post-processing on machine profile only.
     deriveNozzleVolumeType(machineFlat, opts.nozzleVolumeType);
-    applyMachineModelBedMetadata(machineFlat, index);
+    applyMachineModelBedMetadata(machineFlat, machineIndex);
     // A standalone custom machine can accompany process/filament profiles that
     // need BBL resolution; do not impose bundled model config on that machine.
     const sourceMachine = opts.sourceProfiles?.machine;
@@ -603,7 +616,7 @@ async function writeTemp(tempDir, kind, leafName, data) {
  *
  * Override via BAMBU_PROFILES_ROOT env.
  */
-export function detectProfilesRoot(slicerPath) {
+export function detectProfilesRoot(slicerPath, slicerType = 'bambustudio') {
     if (process.env["BAMBU_PROFILES_ROOT"]) {
         return process.env["BAMBU_PROFILES_ROOT"];
     }
@@ -622,14 +635,18 @@ export function detectProfilesRoot(slicerPath) {
         }
         catch { /* Probe the supplied path below. */ }
         const bin = path.dirname(executable);
+        const installNames = slicerType === 'bambustudio'
+            ? ['BambuStudio', 'bambu-studio']
+            : ['OrcaSlicer', 'orca-slicer', 'OrcaStudio', 'orca-studio'];
         const candidates = path.basename(bin) === 'MacOS'
             ? [path.resolve(bin, '..', 'Resources', 'profiles')]
             : [
                 path.join(bin, 'resources', 'profiles'),
                 path.join(bin, 'Resources', 'profiles'),
-                path.resolve(bin, '..', 'share', 'BambuStudio', 'profiles'),
-                path.resolve(bin, '..', 'share', 'bambu-studio', 'profiles'),
-                path.resolve(bin, '..', 'share', 'BambuStudio', 'resources', 'profiles'),
+                ...installNames.flatMap(name => [
+                    path.resolve(bin, '..', 'share', name, 'profiles'),
+                    path.resolve(bin, '..', 'share', name, 'resources', 'profiles'),
+                ]),
             ];
         const found = candidates.find(root => existsSync(path.join(root, 'BBL', 'machine')));
         // Do not select another installation if this executable has no profile tree.
@@ -637,5 +654,7 @@ export function detectProfilesRoot(slicerPath) {
         return found ?? candidates[0];
     }
     // Default macOS install.
-    return "/Applications/BambuStudio.app/Contents/Resources/profiles";
+    return slicerType === 'bambustudio'
+        ? '/Applications/BambuStudio.app/Contents/Resources/profiles'
+        : '/Applications/OrcaSlicer.app/Contents/Resources/profiles';
 }

package/dist/stl/stl-manipulator.js

@@ -9,7 +9,7 @@ import { promisify } from 'util';
 import { EventEmitter } from 'events';
 import * as crypto from 'crypto';
 import { execFile } from 'child_process';
-import { flattenForCli, detectProfilesRoot } from '../slicer/profile-flatten.js';
+import { flattenForCli, detectProfilesRoot, resolveBblMachineProfile } from '../slicer/profile-flatten.js';
 const readFileAsync = promisify(fs.readFile);
 const writeFileAsync = promisify(fs.writeFile);
 const BAMBU_PROFILE_ROOTS = [
@@ -206,16 +206,31 @@ export class STLManipulator extends EventEmitter {
         fs.writeFileSync(outPath, serialized);
         return outPath;
     }
-    resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, activeProfilesRoot) {
+    async resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, activeProfilesRoot) {
         const roots = activeProfilesRoot
-            ? [path.join(activeProfilesRoot, 'BBL'), ...this.getAvailableProfileRoots()]
+            ? [path.join(activeProfilesRoot, 'BBL')]
             : this.getAvailableProfileRoots();
-        const findProfile = (kind, name) => this.findProfileFile(kind, name, roots);
+        const findProfile = (kind, name) => this.findProfileFile(kind, name, kind === 'machine' ? roots : [...roots, ...configuredBambuProfileDirs()]);
+        if (!printerPreset) {
+            throw new Error('Printer preset is required for Bambu-compatible CLI slicing; select the exact bambu_model and nozzle_diameter.');
+        }
         const machinePath = findProfile('machine', printerPreset);
-        if (slicerType === 'bambustudio' && printerPreset && !machinePath) {
-            throw new Error(`Printer profile "${printerPreset}" was not found. Set BAMBU_PROFILES_ROOT to the matching BambuStudio profile tree; refusing to use printer defaults.`);
+        if (!machinePath) {
+            throw new Error(`Printer profile "${printerPreset}" was not found. Set BAMBU_PROFILES_ROOT to the matching ${slicerType} profile tree; refusing to use printer defaults.`);
+        }
+        let machineConfig;
+        try {
+            machineConfig = this.readJsonFile(machinePath);
+            if (!machineConfig || Array.isArray(machineConfig) || machineConfig.name !== printerPreset) {
+                throw new Error('expected a JSON machine profile with the selected preset name');
+            }
         }
-        const machineConfig = machinePath ? this.readJsonFile(machinePath) : null;
+        catch (error) {
+            throw new Error(`Printer profile "${printerPreset}" is invalid: ${error?.message ?? error}`);
+        }
+        // Some FULU/Orca machine leaves inherit their default process/filaments.
+        // Resolve those selections before building the positional CLI bundle.
+        machineConfig = await resolveBblMachineProfile(activeProfilesRoot ?? path.dirname(path.dirname(path.dirname(machinePath))), printerPreset);
         const hasSlicerProfile = !!slicerProfile && fs.existsSync(slicerProfile);
         const filamentPaths = [];
         let processPath;
@@ -267,7 +282,7 @@ export class STLManipulator extends EventEmitter {
                 }
             }
             if (!bambuOptions?.loadFilaments && filamentPaths.length === 0 && Array.isArray(parsedProfile.filament_ids)) {
-                const filamentIdIndex = this.buildFilamentIdIndex(roots);
+                const filamentIdIndex = this.buildFilamentIdIndex([...roots, ...configuredBambuProfileDirs()]);
                 for (const filamentId of parsedProfile.filament_ids) {
                     const filamentPath = filamentIdIndex.get(String(filamentId));
                     if (filamentPath) {
@@ -324,7 +339,7 @@ export class STLManipulator extends EventEmitter {
         };
     }
     /** Resolve BBL dependencies before invoking the CLI; failures stop the slice. */
-    async maybeFlattenBundle(bundle, bambuOptions, activeSlicerPath) {
+    async maybeFlattenBundle(bundle, bambuOptions, activeProfilesRoot) {
         const parts = bundle.settingsArg?.split(';').filter(Boolean) ?? [];
         const readProfile = (filePath) => {
             try {
@@ -341,8 +356,8 @@ export class STLManipulator extends EventEmitter {
         const settings = parts.map(readProfile);
         // Read every slot: filtering unreadable names would change positional mapping.
         const filaments = bundle.filamentPaths.map(readProfile);
-        const profilesRoot = detectProfilesRoot(activeSlicerPath || process.env.SLICER_PATH);
-        const profileRoots = [path.join(profilesRoot, 'BBL'), ...this.getAvailableProfileRoots()];
+        const profilesRoot = activeProfilesRoot ?? detectProfilesRoot(process.env.SLICER_PATH);
+        const profileRoots = [path.join(profilesRoot, 'BBL')];
         const hasReferences = (profile) => (typeof profile.inherits === 'string' && profile.inherits.length > 0) ||
             (profile.include !== undefined && profile.include !== null);
         const isBundledFile = (filePath) => profileRoots.some(root => {
@@ -380,6 +395,7 @@ export class STLManipulator extends EventEmitter {
                 : leafName(processPath, processProfile),
             filamentLeaves: filaments.map((profile, i) => leafName(bundle.filamentPaths[i], profile)),
             profilesRoot,
+            userProfileRoots: configuredBambuProfileDirs(),
             tempDir: this.tempDir,
             bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
             filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
@@ -1222,11 +1238,16 @@ export class STLManipulator extends EventEmitter {
                         const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
                         const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
                         const outputDir = path.dirname(bambuOutputPath);
-                        const rawBundle = this.resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, slicerType === 'bambustudio' ? detectProfilesRoot(slicerPath) : undefined);
+                        const profilesRoot = detectProfilesRoot(slicerPath, slicerType);
+                        const rawBundle = await this.resolveBambuLikeSettingsBundle(outputBase, slicerType, slicerProfile, printerPreset, bambuOptions, profilesRoot);
                         // Resolve every BBL dependency before launching the slicer.
-                        const settingsBundle = slicerType === 'bambustudio'
-                            ? await this.maybeFlattenBundle(await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, slicerPath)
-                            : rawBundle;
+                        const settingsBundle = await this.maybeFlattenBundle(await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, profilesRoot);
+                        // Inherited process G-code is now present; apply Orca's existing
+                        // absolute-extrusion normalization after resolving those ancestors.
+                        if (slicerType === 'orcaslicer' && settingsBundle.settingsArg) {
+                            const [machinePath, processPath] = settingsBundle.settingsArg.split(';');
+                            settingsBundle.settingsArg = [machinePath, this.writeTempJson(outputBase, 'process_orca_resolved', this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset))].join(';');
+                        }
                         args = [
                             '--slice', String(bambuOptions?.slicePlate ?? 0),
                             '--outputdir', outputDir,

package/package.json

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

package/src/index.ts

@@ -2095,7 +2095,7 @@ class BambuPrinterMCPServer {
                   description: "Type of slicer to use. Bambu-compatible choices (bambustudio, orcaslicer, orcaslicer-bambulab) export sliced 3MF; aliases such as fulu-orca and orca-studio are accepted."
                 },
                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env). Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
-                slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
+                slicer_profile: { type: "string", description: "Path to an optional process profile/config file. The exact bambu_model/nozzle machine preset is still required." },
                 template_3mf_path: { type: "string", description: "Optional template 3MF whose embedded Bambu slicer settings should be reused when slicing a new STL or 3MF." },
                 template_name: { type: "string", description: "Optional named template from the local registry. Resolves to template_3mf_path automatically." },
                 template_dir: { type: "string", description: "Optional template directory override when resolving template_name." },

package/src/slicer/profile-flatten.ts

@@ -57,6 +57,8 @@ export interface FlattenOptions {
   filamentLeaves: string[];
   /** Absolute path to `.../Resources/profiles`. */
   profilesRoot: string;
+  /** Configured BBL directories for custom process/filament dependencies only. */
+  userProfileRoots?: string[];
   /** Where to write flattened temp files. */
   tempDir: string;
   /** Vendor subdir under profilesRoot. Currently only "BBL" supported. */
@@ -110,13 +112,17 @@ type NameIndex = Map<string, IndexedProfile>;
  */
 async function buildNameIndex(
   profilesRoot: string,
-  vendor: string
+  vendor: string,
+  userProfileRoots: string[] = []
 ): Promise<NameIndex> {
   const index: NameIndex = new Map();
   const subdirs: ProfileKind[] = ["machine", "process", "filament"];
 
-  for (const sub of subdirs) {
-    const dir = path.join(profilesRoot, vendor, sub);
+  const directories = [
+    ...subdirs.map(sub => path.join(profilesRoot, vendor, sub)),
+    ...userProfileRoots.flatMap(root => ['process', 'filament'].map(sub => path.join(root, sub))),
+  ];
+  for (const dir of directories) {
     let entries: string[];
     try {
       entries = await fs.readdir(dir);
@@ -141,6 +147,7 @@ async function buildNameIndex(
         // Malformed profile -- skip, don't poison the index.
         continue;
       }
+      if (!data || typeof data !== 'object' || Array.isArray(data)) continue;
       const name = data["name"];
       if (typeof name !== "string" || name.length === 0) continue;
       // First-write wins. BBL doesn't have name collisions in practice;
@@ -203,6 +210,14 @@ function flattenData(
   return merged;
 }
 
+/** Resolve bundled machine defaults before choosing process and filament leaves. */
+export async function resolveBblMachineProfile(
+  profilesRoot: string,
+  machineLeaf: string
+): Promise<Record<string, unknown>> {
+  return flattenByName(machineLeaf, await buildNameIndex(profilesRoot, 'BBL'));
+}
+
 /** Keys of an include template that describe the template, not the config. */
 const INCLUDE_METADATA_KEYS = new Set(["name", "type", "from", "instantiation", "inherits", "include", "setting_id"]);
 
@@ -644,15 +659,19 @@ export async function flattenForCli(opts: FlattenOptions): Promise<FlattenedProf
     );
   }
 
-  const index = await buildNameIndex(opts.profilesRoot, vendor);
+  // Machine inheritance must never resolve through user process/filament files.
+  const machineIndex = await buildNameIndex(opts.profilesRoot, vendor);
+  const index = opts.userProfileRoots?.length
+    ? await buildNameIndex(opts.profilesRoot, vendor, opts.userProfileRoots)
+    : machineIndex;
 
   // Flatten each leaf.
   if (opts.sourceProfiles?.filaments && opts.sourceProfiles.filaments.length !== opts.filamentLeaves.length) {
     throw new Error("Every filament slot must have a source profile.");
   }
   const machineFlat = opts.sourceProfiles?.machine
-    ? flattenData(opts.sourceProfiles.machine, index)
-    : flattenByName(opts.machineLeaf, index);
+    ? flattenData(opts.sourceProfiles.machine, machineIndex)
+    : flattenByName(opts.machineLeaf, machineIndex);
   const processFlat = opts.sourceProfiles?.process
     ? flattenData(opts.sourceProfiles.process, index)
     : flattenByName(opts.processLeaf, index);
@@ -663,7 +682,7 @@ export async function flattenForCli(opts: FlattenOptions): Promise<FlattenedProf
 
   // CLI-specific post-processing on machine profile only.
   deriveNozzleVolumeType(machineFlat, opts.nozzleVolumeType);
-  applyMachineModelBedMetadata(machineFlat, index);
+  applyMachineModelBedMetadata(machineFlat, machineIndex);
   // A standalone custom machine can accompany process/filament profiles that
   // need BBL resolution; do not impose bundled model config on that machine.
   const sourceMachine = opts.sourceProfiles?.machine;
@@ -751,7 +770,7 @@ async function writeTemp(
  *
  * Override via BAMBU_PROFILES_ROOT env.
  */
-export function detectProfilesRoot(slicerPath?: string): string {
+export function detectProfilesRoot(slicerPath?: string, slicerType = 'bambustudio'): string {
   if (process.env["BAMBU_PROFILES_ROOT"]) {
     return process.env["BAMBU_PROFILES_ROOT"];
   }
@@ -767,14 +786,18 @@ export function detectProfilesRoot(slicerPath?: string): string {
     // Package-manager launchers may be symlinks into the installation prefix.
     try { executable = realpathSync(executable); } catch { /* Probe the supplied path below. */ }
     const bin = path.dirname(executable);
+    const installNames = slicerType === 'bambustudio'
+      ? ['BambuStudio', 'bambu-studio']
+      : ['OrcaSlicer', 'orca-slicer', 'OrcaStudio', 'orca-studio'];
     const candidates = path.basename(bin) === 'MacOS'
       ? [path.resolve(bin, '..', 'Resources', 'profiles')]
       : [
           path.join(bin, 'resources', 'profiles'),
           path.join(bin, 'Resources', 'profiles'),
-          path.resolve(bin, '..', 'share', 'BambuStudio', 'profiles'),
-          path.resolve(bin, '..', 'share', 'bambu-studio', 'profiles'),
-          path.resolve(bin, '..', 'share', 'BambuStudio', 'resources', 'profiles'),
+          ...installNames.flatMap(name => [
+            path.resolve(bin, '..', 'share', name, 'profiles'),
+            path.resolve(bin, '..', 'share', name, 'resources', 'profiles'),
+          ]),
         ];
     const found = candidates.find(root => existsSync(path.join(root, 'BBL', 'machine')));
     // Do not select another installation if this executable has no profile tree.
@@ -783,5 +806,7 @@ export function detectProfilesRoot(slicerPath?: string): string {
   }
 
   // Default macOS install.
-  return "/Applications/BambuStudio.app/Contents/Resources/profiles";
+  return slicerType === 'bambustudio'
+    ? '/Applications/BambuStudio.app/Contents/Resources/profiles'
+    : '/Applications/OrcaSlicer.app/Contents/Resources/profiles';
 }

package/src/stl/stl-manipulator.ts

@@ -9,7 +9,7 @@ import { promisify } from 'util';
 import { EventEmitter } from 'events';
 import * as crypto from 'crypto';
 import { execFile } from 'child_process';
-import { flattenForCli, detectProfilesRoot } from '../slicer/profile-flatten.js';
+import { flattenForCli, detectProfilesRoot, resolveBblMachineProfile } from '../slicer/profile-flatten.js';
 
 const readFileAsync = promisify(fs.readFile);
 const writeFileAsync = promisify(fs.writeFile);
@@ -324,24 +324,39 @@ export class STLManipulator extends EventEmitter {
     return outPath;
   }
 
-  private resolveBambuLikeSettingsBundle(
+  private async resolveBambuLikeSettingsBundle(
     outputBase: string,
     slicerType: 'orcaslicer' | 'orcaslicer-bambulab' | 'bambustudio',
     slicerProfile?: string,
     printerPreset?: string,
     bambuOptions?: BambuSliceOptions,
     activeProfilesRoot?: string
-  ): BambuSettingsBundle {
+  ): Promise<BambuSettingsBundle> {
     const roots = activeProfilesRoot
-      ? [path.join(activeProfilesRoot, 'BBL'), ...this.getAvailableProfileRoots()]
+      ? [path.join(activeProfilesRoot, 'BBL')]
       : this.getAvailableProfileRoots();
     const findProfile = (kind: 'machine' | 'process' | 'filament', name?: string) =>
-      this.findProfileFile(kind, name, roots);
+      this.findProfileFile(kind, name, kind === 'machine' ? roots : [...roots, ...configuredBambuProfileDirs()]);
+    if (!printerPreset) {
+      throw new Error('Printer preset is required for Bambu-compatible CLI slicing; select the exact bambu_model and nozzle_diameter.');
+    }
     const machinePath = findProfile('machine', printerPreset);
-    if (slicerType === 'bambustudio' && printerPreset && !machinePath) {
-      throw new Error(`Printer profile "${printerPreset}" was not found. Set BAMBU_PROFILES_ROOT to the matching BambuStudio profile tree; refusing to use printer defaults.`);
+    if (!machinePath) {
+      throw new Error(`Printer profile "${printerPreset}" was not found. Set BAMBU_PROFILES_ROOT to the matching ${slicerType} profile tree; refusing to use printer defaults.`);
     }
-    const machineConfig = machinePath ? this.readJsonFile(machinePath) : null;
+    let machineConfig: any;
+    try {
+      machineConfig = this.readJsonFile(machinePath);
+      if (!machineConfig || Array.isArray(machineConfig) || machineConfig.name !== printerPreset) {
+        throw new Error('expected a JSON machine profile with the selected preset name');
+      }
+    } catch (error: any) {
+      throw new Error(`Printer profile "${printerPreset}" is invalid: ${error?.message ?? error}`);
+    }
+    // Some FULU/Orca machine leaves inherit their default process/filaments.
+    // Resolve those selections before building the positional CLI bundle.
+    machineConfig = await resolveBblMachineProfile(
+      activeProfilesRoot ?? path.dirname(path.dirname(path.dirname(machinePath))), printerPreset);
     const hasSlicerProfile = !!slicerProfile && fs.existsSync(slicerProfile);
     const filamentPaths: string[] = [];
 
@@ -405,7 +420,7 @@ export class STLManipulator extends EventEmitter {
       }
 
       if (!bambuOptions?.loadFilaments && filamentPaths.length === 0 && Array.isArray(parsedProfile.filament_ids)) {
-        const filamentIdIndex = this.buildFilamentIdIndex(roots);
+        const filamentIdIndex = this.buildFilamentIdIndex([...roots, ...configuredBambuProfileDirs()]);
         for (const filamentId of parsedProfile.filament_ids) {
           const filamentPath = filamentIdIndex.get(String(filamentId));
           if (filamentPath) {
@@ -477,7 +492,7 @@ export class STLManipulator extends EventEmitter {
   private async maybeFlattenBundle(
     bundle: BambuSettingsBundle,
     bambuOptions?: BambuSliceOptions,
-    activeSlicerPath?: string
+    activeProfilesRoot?: string
   ): Promise<BambuSettingsBundle> {
     const parts = bundle.settingsArg?.split(';').filter(Boolean) ?? [];
     const readProfile = (filePath: string): Record<string, unknown> => {
@@ -494,8 +509,8 @@ export class STLManipulator extends EventEmitter {
     const settings = parts.map(readProfile);
     // Read every slot: filtering unreadable names would change positional mapping.
     const filaments = bundle.filamentPaths.map(readProfile);
-    const profilesRoot = detectProfilesRoot(activeSlicerPath || process.env.SLICER_PATH);
-    const profileRoots = [path.join(profilesRoot, 'BBL'), ...this.getAvailableProfileRoots()];
+    const profilesRoot = activeProfilesRoot ?? detectProfilesRoot(process.env.SLICER_PATH);
+    const profileRoots = [path.join(profilesRoot, 'BBL')];
     const hasReferences = (profile: Record<string, unknown>) =>
       (typeof profile.inherits === 'string' && profile.inherits.length > 0) ||
       (profile.include !== undefined && profile.include !== null);
@@ -537,6 +552,7 @@ export class STLManipulator extends EventEmitter {
         : leafName(processPath, processProfile),
       filamentLeaves: filaments.map((profile, i) => leafName(bundle.filamentPaths[i], profile)),
       profilesRoot,
+      userProfileRoots: configuredBambuProfileDirs(),
       tempDir: this.tempDir,
       bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
       filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
@@ -1591,19 +1607,27 @@ export class STLManipulator extends EventEmitter {
             const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
             const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
             const outputDir = path.dirname(bambuOutputPath);
-            const rawBundle = this.resolveBambuLikeSettingsBundle(
+            const profilesRoot = detectProfilesRoot(slicerPath, slicerType);
+            const rawBundle = await this.resolveBambuLikeSettingsBundle(
               outputBase,
               slicerType,
               slicerProfile,
               printerPreset,
               bambuOptions,
-              slicerType === 'bambustudio' ? detectProfilesRoot(slicerPath) : undefined
+              profilesRoot
             );
             // Resolve every BBL dependency before launching the slicer.
-            const settingsBundle = slicerType === 'bambustudio'
-              ? await this.maybeFlattenBundle(
-                  await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, slicerPath)
-              : rawBundle;
+            const settingsBundle = await this.maybeFlattenBundle(
+              await this.expandProjectFilaments(stlFilePath, rawBundle), bambuOptions, profilesRoot);
+            // Inherited process G-code is now present; apply Orca's existing
+            // absolute-extrusion normalization after resolving those ancestors.
+            if (slicerType === 'orcaslicer' && settingsBundle.settingsArg) {
+              const [machinePath, processPath] = settingsBundle.settingsArg.split(';');
+              settingsBundle.settingsArg = [machinePath, this.writeTempJson(
+                outputBase, 'process_orca_resolved',
+                this.sanitizeProcessForOrca(this.readJsonFile(processPath), printerPreset)
+              )].join(';');
+            }
             args = [
               '--slice', String(bambuOptions?.slicePlate ?? 0),
               '--outputdir', outputDir,