mcp-3d-printer-server 1.2.27 → 1.2.28

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.2.28] – 2026-11-04
+
+### Added
+
+- `slice_stl` takes `enable_support`, `support_type` (`normal(auto)`, `tree(auto)`, `normal(manual)`, `tree(manual)`) and `support_threshold_angle`, written over the selected process profile like `layer_height` and `wall_loops`. Bambu Studio and OrcaSlicer only; PrusaSlicer and Cura refuse them. Tested with the fake Bambu Studio CLI install; bambu-printer-mcp 1.1.54 checks the same keys against the installed Bambu Studio 02.08.02.61. No printer was involved.
+
 ## [1.2.27] – 2026-11-04
 
 ### Added

package/README.md

@@ -690,6 +690,8 @@ Options for the Bambu-compatible path:
 
 `layer_height` (mm), `wall_loops` (a whole number), and `sparse_infill_density` (such as `"15%"`) are written over the selected profile on every slicer: as the process keys `layer_height`, `wall_loops`, and `sparse_infill_density` for Bambu Studio and OrcaSlicer, and as `--layer-height`, `--perimeters`, and `--fill-density` for PrusaSlicer and Slic3r. They win over a template. Cura refuses them; set them in its definition file. Your profile files are never modified.
 
+`enable_support` (true or false), `support_type` (`normal(auto)`, `tree(auto)`, `normal(manual)` or `tree(manual)`) and `support_threshold_angle` (0 to 90 degrees; 0 lets the slicer decide) are written over the selected process profile as the same-named Bambu Studio and OrcaSlicer keys. PrusaSlicer, Slic3r and Cura refuse them; set supports in their own profile.
+
 Generic slicers keep their own profile formats: PrusaSlicer and Slic3r load one exported config, plus an optional filament preset `.ini` from `load_filaments`, and generic OrcaSlicer takes `machine.json;process.json`, optionally followed by `|filament.json`. `slicer_type`, `slicer_profile`, and `filament_profile` fall back to `SLICER_TYPE`, `SLICER_PROFILE`, and `FILAMENT_PROFILE`. The slicer executable comes from `SLICER_PATH`; a per-call `slicer_path` requires `MCP_ALLOW_EXECUTABLE_ARG=1`. See the [slicing guide](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/SLICING.md#bambu-compatible-slicing).
 
 #### slice_with_template

package/dist/index.js

@@ -17,7 +17,7 @@ import { createServer as createHttpServer } from "node:http";
 import { randomUUID } from "node:crypto";
 import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
-import { STLManipulator } from "./stl/stl-manipulator.js";
+import { STLManipulator, SUPPORT_TYPES } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
@@ -318,6 +318,12 @@ const SLICE_TOOL_PROPERTIES = {
         type: "string",
         description: "Sparse infill density such as \"15%\" (0–100%), written over the selected process profile (Orca/Bambu Studio sparse_infill_density; PrusaSlicer --fill-density). Not mapped for Cura.",
     },
+    enable_support: { type: "boolean", description: "Turn support generation on or off (Orca/Bambu Studio enable_support), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+    support_type: { type: "string", enum: [...SUPPORT_TYPES], description: "Support style (Orca/Bambu Studio support_type), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+    support_threshold_angle: {
+        type: "integer", minimum: 0, maximum: 90,
+        description: "Overhang threshold in degrees for automatic supports (Orca/Bambu Studio support_threshold_angle; 0 lets the slicer decide). Bambu Studio and OrcaSlicer only.",
+    },
 };
 /**
  * upload_gcode / start_print results name the remote file that was stored or
@@ -348,7 +354,7 @@ const OUTPUT_SCHEMA_TOOLS = new Set([
     "camera_stream_start", "camera_frame", "camera_stream_stop",
     "fusion_mcp_status", "fusion_mcp_call", "fusion_mcp_new_design", "fusion_mcp_export",
 ]);
-/** layer_height / wall_loops / sparse_infill_density (PRD §8.4), validated before slicing. */
+/** layer_height / wall_loops / sparse_infill_density / support settings (PRD §8.4), validated before slicing. */
 function parseProcessOverrides(args) {
     const overrides = {};
     if (args?.layer_height !== undefined) {
@@ -375,6 +381,25 @@ function parseProcessOverrides(args) {
         }
         overrides.sparseInfillDensity = `${value}%`;
     }
+    if (args?.enable_support !== undefined) {
+        if (typeof args.enable_support !== "boolean")
+            throw new Error("Invalid enable_support: expected true or false.");
+        overrides.enableSupport = args.enable_support;
+    }
+    if (args?.support_type !== undefined) {
+        const value = args.support_type;
+        if (typeof value !== "string" || !SUPPORT_TYPES.includes(value)) {
+            throw new Error(`Invalid support_type: expected one of ${SUPPORT_TYPES.join(", ")}.`);
+        }
+        overrides.supportType = value;
+    }
+    if (args?.support_threshold_angle !== undefined) {
+        const value = args.support_threshold_angle;
+        if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > 90) {
+            throw new Error("Invalid support_threshold_angle: expected an integer number of degrees from 0 to 90.");
+        }
+        overrides.supportThresholdAngle = value;
+    }
     return overrides;
 }
 function validateSliceBambuModel(model) {

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

@@ -15,7 +15,14 @@ export interface ProcessOverrides {
     wallLoops?: number;
     /** e.g. "15%" */
     sparseInfillDensity?: string;
+    enableSupport?: boolean;
+    /** normal(auto), tree(auto), normal(manual) or tree(manual) */
+    supportType?: string;
+    /** degrees, 0-90 */
+    supportThresholdAngle?: number;
 }
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export declare const SUPPORT_TYPES: readonly ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"];
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
 export declare function orcaProcessOverrides(overrides: ProcessOverrides | undefined): Record<string, string>;
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */

package/dist/stl/stl-manipulator.js

@@ -13,6 +13,16 @@ import { BambuCliProfilePreparer, assertSlicedProjectOutput, bambuCliFailureReas
 import { runSlicerProcess } from '../slicer/run-slicer.js';
 import { SlicerError, asPreparationError } from '../slicer/slicer-error.js';
 import { customGcodesWithPauses, layerTops, machinePauseGcode, pausedLayers, readPlateGcode, readProjectCustomGcodes } from '../slicer/layer-pauses.js';
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export const SUPPORT_TYPES = ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"];
+/** Support overrides only Bambu Studio and OrcaSlicer take; PrusaSlicer and Cura refuse them. */
+function supportOverrideNames(overrides) {
+    return [
+        overrides?.enableSupport !== undefined ? "enable_support" : "",
+        overrides?.supportType !== undefined ? "support_type" : "",
+        overrides?.supportThresholdAngle !== undefined ? "support_threshold_angle" : "",
+    ].filter(Boolean);
+}
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
 export function orcaProcessOverrides(overrides) {
     const keys = {};
@@ -22,10 +32,19 @@ export function orcaProcessOverrides(overrides) {
         keys.wall_loops = String(overrides.wallLoops);
     if (overrides?.sparseInfillDensity !== undefined)
         keys.sparse_infill_density = overrides.sparseInfillDensity;
+    if (overrides?.enableSupport !== undefined)
+        keys.enable_support = overrides.enableSupport ? "1" : "0";
+    if (overrides?.supportType !== undefined)
+        keys.support_type = overrides.supportType;
+    if (overrides?.supportThresholdAngle !== undefined)
+        keys.support_threshold_angle = String(overrides.supportThresholdAngle);
     return keys;
 }
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */
 export function prusaSlicerOverrideArgs(overrides) {
+    const unsupported = supportOverrideNames(overrides);
+    if (unsupported.length)
+        throw new Error(`${unsupported.join(", ")} apply to Bambu Studio and OrcaSlicer only; set them in the PrusaSlicer config passed as slicer_profile.`);
     const args = [];
     if (overrides?.layerHeight !== undefined)
         args.push('--layer-height', String(overrides.layerHeight));
@@ -1000,7 +1019,7 @@ export class STLManipulator extends EventEmitter {
                         break;
                     case 'cura':
                         if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
-                            throw new SlicerError('preparation', 'layer_height, wall_loops and sparse_infill_density are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
+                            throw new SlicerError('preparation', 'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
                         }
                         // CuraEngine CLI args are different, often requiring -s for settings
                         // Example: curaengine slice -v -j cura_settings.json -s layer_height=0.2 -o output.gcode -l input.stl

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.27",
+    "version": "1.2.28",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/DMontgomery40/mcp-3D-printer-server",
     "source": "github"
   },
-  "version": "1.2.27",
+  "version": "1.2.28",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.27",
+      "version": "1.2.28",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/index.ts

@@ -34,7 +34,7 @@ import { createServer as createHttpServer, type IncomingMessage, type Server as
 import { randomUUID } from "node:crypto";
 import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
-import { STLManipulator, type BambuSliceOptions, type ProcessOverrides, type SliceOutput } from "./stl/stl-manipulator.js";
+import { STLManipulator, SUPPORT_TYPES, type BambuSliceOptions, type ProcessOverrides, type SliceOutput } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
 import { CounterpartService, type BambuControlRoute, type PrinterTarget } from "./counterpart/service.js";
 import {CAMERA_STREAM_TOOLS} from "./counterpart/camera-tools.js";
@@ -396,6 +396,12 @@ const SLICE_TOOL_PROPERTIES = {
     type: "string",
     description: "Sparse infill density such as \"15%\" (0–100%), written over the selected process profile (Orca/Bambu Studio sparse_infill_density; PrusaSlicer --fill-density). Not mapped for Cura.",
   },
+  enable_support: { type: "boolean", description: "Turn support generation on or off (Orca/Bambu Studio enable_support), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+  support_type: { type: "string", enum: [...SUPPORT_TYPES], description: "Support style (Orca/Bambu Studio support_type), written over the selected process profile. Bambu Studio and OrcaSlicer only." },
+  support_threshold_angle: {
+    type: "integer", minimum: 0, maximum: 90,
+    description: "Overhang threshold in degrees for automatic supports (Orca/Bambu Studio support_threshold_angle; 0 lets the slicer decide). Bambu Studio and OrcaSlicer only.",
+  },
 };
 
 /**
@@ -428,7 +434,7 @@ const OUTPUT_SCHEMA_TOOLS = new Set([
   "fusion_mcp_status", "fusion_mcp_call", "fusion_mcp_new_design", "fusion_mcp_export",
 ]);
 
-/** layer_height / wall_loops / sparse_infill_density (PRD §8.4), validated before slicing. */
+/** layer_height / wall_loops / sparse_infill_density / support settings (PRD §8.4), validated before slicing. */
 function parseProcessOverrides(args: Record<string, unknown> | undefined): ProcessOverrides {
   const overrides: ProcessOverrides = {};
   if (args?.layer_height !== undefined) {
@@ -455,6 +461,24 @@ function parseProcessOverrides(args: Record<string, unknown> | undefined): Proce
     }
     overrides.sparseInfillDensity = `${value}%`;
   }
+  if (args?.enable_support !== undefined) {
+    if (typeof args.enable_support !== "boolean") throw new Error("Invalid enable_support: expected true or false.");
+    overrides.enableSupport = args.enable_support;
+  }
+  if (args?.support_type !== undefined) {
+    const value = args.support_type;
+    if (typeof value !== "string" || !(SUPPORT_TYPES as readonly string[]).includes(value)) {
+      throw new Error(`Invalid support_type: expected one of ${SUPPORT_TYPES.join(", ")}.`);
+    }
+    overrides.supportType = value;
+  }
+  if (args?.support_threshold_angle !== undefined) {
+    const value = args.support_threshold_angle;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > 90) {
+      throw new Error("Invalid support_threshold_angle: expected an integer number of degrees from 0 to 90.");
+    }
+    overrides.supportThresholdAngle = value;
+  }
   return overrides;
 }
 

package/src/stl/stl-manipulator.ts

@@ -36,6 +36,23 @@ export interface ProcessOverrides {
   wallLoops?: number;
   /** e.g. "15%" */
   sparseInfillDensity?: string;
+  enableSupport?: boolean;
+  /** normal(auto), tree(auto), normal(manual) or tree(manual) */
+  supportType?: string;
+  /** degrees, 0-90 */
+  supportThresholdAngle?: number;
+}
+
+/** Bambu Studio's and OrcaSlicer's support_type values. */
+export const SUPPORT_TYPES = ["normal(auto)", "tree(auto)", "normal(manual)", "tree(manual)"] as const;
+
+/** Support overrides only Bambu Studio and OrcaSlicer take; PrusaSlicer and Cura refuse them. */
+function supportOverrideNames(overrides: ProcessOverrides | undefined): string[] {
+  return [
+    overrides?.enableSupport !== undefined ? "enable_support" : "",
+    overrides?.supportType !== undefined ? "support_type" : "",
+    overrides?.supportThresholdAngle !== undefined ? "support_threshold_angle" : "",
+  ].filter(Boolean);
 }
 
 /** Orca/Bambu Studio process keys; profile JSON values are strings. */
@@ -44,11 +61,16 @@ export function orcaProcessOverrides(overrides: ProcessOverrides | undefined): R
   if (overrides?.layerHeight !== undefined) keys.layer_height = String(overrides.layerHeight);
   if (overrides?.wallLoops !== undefined) keys.wall_loops = String(overrides.wallLoops);
   if (overrides?.sparseInfillDensity !== undefined) keys.sparse_infill_density = overrides.sparseInfillDensity;
+  if (overrides?.enableSupport !== undefined) keys.enable_support = overrides.enableSupport ? "1" : "0";
+  if (overrides?.supportType !== undefined) keys.support_type = overrides.supportType;
+  if (overrides?.supportThresholdAngle !== undefined) keys.support_threshold_angle = String(overrides.supportThresholdAngle);
   return keys;
 }
 
 /** PrusaSlicer/Slic3r command-line options, which override the loaded config. */
 export function prusaSlicerOverrideArgs(overrides: ProcessOverrides | undefined): string[] {
+  const unsupported = supportOverrideNames(overrides);
+  if (unsupported.length) throw new Error(`${unsupported.join(", ")} apply to Bambu Studio and OrcaSlicer only; set them in the PrusaSlicer config passed as slicer_profile.`);
   const args: string[] = [];
   if (overrides?.layerHeight !== undefined) args.push('--layer-height', String(overrides.layerHeight));
   if (overrides?.wallLoops !== undefined) args.push('--perimeters', String(overrides.wallLoops));
@@ -1295,7 +1317,7 @@ export class STLManipulator extends EventEmitter {
           case 'cura':
             if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
               throw new SlicerError('preparation',
-                'layer_height, wall_loops and sparse_infill_density are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
+                'layer_height, wall_loops, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.',
                 { slicerType, slicerPath });
             }
             // CuraEngine CLI args are different, often requiring -s for settings