mcp-3d-printer-server 1.2.29 → 1.2.30

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.2.30] – 2026-11-04
+
+### Added
+
+- `slice_stl` and `slice_with_template` take `quality` (`draft`, `standard`, `fine`) and `strength` (`standard`, `strong`, `max`). The server turns them into the slicer's own settings: Draft and Fine set the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it), Strong and Max set walls and infill (4 walls at 25%, 6 at 40%), and Standard leaves the resolved preset alone. An explicit `layer_height`, `wall_loops` or `sparse_infill_density` still wins. Clients such as Counterpart can now send the person's choice instead of carrying slicer numbers. Checked with stand-in slicers only. For PrusaSlicer, Slic3r and generic OrcaSlicer the layer height scales with `nozzle_diameter` (or `NOZZLE_DIAMETER`), which must match the profile's nozzle; Cura takes only Standard. Same change as bambu-printer-mcp 1.1.56.
+
 ## [1.2.29] – 2026-11-04
 
 ### Changed

package/README.md

@@ -688,6 +688,8 @@ Options for the Bambu-compatible path:
 | `scale`, `rotate`, `rotate_x`, `rotate_y` | Transform before slicing (uniform scale; rotations in degrees). For OrcaSlicer STL input the server applies them to a mesh copy in Orca's order to avoid a CLI crash; see [OrcaSlicer CLI limits](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/SLICING.md#bambu-compatible-slicing) |
 | `enable_timelapse`, `allow_mix_temp` | Insert timelapse parking moves; allow filaments with different temperature needs on one plate |
 
+`slice_stl` and `slice_with_template` take `quality` (`draft`, `standard`, `fine`) and `strength` (`standard`, `strong`, `max`), so a client can send the person's choice without slicer numbers. The server picks the layer height for the nozzle (0.28 and 0.12 mm on a 0.4 mm nozzle; it scales with `nozzle_diameter`, or `NOZZLE_DIAMETER` when that's not given, which for PrusaSlicer, Slic3r and generic OrcaSlicer must match the nozzle in `slicer_profile`) and the walls and infill (4 walls at 25%, 6 at 40%). Standard keeps the preset; explicit values win. Cura takes only Standard.
+
 `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.

package/dist/index.js

@@ -19,6 +19,7 @@ import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.js";
 import { STLManipulator, SUPPORT_TYPES } from "./stl/stl-manipulator.js";
 import { parsePauseLayers, readPlateGcode, pausedLayers, machinePauseGcode } from "./slicer/layer-pauses.js";
+import { PRINT_QUALITY_PROPERTIES, withPrintQuality } from "./slicer/print-quality.js";
 import { CounterpartService } from "./counterpart/service.js";
 import { CAMERA_STREAM_TOOLS } from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -306,6 +307,7 @@ const SLICE_TOOL_PROPERTIES = {
     min_save: { type: "boolean", description: "Bambu-compatible slicing: write a smaller output 3MF (--min-save)." },
     skip_modified_gcodes: { type: "boolean", description: "Bambu-compatible slicing: ignore custom G-code embedded in an input 3MF (--skip-modified-gcodes)." },
     slice_plate: { type: "number", description: "Bambu-compatible slicing: plate number to slice; 0 slices all plates (default)." },
+    ...PRINT_QUALITY_PROPERTIES,
     layer_height: {
         type: "number", exclusiveMinimum: 0, maximum: 2,
         description: "Layer height in mm, written over the selected process profile (Orca/Bambu Studio layer_height; PrusaSlicer --layer-height). Not mapped for Cura.",
@@ -748,7 +750,7 @@ class ThreeDPrinterMCPServer {
         if (!args?.stl_path) {
             throw new Error("Missing required parameter: stl_path");
         }
-        const processOverrides = parseProcessOverrides(args);
+        const processOverrides = parseProcessOverrides(withPrintQuality(args, Number(args.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER)));
         const slicerType = normalizeSlicerType(String(args.slicer_type || DEFAULT_SLICER_TYPE));
         const explicitModel = typeof args.bambu_model === "string" && args.bambu_model.trim() ? args.bambu_model : undefined;
         // Generic OrcaSlicer keeps its user-supplied machine profile unless the

package/dist/slicer/print-quality.d.ts

@@ -0,0 +1,26 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export declare const PRINT_QUALITIES: readonly ["draft", "standard", "fine"];
+export declare const PRINT_STRENGTHS: readonly ["standard", "strong", "max"];
+export type PrintQuality = (typeof PRINT_QUALITIES)[number];
+export type PrintStrength = (typeof PRINT_STRENGTHS)[number];
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export declare function withPrintQuality(args: Record<string, unknown>, nozzleDiameter?: number): Record<string, unknown>;
+/** slice_stl input-schema properties for both arguments. */
+export declare const PRINT_QUALITY_PROPERTIES: {
+    readonly quality: {
+        readonly type: "string";
+        readonly enum: readonly ["draft", "standard", "fine"];
+        readonly description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.";
+    };
+    readonly strength: {
+        readonly type: "string";
+        readonly enum: readonly ["standard", "strong", "max"];
+        readonly description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.";
+    };
+};

package/dist/slicer/print-quality.js

@@ -0,0 +1,53 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export const PRINT_QUALITIES = ["draft", "standard", "fine"];
+export const PRINT_STRENGTHS = ["standard", "strong", "max"];
+/** Layer heights on the reference 0.4 mm nozzle; other nozzles scale from it. */
+const REFERENCE_NOZZLE_MM = 0.4;
+const LAYER_MM_ON_REFERENCE = { draft: 0.28, fine: 0.12 };
+const STRENGTH = {
+    strong: { wall_loops: 4, sparse_infill_density: "25%" },
+    max: { wall_loops: 6, sparse_infill_density: "40%" },
+};
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export function withPrintQuality(args, nozzleDiameter) {
+    if (args.quality === undefined && args.strength === undefined)
+        return args;
+    const quality = args.quality === undefined ? "standard" : args.quality;
+    const strength = args.strength === undefined ? "standard" : args.strength;
+    if (typeof quality !== "string" || !PRINT_QUALITIES.includes(quality)) {
+        throw new Error(`quality must be one of ${PRINT_QUALITIES.join(", ")}.`);
+    }
+    if (typeof strength !== "string" || !PRINT_STRENGTHS.includes(strength)) {
+        throw new Error(`strength must be one of ${PRINT_STRENGTHS.join(", ")}.`);
+    }
+    const out = { ...args };
+    const scale = typeof nozzleDiameter === "number" && Number.isFinite(nozzleDiameter) && nozzleDiameter > 0 ? nozzleDiameter / REFERENCE_NOZZLE_MM : 1;
+    const layer = LAYER_MM_ON_REFERENCE[quality];
+    if (layer !== undefined && out.layer_height === undefined)
+        out.layer_height = Math.round(layer * scale * 100) / 100;
+    const walls = STRENGTH[strength];
+    if (walls) {
+        if (out.wall_loops === undefined)
+            out.wall_loops = walls.wall_loops;
+        if (out.sparse_infill_density === undefined)
+            out.sparse_infill_density = walls.sparse_infill_density;
+    }
+    return out;
+}
+/** slice_stl input-schema properties for both arguments. */
+export const PRINT_QUALITY_PROPERTIES = {
+    quality: {
+        type: "string", enum: [...PRINT_QUALITIES],
+        description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.",
+    },
+    strength: {
+        type: "string", enum: [...PRINT_STRENGTHS],
+        description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.",
+    },
+};

package/dist/stl/stl-manipulator.js

@@ -1019,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, sparse_infill_density and the support settings are not mapped for Cura; set them in the Cura definition passed as slicer_profile.', { slicerType, slicerPath });
+                            throw new SlicerError('preparation', 'quality, strength, 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.29",
+    "version": "1.2.30",
     "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.29",
+  "version": "1.2.30",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcp-3d-printer-server",
-      "version": "1.2.29",
+      "version": "1.2.30",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/index.ts

@@ -36,6 +36,7 @@ import * as THREE from 'three';
 import { PrinterFactory } from "./printers/printer-factory.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 { PRINT_QUALITY_PROPERTIES, withPrintQuality } from "./slicer/print-quality.js";
 import { CounterpartService, type BambuControlRoute, type PrinterTarget } from "./counterpart/service.js";
 import {CAMERA_STREAM_TOOLS} from "./counterpart/camera-tools.js";
 import { annotateTools } from "./tool-annotations.js";
@@ -384,6 +385,7 @@ const SLICE_TOOL_PROPERTIES = {
   min_save: { type: "boolean", description: "Bambu-compatible slicing: write a smaller output 3MF (--min-save)." },
   skip_modified_gcodes: { type: "boolean", description: "Bambu-compatible slicing: ignore custom G-code embedded in an input 3MF (--skip-modified-gcodes)." },
   slice_plate: { type: "number", description: "Bambu-compatible slicing: plate number to slice; 0 slices all plates (default)." },
+  ...PRINT_QUALITY_PROPERTIES,
   layer_height: {
     type: "number", exclusiveMinimum: 0, maximum: 2,
     description: "Layer height in mm, written over the selected process profile (Orca/Bambu Studio layer_height; PrusaSlicer --layer-height). Not mapped for Cura.",
@@ -904,7 +906,7 @@ class ThreeDPrinterMCPServer {
     if (!args?.stl_path) {
       throw new Error("Missing required parameter: stl_path");
     }
-    const processOverrides = parseProcessOverrides(args);
+    const processOverrides = parseProcessOverrides(withPrintQuality(args, Number(args.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER)));
     const slicerType = normalizeSlicerType(String(args.slicer_type || DEFAULT_SLICER_TYPE));
     const explicitModel =
       typeof args.bambu_model === "string" && args.bambu_model.trim() ? args.bambu_model : undefined;

package/src/slicer/print-quality.ts

@@ -0,0 +1,55 @@
+/**
+ * slice_stl's `quality` and `strength` (PRD §8.4): a client's print-sheet choice, mapped here to the
+ * slicer's own numbers so no client carries layer heights, wall counts or infill. Draft and Fine set
+ * the layer height for the nozzle in use (0.28 and 0.12 mm on a 0.4 mm nozzle, scaled with it); Strong
+ * and Max set walls and infill. Standard sends nothing: the resolved preset decides. An explicit
+ * layer_height, wall_loops or sparse_infill_density in the same call wins over these.
+ */
+export const PRINT_QUALITIES = ["draft", "standard", "fine"] as const;
+export const PRINT_STRENGTHS = ["standard", "strong", "max"] as const;
+
+export type PrintQuality = (typeof PRINT_QUALITIES)[number];
+export type PrintStrength = (typeof PRINT_STRENGTHS)[number];
+
+/** Layer heights on the reference 0.4 mm nozzle; other nozzles scale from it. */
+const REFERENCE_NOZZLE_MM = 0.4;
+const LAYER_MM_ON_REFERENCE: Partial<Record<PrintQuality, number>> = { draft: 0.28, fine: 0.12 };
+const STRENGTH: Partial<Record<PrintStrength, { wall_loops: number; sparse_infill_density: string }>> = {
+  strong: { wall_loops: 4, sparse_infill_density: "25%" },
+  max: { wall_loops: 6, sparse_infill_density: "40%" },
+};
+
+/** The call's arguments with `quality` and `strength` written out as slicer settings. */
+export function withPrintQuality(args: Record<string, unknown>, nozzleDiameter?: number): Record<string, unknown> {
+  if (args.quality === undefined && args.strength === undefined) return args;
+  const quality = args.quality === undefined ? "standard" : args.quality;
+  const strength = args.strength === undefined ? "standard" : args.strength;
+  if (typeof quality !== "string" || !(PRINT_QUALITIES as readonly string[]).includes(quality)) {
+    throw new Error(`quality must be one of ${PRINT_QUALITIES.join(", ")}.`);
+  }
+  if (typeof strength !== "string" || !(PRINT_STRENGTHS as readonly string[]).includes(strength)) {
+    throw new Error(`strength must be one of ${PRINT_STRENGTHS.join(", ")}.`);
+  }
+  const out: Record<string, unknown> = { ...args };
+  const scale = typeof nozzleDiameter === "number" && Number.isFinite(nozzleDiameter) && nozzleDiameter > 0 ? nozzleDiameter / REFERENCE_NOZZLE_MM : 1;
+  const layer = LAYER_MM_ON_REFERENCE[quality as PrintQuality];
+  if (layer !== undefined && out.layer_height === undefined) out.layer_height = Math.round(layer * scale * 100) / 100;
+  const walls = STRENGTH[strength as PrintStrength];
+  if (walls) {
+    if (out.wall_loops === undefined) out.wall_loops = walls.wall_loops;
+    if (out.sparse_infill_density === undefined) out.sparse_infill_density = walls.sparse_infill_density;
+  }
+  return out;
+}
+
+/** slice_stl input-schema properties for both arguments. */
+export const PRINT_QUALITY_PROPERTIES = {
+  quality: {
+    type: "string", enum: [...PRINT_QUALITIES],
+    description: "Print quality: draft (thicker layers, faster), standard (the preset's own layer height) or fine (thinner layers). The server picks the layer height for the nozzle in use; an explicit layer_height wins.",
+  },
+  strength: {
+    type: "string", enum: [...PRINT_STRENGTHS],
+    description: "Part strength: standard (the preset's walls and infill), strong or max (more walls and denser infill). The server picks the values; explicit wall_loops or sparse_infill_density win.",
+  },
+} as const;

package/src/stl/stl-manipulator.ts

@@ -1317,7 +1317,7 @@ export class STLManipulator extends EventEmitter {
           case 'cura':
             if (Object.keys(orcaProcessOverrides(processOverrides)).length) {
               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.',
+                'quality, strength, 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