bambu-printer-mcp 1.1.13 → 1.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.1.13",
+  "version": "1.1.15",
   "description": "MCP server for Bambu Lab 3D printers with STL manipulation, slicing, and print management",
   "main": "dist/index.js",
   "repository": {
@@ -16,7 +16,8 @@
     "test": "npm run build && node --test tests/*.test.mjs tests/**/*.test.mjs",
     "package:mcpb": "npm run build && node scripts/package-mcpb.mjs",
     "version": "node scripts/sync-manifest-version.mjs",
-    "postinstall": "node scripts/install-patches.mjs"
+    "postinstall": "node scripts/install-patches.mjs",
+    "build:native": "scripts/build-bambu-native.zsh"
   },
   "bin": {
     "bambu-printer-mcp": "dist/index.js"
@@ -28,7 +29,10 @@
     "scripts/install-patches.mjs",
     "README.md",
     "CONTRIBUTORS.md",
-    "LICENSE"
+    "LICENSE",
+    "native/*.cpp",
+    "native/*.h",
+    "scripts/build-bambu-native.zsh"
   ],
   "keywords": [
     "mcp",

package/scripts/build-bambu-native.zsh

@@ -0,0 +1,33 @@
+#!/bin/zsh
+
+# Build the optional macOS adapter that calls Bambu Studio's installed
+# networking plug-in at runtime. The plug-in itself is not bundled here.
+set -euo pipefail
+
+if [[ "$(uname -s)" != "Darwin" ]]; then
+  print -u2 "The Bambu native helper currently supports macOS only."
+  exit 1
+fi
+
+SCRIPT_DIR="${0:A:h}"
+PROJECT_ROOT="${SCRIPT_DIR:h}"
+CXX_BIN="${CXX:-clang++}"
+OUTPUT="${PROJECT_ROOT}/native/bambu-native-print"
+SOURCE="${PROJECT_ROOT}/native/bambu-native-print.cpp"
+
+if ! command -v "$CXX_BIN" >/dev/null 2>&1; then
+  print -u2 "C++ compiler not found: $CXX_BIN"
+  exit 1
+fi
+
+"$CXX_BIN" \
+  -std=c++17 \
+  -O2 \
+  -Wall \
+  -Wextra \
+  -o "$OUTPUT" \
+  "$SOURCE" \
+  -ldl
+
+chmod 755 "$OUTPUT"
+print "Built $OUTPUT"

package/src/bambu-connect.ts

@@ -0,0 +1,100 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+const BAMBU_CONNECT_APP_PATH = "/Applications/Bambu Connect.app";
+const BAMBU_CONNECT_SCHEME = "bambu-connect://import-file";
+
+export type BambuConnectImportOptions = {
+  filePath: string;
+  name?: string;
+  version?: string;
+};
+
+function resolveImportFilePath(rawPath: string): string {
+  const trimmed = rawPath.trim();
+  if (!trimmed) {
+    throw new Error("file_path is required.");
+  }
+
+  const filePath = path.resolve(trimmed);
+  if (!/\.(?:gcode|3mf)$/i.test(filePath)) {
+    throw new Error("Bambu Connect import accepts a .gcode or .3mf file.");
+  }
+
+  let stat: fs.Stats;
+  try {
+    stat = fs.statSync(filePath);
+    fs.accessSync(filePath, fs.constants.R_OK);
+  } catch {
+    throw new Error(`Bambu Connect import file is not readable: ${filePath}`);
+  }
+
+  if (!stat.isFile()) {
+    throw new Error(`Bambu Connect import path is not a regular file: ${filePath}`);
+  }
+
+  return filePath;
+}
+
+function defaultImportName(filePath: string): string {
+  const name = path.basename(filePath)
+    .replace(/\.gcode\.3mf$/i, "")
+    .replace(/\.3mf$/i, "")
+    .replace(/\.gcode$/i, "")
+    .trim();
+  return name || "Bambu print";
+}
+
+export function buildBambuConnectImportUrl(options: BambuConnectImportOptions): string {
+  const filePath = resolveImportFilePath(options.filePath);
+  const name = options.name?.trim() || defaultImportName(filePath);
+  const version = options.version?.trim() || "1.0.0";
+  if (!version) {
+    throw new Error("version must not be empty.");
+  }
+
+  const url = new URL(BAMBU_CONNECT_SCHEME);
+  url.searchParams.set("path", filePath);
+  url.searchParams.set("name", name);
+  url.searchParams.set("version", version);
+  return url.toString();
+}
+
+export async function importFileViaBambuConnect(
+  options: BambuConnectImportOptions
+): Promise<Record<string, unknown>> {
+  if (process.platform !== "darwin") {
+    throw new Error("Bambu Connect URL handoff is currently supported only on macOS.");
+  }
+  if (!fs.existsSync(BAMBU_CONNECT_APP_PATH)) {
+    throw new Error(`Bambu Connect is not installed at ${BAMBU_CONNECT_APP_PATH}.`);
+  }
+
+  const filePath = resolveImportFilePath(options.filePath);
+  const name = options.name?.trim() || defaultImportName(filePath);
+  const version = options.version?.trim() || "1.0.0";
+  const url = buildBambuConnectImportUrl({ filePath, name, version });
+  const { stdout, stderr } = await execFileAsync(
+    "/usr/bin/open",
+    ["-a", BAMBU_CONNECT_APP_PATH, url],
+    { encoding: "utf8", timeout: 30_000 }
+  );
+
+  return {
+    status: "handoff_ready",
+    app: "Bambu Connect",
+    app_path: BAMBU_CONNECT_APP_PATH,
+    route: BAMBU_CONNECT_SCHEME,
+    file_path: filePath,
+    project_name: name,
+    version,
+    opened: true,
+    url,
+    stdout: String(stdout || "").trim() || undefined,
+    stderr: String(stderr || "").trim() || undefined,
+    note: "The file was handed to Bambu Connect. Review the selected printer and plate there, then start printing from Bambu Connect when ready; this handoff does not start a print by itself.",
+  };
+}