bambu-printer-mcp 1.1.6 → 1.1.9

package/src/index.ts

@@ -13,6 +13,7 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import dotenv from "dotenv";
 import fs from "fs";
+import os from "node:os";
 import path from "path";
 import { createServer as createHttpServer, type IncomingMessage, type Server as HttpServer, type ServerResponse } from "node:http";
 import { randomUUID } from "node:crypto";
@@ -24,10 +25,11 @@ import {
   type SlicerType,
 } from "./stl/stl-manipulator.js";
 import { BambuNetworkBridge, type BambuNetworkBridgeOptions } from "./bambu-network-bridge.js";
+import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
 import type { ThreeMFAmsRequirements } from "./types.js";
-import { BambuImplementation } from "./printers/bambu.js";
+import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 
 dotenv.config();
 
@@ -36,7 +38,23 @@ const DEFAULT_BAMBU_SERIAL = process.env.BAMBU_PRINTER_SERIAL || process.env.BAM
 const DEFAULT_BAMBU_TOKEN =
   process.env.BAMBU_PRINTER_ACCESS_TOKEN || process.env.BAMBU_TOKEN || "";
 const DEFAULT_BAMBU_DEV_ID = process.env.BAMBU_DEV_ID || DEFAULT_BAMBU_SERIAL;
-const TEMP_DIR = process.env.TEMP_DIR || path.join(process.cwd(), "temp");
+// os.tmpdir(), not process.cwd() — a packaged Claude Desktop extension is
+// spawned with a cwd we don't control (and may not be writable), so a
+// cwd-relative default here can throw at module load via the mkdirSync
+// below and kill the server before it ever opens the stdio transport.
+const AUTOMATIC_TEMP_DIR = process.env.TEMP_DIR ? undefined : fs.mkdtempSync(path.join(os.tmpdir(), "bambu-printer-mcp-"));
+const TEMP_DIR = process.env.TEMP_DIR || AUTOMATIC_TEMP_DIR!;
+if (AUTOMATIC_TEMP_DIR) {
+  // The exit event also covers startup failures and normal event-loop exit.
+  // Only the directory created above belongs to us; explicit TEMP_DIR is retained.
+  process.once("exit", () => {
+    try {
+      fs.rmSync(AUTOMATIC_TEMP_DIR, { recursive: true, force: true });
+    } catch (error) {
+      console.error("Unable to remove the server's temporary directory:", error);
+    }
+  });
+}
 
 // Printer model and bed type
 const DEFAULT_BAMBU_MODEL =
@@ -46,7 +64,7 @@ const DEFAULT_BAMBU_MODEL =
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
 
-const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c"] as const;
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"] as const;
 type BambuModel = typeof VALID_BAMBU_MODELS[number];
 const H2_BAMBU_MODELS = new Set<string>(["h2d", "h2s", "h2c"]);
 
@@ -65,6 +83,7 @@ const BAMBU_MODEL_PRESETS: Record<string, (nozzle: string) => string> = {
   h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
   h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
   h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
+  x2d: (n) => `Bambu Lab X2D ${n} nozzle`,
 };
 
 const FILAMENT_PROFILE_DIR =
@@ -80,6 +99,7 @@ const FILAMENT_MODEL_CODES: Record<string, string> = {
   h2d: "H2D",
   h2s: "H2S",
   h2c: "H2C",
+  x2d: "X2D",
 };
 
 type FilamentProfileIndex = {
@@ -498,6 +518,19 @@ function extractPrinterDiagnostics(status: any): Record<string, unknown> {
   };
 }
 
+/** Parse "#RRGGBB;#RRGGBB" (leading '#' optional) into positional slot colours. */
+function parseFilamentColours(value: string): string[] {
+  const colours = value.split(";").map((c) => c.trim()).filter(Boolean)
+    .map((c) => (c.startsWith("#") ? c : `#${c}`).toUpperCase());
+  for (const c of colours) {
+    if (!/^#[0-9A-F]{6}([0-9A-F]{2})?$/.test(c)) {
+      throw new Error(`Invalid filament colour "${c}"; expected #RRGGBB.`);
+    }
+  }
+  if (colours.length === 0) throw new Error("filament_colours must list at least one colour.");
+  return colours;
+}
+
 function validateBambuModel(model: string): string {
   const normalized = model.trim().toLowerCase();
   if (!VALID_BAMBU_MODELS.includes(normalized as BambuModel)) {
@@ -1015,16 +1048,18 @@ class BambuPrinterMCPServer {
   private server: Server;
   private bambu: BambuImplementation;
   private bambuNetwork: BambuNetworkBridge;
+  private readonly blender = new BlenderMcpBridge();
   private stlManipulator: STLManipulator;
   private readonly runtimeConfig: RuntimeConfig;
   private httpRuntime?: { transport: StreamableHTTPServerTransport; httpServer: HttpServer };
+  private shuttingDown = false;
 
   constructor() {
     this.runtimeConfig = readRuntimeConfig();
     this.server = new Server(
       {
         name: "bambu-printer-mcp",
-        version: "1.0.0"
+        version: JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8")).version
       },
       {
         capabilities: {
@@ -1088,6 +1123,7 @@ class BambuPrinterMCPServer {
                 { const: "h2d", title: "H2D" },
                 { const: "h2s", title: "H2S" },
                 { const: "h2c", title: "H2C" },
+                { const: "x2d", title: "X2D" },
               ],
             },
           },
@@ -2025,6 +2061,7 @@ class BambuPrinterMCPServer {
                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs." },
                 load_filament_ids: { type: "string", description: "Optional filament-to-object mapping string." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 ensure_on_bed: { type: "boolean", description: "Lift floating models onto the bed." },
                 arrange: { type: "boolean", description: "Auto-arrange objects on the build plate." },
                 orient: { type: "boolean", description: "Auto-orient model for optimal printability." },
@@ -2079,6 +2116,7 @@ class BambuPrinterMCPServer {
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
                 filament_profile: { type: "string", description: "Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths." },
                 load_filament_ids: { type: "string", description: "Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 enable_timelapse: { type: "boolean", description: "Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time." },
                 allow_mix_temp: { type: "boolean", description: "Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG." },
                 scale: { type: "number", description: "Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing." },
@@ -2583,7 +2621,7 @@ class BambuPrinterMCPServer {
                 bambu_model: {
                   type: "string",
                   enum: [...VALID_BAMBU_MODELS],
-                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
+                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths. X2D direct printing is not supported."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -2637,29 +2675,63 @@ class BambuPrinterMCPServer {
               required: ["stl_path"]
             }
           },
+          {
+            name: "blender_mcp_status",
+            description: "Inspect Blender MCP configuration or connect and discover the remote server's tools and schemas. Connecting does not edit the scene; use get_scene_info through blender_mcp_call to check the Blender addon.",
+            inputSchema: {
+              type: "object",
+              properties: {
+                connect: { type: "boolean", description: "Initialize the configured stdio MCP server and discover its tools (default false)." },
+                timeout_ms: { type: "integer", minimum: 100, maximum: 300000, description: "Total connection and discovery deadline in milliseconds; defaults to BLENDER_MCP_TIMEOUT_MS or 120000." }
+              },
+              additionalProperties: false
+            }
+          },
+          {
+            name: "blender_mcp_call",
+            description: "Call a discovered tool on the configured Blender MCP server, preserving its full MCP content and errors. Discover tool schemas with blender_mcp_status first; execute_blender_code accepts Python code and user_prompt. Calls can modify the active Blender scene and are never automatically retried.",
+            inputSchema: {
+              type: "object",
+              properties: {
+                tool_name: { type: "string", description: "Exact name advertised by Blender MCP, such as get_scene_info or execute_blender_code." },
+                arguments: { type: "object", description: "Arguments matching the remote tool's discovered input schema. Preserve the user's own words in user_prompt when the remote tool requests it." },
+                timeout_ms: { type: "integer", minimum: 100, maximum: 300000, description: "Total connection, discovery, and tool deadline in milliseconds; defaults to BLENDER_MCP_TIMEOUT_MS or 120000." }
+              },
+              required: ["tool_name"],
+              additionalProperties: false
+            }
+          },
           {
             name: "blender_mcp_edit_model",
-            description: "Send STL-edit instructions to a Blender MCP bridge command for advanced model edits",
+            description: "Import, edit, and export a local STL through standard Blender MCP with verified output and existing scene objects preserved. Requires a shared local filesystem and Blender Object Mode. Also supports a separately configured legacy executable bridge.",
             inputSchema: {
               type: "object",
               properties: {
                 stl_path: { type: "string", description: "Path to the local STL file" },
                 operations: {
                   type: "array",
-                  description: "Ordered edit operations for Blender (e.g. remesh, boolean, decimate)",
+                  description: "Ordered operations: decimate:<ratio greater than 0 and at most 1>, remesh:<positive voxel size in STL units>, boolean_union:<STL path>. Legacy custom bridges define their own operations.",
+                  minItems: 1,
+                  maxItems: 64,
                   items: { type: "string" }
                 },
-                bridge_command: { type: "string", description: "Override command for invoking Blender MCP bridge. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
-                execute: { type: "boolean", description: "Execute bridge command (true) or return payload only (false)" }
+                output_path: { type: "string", description: "Required for standard MCP previews and execution: new local STL output path whose parent exists. Existing files are never overwritten. Optional for legacy-only bridge configuration." },
+                user_prompt: { type: "string", description: "The user's own words describing the edit, passed unchanged to Blender MCP." },
+                timeout_ms: { type: "integer", minimum: 100, maximum: 300000, description: "Total Blender request deadline in milliseconds; defaults to BLENDER_MCP_TIMEOUT_MS or 120000." },
+                bridge_command: { type: "string", description: "Legacy custom bridge executable override, not a standard MCP command. Per-call overrides require MCP_ALLOW_EXECUTABLE_ARG=1." },
+                execute: { type: "boolean", description: "Apply edits and export (true) or validate and return the prepared request without connecting (false, default)." }
               },
-              required: ["stl_path", "operations"]
+              required: process.env.BLENDER_MCP_COMMAND?.trim()
+                ? ["stl_path", "operations", "output_path"]
+                : ["stl_path", "operations"],
+              additionalProperties: false
             }
           }
         ]
       };
     });
 
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    this.server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
       const { name, arguments: args } = request.params;
 
       const host = String(args?.host || DEFAULT_HOST);
@@ -2841,28 +2913,31 @@ class BambuPrinterMCPServer {
             break;
           }
 
-          case "upload_file":
+          case "upload_file": {
             if (!args?.file_path || !args?.filename) {
               throw new Error("Missing required parameters: file_path and filename");
             }
-            if (Boolean(args.print ?? false)) {
-              await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            }
+            const print = Boolean(args.print ?? false);
+            const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model as string | undefined) : undefined;
+            if (print) assertDirectPrintSupported(uploadModel, bambuSerial);
             result = await this.bambu.uploadFile(
               host, bambuSerial, bambuToken,
               String(args.file_path), String(args.filename),
-              Boolean(args.print ?? false)
+              print, uploadModel
             );
             break;
+          }
 
           case "start_print":
-          case "start_print_job":
+          case "start_print_job": {
             if (!args?.filename) {
               throw new Error("Missing required parameter: filename");
             }
-            await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename));
+            const startModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(startModel, bambuSerial);
+            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename), startModel);
             break;
+          }
 
           case "cancel_print":
             result = await this.bambu.cancelJob(host, bambuSerial, bambuToken);
@@ -3064,6 +3139,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3149,6 +3225,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3211,6 +3288,7 @@ class BambuPrinterMCPServer {
               "print_3mf"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(
@@ -3229,57 +3307,50 @@ class BambuPrinterMCPServer {
 
             let threeMFPath = String(args.three_mf_path);
 
-            // Auto-slice if 3MF has no gcode
-            try {
-              const JSZip = (await import('jszip')).default;
-              const zipData = fs.readFileSync(threeMFPath);
-              const zip = await JSZip.loadAsync(zipData);
-              const hasGcode = Object.keys(zip.files).some(
-                f => f.match(/Metadata\/plate_\d+\.gcode/i) || f.endsWith('.gcode')
-              );
-              if (!hasGcode) {
-                if (printBedType === "supertack_plate") {
-                  throw new Error(
-                    'BambuStudio CLI SuperTack bed type is not verified; use a pre-sliced 3MF for SuperTack or choose textured_plate, cool_plate, engineering_plate, or hot_plate.'
+            // Inspect and auto-slice before upload. Preserve any failure instead of sending an unsliced project.
+            const JSZip = (await import('jszip')).default;
+            const zipData = fs.readFileSync(threeMFPath);
+            const zip = await JSZip.loadAsync(zipData);
+            const hasGcode = Object.values(zip.files).some(
+              entry => !entry.dir && /\.gcode$/i.test(entry.name)
+            );
+            if (!hasGcode) {
+              if (printBedType === "supertack_plate") {
+                throw new Error(
+                  'BambuStudio CLI SuperTack bed type is not verified; use a pre-sliced 3MF for SuperTack or choose textured_plate, cool_plate, engineering_plate, or hot_plate.'
+                );
+              }
+              console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
+              const autoSliceOptions: BambuSliceOptions = {
+                uptodate: true,
+                ensureOnBed: true,
+                minSave: true,
+                skipModifiedGcodes: true,
+                bedType: printBedType,
+              };
+              if (!explicitSlicerProfile) {
+                try {
+                  const liveFilaments = await this.getResolvedPrinterFilamentInventory(
+                    host,
+                    bambuSerial,
+                    bambuToken,
+                    printModel,
+                    printNozzle
                   );
-                }
-                console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
-                const autoSliceOptions: BambuSliceOptions = {
-                  uptodate: true,
-                  ensureOnBed: true,
-                  minSave: true,
-                  skipModifiedGcodes: true,
-                  bedType: printBedType,
-                };
-                if (!explicitSlicerProfile) {
-                  try {
-                    const liveFilaments = await this.getResolvedPrinterFilamentInventory(
-                      host,
-                      bambuSerial,
-                      bambuToken,
-                      printModel,
-                      printNozzle
-                    );
-                    if (liveFilaments.recommended?.load_filaments) {
-                      autoSliceOptions.loadFilaments = liveFilaments.recommended.load_filaments;
-                    }
-                  } catch (filamentError) {
-                    console.warn("Could not resolve live printer filaments for auto-slicing:", filamentError);
+                  if (liveFilaments.recommended?.load_filaments) {
+                    autoSliceOptions.loadFilaments = liveFilaments.recommended.load_filaments;
                   }
+                } catch (filamentError) {
+                  console.warn("Could not resolve live printer filaments for auto-slicing:", filamentError);
                 }
-                threeMFPath = await this.stlManipulator.sliceSTL(
-                  threeMFPath, slicerType, slicerPath, activeSlicerProfile,
-                  undefined, // progressCallback
-                  printPreset,
-                  autoSliceOptions
-                );
-                console.log("Auto-sliced to: " + threeMFPath);
               }
-            } catch (sliceCheckErr: any) {
-              if (String(sliceCheckErr?.message || "").includes("SuperTack")) {
-                throw sliceCheckErr;
-              }
-              console.warn("Could not check/slice 3MF, proceeding with original:", sliceCheckErr.message);
+              threeMFPath = await this.stlManipulator.sliceSTL(
+                threeMFPath, slicerType, slicerPath, activeSlicerProfile,
+                undefined, // progressCallback
+                printPreset,
+                autoSliceOptions
+              );
+              console.log("Auto-sliced to: " + threeMFPath);
             }
 
             const parsed3MFData = await parse3MF(threeMFPath);
@@ -3403,6 +3474,7 @@ class BambuPrinterMCPServer {
               "print_collar_charm"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(
@@ -3496,21 +3568,24 @@ class BambuPrinterMCPServer {
             result = await this.stlManipulator.layFlat(String(args.stl_path));
             break;
 
+          case "blender_mcp_status":
+            result = await this.blender.status(args ?? {}, extra.signal);
+            break;
+
+          case "blender_mcp_call":
+            return await this.blender.call(args ?? {}, extra.signal);
+
           case "blender_mcp_edit_model":
-            if (!args?.stl_path || !Array.isArray(args.operations)) {
-              throw new Error("Missing required parameters: stl_path and operations");
-            }
-            result = await this.invokeBlenderBridge({
-              stlPath: String(args.stl_path),
-              operations: args.operations.map((entry: any) => String(entry)),
-              execute: Boolean(args.execute ?? false),
-              bridgeCommand: this.resolveExecutableSelectorArg(
-                args.bridge_command,
+            result = await this.blender.edit(
+              args ?? {},
+              this.resolveExecutableSelectorArg(
+                args?.bridge_command,
                 "blender_mcp_edit_model",
                 "bridge_command",
                 true
-              ) ?? this.runtimeConfig.blenderBridgeCommand,
-            });
+              ) ?? (!process.env.BLENDER_MCP_COMMAND?.trim() ? this.runtimeConfig.blenderBridgeCommand : undefined),
+              extra.signal
+            );
             break;
 
           default:
@@ -3547,49 +3622,27 @@ class BambuPrinterMCPServer {
     });
   }
 
-  private async invokeBlenderBridge(params: {
-    stlPath: string;
-    operations: string[];
-    execute: boolean;
-    bridgeCommand?: string;
-  }): Promise<any> {
-    const payload = {
-      stlPath: params.stlPath,
-      operations: params.operations,
-    };
-
-    if (!params.execute || !params.bridgeCommand) {
-      return {
-        status: "prepared",
-        payload,
-        note: params.bridgeCommand
-          ? "Set execute=true to run the Blender bridge command."
-          : "No BLENDER_MCP_BRIDGE_COMMAND configured. Set the env var or pass bridge_command.",
-      };
-    }
-
-    const { execFile } = await import("node:child_process");
-    const { promisify } = await import("node:util");
-    const execFileAsync = promisify(execFile);
-
-    const { stdout, stderr } = await execFileAsync(params.bridgeCommand, [], {
-      env: { ...process.env, MCP_BLENDER_PAYLOAD: JSON.stringify(payload) },
-      timeout: 120_000,
-    });
-
-    return {
-      status: "executed",
-      stdout: stdout.trim(),
-      stderr: stderr.trim(),
-    };
-  }
-
   async startStdio() {
     const transport = new StdioServerTransport();
     await this.server.connect(transport);
+    process.stdin.once("end", () => { void this.shutdown(); });
     console.error("Bambu Printer MCP server running on stdio");
   }
 
+  async shutdown(exitCode = 0) {
+    if (this.shuttingDown) return;
+    this.shuttingDown = true;
+    try {
+      // Closing the MCP transport aborts its active requests before exit cleanup.
+      await this.server.close();
+      this.httpRuntime?.httpServer.close();
+    } catch (error) {
+      console.error("[MCP Shutdown]", error);
+    } finally {
+      process.exit(exitCode);
+    }
+  }
+
   async startHttp() {
     const { httpHost, httpPort, httpPath, statefulSession, enableJsonResponse, allowedOrigins } =
       this.runtimeConfig;
@@ -3640,4 +3693,6 @@ class BambuPrinterMCPServer {
 }
 
 const server = new BambuPrinterMCPServer();
+process.once("SIGINT", () => { void server.shutdown(130); });
+process.once("SIGTERM", () => { void server.shutdown(143); });
 server.run().catch(console.error);