mcp-3d-printer-server 1.2.15 → 1.2.17

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.2.17 — 2026-10-27
+
+### Fixed
+
+- Accept the official OrcaSlicer `M620.17 T<nozzle> S<target> L-1` preheat for an unused nozzle on X2D, H2D and H2D Pro. Keep the target bounded by the hardware limit and every declared material, restrict the physical nozzle to 0 or 1, and do not invent a filament/AMS position. Ported from bambu-printer-mcp 1.1.38 following [ZombieLurker's H2D report](https://github.com/DMontgomery40/bambu-printer-mcp/issues/73). Reproduced and validated here with offline file-inspection regressions; no physical print was run.
+
+### Dependencies
+
+- Update the MCP SDK to 1.32.2 and Axios to 1.21.0 within their supported major versions. Verify MCP startup and HTTP header/body handling alongside the adapter and package tests. Thank you to the [MCP TypeScript SDK contributors](https://github.com/modelcontextprotocol/typescript-sdk) and [Axios contributors](https://github.com/axios/axios/releases/tag/v1.21.0).
+
+## 1.2.16 — 2026-10-26
+
+### Documentation
+- Show the documentation site's social card directly below the README title and link it to the site.
+
 ## 1.2.15 — 2026-10-26
 
 ### Documentation

package/CONTRIBUTORS.md

@@ -21,6 +21,7 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 | Contributor | Contribution |
 | --- | --- |
+| [ZombieLurker](https://github.com/ZombieLurker) | Supplies the exact OrcaSlicer 2.4.2 H2D startup commands and unused-nozzle diagnosis in [fork #73](https://github.com/DMontgomery40/bambu-printer-mcp/issues/73). The X2D/H2D/H2D Pro preheat correction is ported here with independent offline safety regressions; no physical printing is claimed. |
 | [MorganFreeeman](https://github.com/MorganFreeeman) | Reports in the Bambu fork's [#67](https://github.com/DMontgomery40/bambu-printer-mcp/issues/67) that every H2D print stopped on stock nozzles, with idle and mid-print H2D firmware 01.04.00.00 reports, and that a declined confirmation pointed to the wrong cause. The nozzle-information and confirmation-wording fixes are ported here with that report as a mocked-status regression; no H2D print is claimed. |
 | [Aaron Roberts (aaroberts)](https://github.com/aaroberts) | Diagnoses FULU's Linux host failures under Node.js in the Bambu fork's [#68](https://github.com/DMontgomery40/bambu-printer-mcp/issues/68), with the upstream issues ([FULU #50](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/50), [FULU #51](https://github.com/FULU-Foundation/OrcaSlicer-bambulab/issues/51)) and a working configuration. The Linux library paths, exit-101 explanation and `cat` wrapper are ported here and checked against FULU's real Linux host without contacting a printer. |
 | [Steavie](https://github.com/Steavie) | Reports reversed A1/A1 mini serial identity in the Bambu fork's [#39](https://github.com/DMontgomery40/bambu-printer-mcp/issues/39). This repository now uses the corrected prefixes for fresh safety identity, with mocked MQTT regressions. |
@@ -58,3 +59,7 @@ Thanks to [Henk Kraal (hkraal)](https://github.com/hkraal) and the [MQTT.js main
 ## Open-source community and interoperability
 
 Special thanks to the [FULU Foundation](https://www.fulu.org/), [Louis Rossmann](https://www.youtube.com/@rossmanngroup), and the [OrcaSlicer-bambulab contributors](https://github.com/FULU-Foundation/OrcaSlicer-bambulab) for their work supporting user control and interoperable tools. This is community recognition, separate from code authorship in this repository. The Bambu-only fork, [bambu-printer-mcp](https://github.com/DMontgomery40/bambu-printer-mcp), credits its own contributors in its [CONTRIBUTORS.md](https://github.com/DMontgomery40/bambu-printer-mcp/blob/main/CONTRIBUTORS.md).
+
+## Dependency maintenance
+
+Thank you to the [MCP TypeScript SDK contributors](https://github.com/modelcontextprotocol/typescript-sdk/graphs/contributors) and [Axios contributors](https://github.com/axios/axios/graphs/contributors) for the compatible 1.32.2 and 1.21.0 releases validated in this project.

package/README.md

@@ -1,5 +1,7 @@
 # MCP 3D Printer Server
 
+[![MCP 3D Printer Server — Print from a conversation. Browse the documentation site.](https://dmontgomery40.github.io/mcp-3D-printer-server/social-card.png)](https://dmontgomery40.github.io/mcp-3D-printer-server/)
+
 > **Thank you, [FULU Foundation](https://www.fulu.org/), [Louis Rossmann](https://www.youtube.com/@rossmanngroup), and the [OrcaSlicer-bambulab contributors](https://github.com/FULU-Foundation/OrcaSlicer-bambulab).** Thank you for standing up for consumer ownership, open-source developers, repair rights, and owners whose working hardware should not be made worse by locked-down software.
 >
 > This server treats the FULU OrcaSlicer-bambulab fork as a first-class slicer for Bambu Lab projects. See the [FULU guide](https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/docs/FULU.md) for setup and current status.

package/dist/safety/print-file.js

@@ -574,7 +574,21 @@ export async function inspectPrintFile(filePath, options) {
                 for (const key of args.keys())
                     if (!'SLT'.includes(key))
                         fail(`unsupported M620.17 parameter ${key}`);
-                heat('nozzle', args.get('S'), requirePosition(args.get('L')));
+                if (args.get('L') === -1 && ['x2d', 'h2d', 'h2dpro'].includes(model)) {
+                    // OrcaSlicer's X2D/H2D/H2D Pro start G-code preheats a nozzle with no assigned
+                    // filament (L-1) for toolhead-offset calibration; Bambu Studio writes
+                    // L0 there. No project filament is selected, so check the target
+                    // against the hardware limit and every declared material, like other
+                    // heater commands without a verified filament. That is never looser
+                    // than an accepted L<position> form. Material left in the nozzle from
+                    // an earlier job is live state that no file can declare. T names one
+                    // of the two physical nozzles, whatever the file declares.
+                    if (args.get('T') > 1)
+                        fail('unsupported M620.17 nozzle/material temperature mapping');
+                    heat('nozzle', args.get('S'), undefined, true);
+                }
+                else
+                    heat('nozzle', args.get('S'), requirePosition(args.get('L')));
             }
             else if ((/^M620\./.test(code) && !['M620.3', 'M620.6', 'M620.11'].includes(code)) || /^M621\./.test(code)) {
                 fail(`unsupported thermal-affecting filament command ${code}`);

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mcp-3d-printer-server",
     "mcpName": "io.github.DMontgomery40/mcp-3d-printer-server",
-    "version": "1.2.15",
+    "version": "1.2.17",
     "description": "MCP server for connecting Claude with 3D printer management systems",
     "main": "dist/index.js",
     "repository": "https://github.com/DMontgomery40/mcp-3D-printer-server",
@@ -79,8 +79,8 @@
     "author": "David Montgomery",
     "license": "GPL-2.0",
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.32.1",
-        "axios": "^1.20.0",
+        "@modelcontextprotocol/sdk": "^1.32.2",
+        "axios": "^1.21.0",
         "bambu-node": "3.22.21",
         "basic-ftp": "^6.2.3",
         "dotenv": "^16.6.1",

package/server.json

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

package/src/safety/print-file.ts

@@ -406,7 +406,18 @@ export async function inspectPrintFile(filePath: string, options: {model:string;
         const args=parameters(argumentsText);
         if(!args.has('S') || !args.has('L') || !args.has('T') || !Number.isInteger(args.get('T')) || args.get('T')!<0 || args.get('T')!>=nozzleDiameters.length) fail('unsupported M620.17 nozzle/material temperature mapping');
         for(const key of args.keys()) if(!'SLT'.includes(key)) fail(`unsupported M620.17 parameter ${key}`);
-        heat('nozzle',args.get('S')!,requirePosition(args.get('L')!));
+        if(args.get('L')===-1 && ['x2d','h2d','h2dpro'].includes(model)) {
+          // OrcaSlicer's X2D/H2D/H2D Pro start G-code preheats a nozzle with no assigned
+          // filament (L-1) for toolhead-offset calibration; Bambu Studio writes
+          // L0 there. No project filament is selected, so check the target
+          // against the hardware limit and every declared material, like other
+          // heater commands without a verified filament. That is never looser
+          // than an accepted L<position> form. Material left in the nozzle from
+          // an earlier job is live state that no file can declare. T names one
+          // of the two physical nozzles, whatever the file declares.
+          if(args.get('T')!>1) fail('unsupported M620.17 nozzle/material temperature mapping');
+          heat('nozzle',args.get('S')!,undefined,true);
+        } else heat('nozzle',args.get('S')!,requirePosition(args.get('L')!));
       } else if((/^M620\./.test(code) && !['M620.3','M620.6','M620.11'].includes(code)) || /^M621\./.test(code)) {
         fail(`unsupported thermal-affecting filament command ${code}`);
       } else if(code==='M145') {