mcp-3d-printer-server 0.1.0

package/src/printers/duet.ts

@@ -0,0 +1,82 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+
+export class DuetImplementation extends PrinterImplementation {
+  async getStatus(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/machine/status`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async getFiles(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/machine/file-list`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async getFile(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/machine/file/${encodeURIComponent(filename)}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean) {
+    const url = `http://${host}:${port}/machine/file-upload`;
+    
+    const formData = new FormData();
+    formData.append("file", fs.createReadStream(filePath));
+    formData.append("filename", filename);
+    
+    const response = await this.apiClient.post(url, formData as any, {
+      headers: {
+        ...formData.getHeaders()
+      }
+    });
+    
+    if (print && response.data.err === 0) {
+      await this.startJob(host, port, apiKey, filename);
+    }
+    
+    return response.data;
+  }
+  
+  async startJob(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/machine/code`;
+    
+    const response = await this.apiClient.post(url, {
+      code: `M32 "${filename}"`
+    } as any);
+    
+    return response.data;
+  }
+  
+  async cancelJob(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/machine/code`;
+    
+    const response = await this.apiClient.post(url, {
+      code: "M0"
+    } as any);
+    
+    return response.data;
+  }
+  
+  async setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number) {
+    const url = `http://${host}:${port}/machine/code`;
+    
+    let gcode;
+    if (component === "bed") {
+      gcode = `M140 S${temperature}`;
+    } else if (component === "extruder") {
+      gcode = `M104 S${temperature}`;
+    } else {
+      throw new Error(`Unsupported component: ${component}`);
+    }
+    
+    const response = await this.apiClient.post(url, {
+      code: gcode
+    } as any);
+    
+    return response.data;
+  }
+} 

package/src/printers/klipper.ts

@@ -0,0 +1,78 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+
+export class KlipperImplementation extends PrinterImplementation {
+  async getStatus(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/printer/info`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+
+  async getFiles(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/server/files/list`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+
+  async getFile(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/server/files/metadata?filename=${encodeURIComponent(filename)}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+
+  async uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean) {
+    const url = `http://${host}:${port}/server/files/upload`;
+    
+    const formData = new FormData();
+    formData.append("file", fs.createReadStream(filePath));
+    formData.append("filename", filename);
+    
+    const response = await this.apiClient.post(url, formData as any, {
+      headers: {
+        ...formData.getHeaders()
+      }
+    });
+    
+    if (print && response.data.result === "success") {
+      await this.startJob(host, port, apiKey, filename);
+    }
+    
+    return response.data;
+  }
+
+  async startJob(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/printer/print/start`;
+    
+    const response = await this.apiClient.post(url, { filename } as any);
+    
+    return response.data;
+  }
+
+  async cancelJob(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/printer/print/cancel`;
+    
+    const response = await this.apiClient.post(url, null as any);
+    
+    return response.data;
+  }
+
+  async setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number) {
+    const url = `http://${host}:${port}/printer/gcode/script`;
+    
+    let gcode;
+    if (component === "bed") {
+      gcode = `SET_HEATER_TEMPERATURE HEATER=heater_bed TARGET=${temperature}`;
+    } else if (component === "extruder") {
+      gcode = `SET_HEATER_TEMPERATURE HEATER=extruder TARGET=${temperature}`;
+    } else {
+      throw new Error(`Unsupported component: ${component}`);
+    }
+    
+    const response = await this.apiClient.post(url, {
+      script: gcode
+    } as any);
+    
+    return response.data;
+  }
+} 

package/src/printers/octoprint.ts

@@ -0,0 +1,113 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+
+export class OctoPrintImplementation extends PrinterImplementation {
+  async getStatus(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/printer`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async getFiles(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/files`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async getFile(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/api/files/local/${filename}`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean) {
+    const url = `http://${host}:${port}/api/files/local`;
+    
+    const formData = new FormData();
+    formData.append("file", fs.createReadStream(filePath));
+    formData.append("filename", filename);
+    
+    if (print) {
+      formData.append("print", "true");
+    }
+    
+    const response = await this.apiClient.post(url, formData as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        ...formData.getHeaders()
+      }
+    });
+    
+    return response.data;
+  }
+
+  async startJob(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/api/files/local/${filename}`;
+    
+    const response = await this.apiClient.post(url, {
+      command: "select",
+      print: true
+    } as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+
+  async cancelJob(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/job`;
+    
+    const response = await this.apiClient.post(url, {
+      command: "cancel"
+    } as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+
+  async setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number) {
+    let url = `http://${host}:${port}/api/printer/tool`;
+    
+    const data: Record<string, any> = {};
+    if (component === "bed") {
+      data.command = "target";
+      data.target = temperature;
+      url = `http://${host}:${port}/api/printer/bed`;
+    } else if (component.startsWith("extruder")) {
+      data.command = "target";
+      data.targets = {};
+      data.targets[component] = temperature;
+    } else {
+      throw new Error(`Unsupported component: ${component}`);
+    }
+    
+    const response = await this.apiClient.post(url, data as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+} 

package/src/printers/printer-factory.ts

@@ -0,0 +1,37 @@
+import { PrinterImplementation, BambuPrinterStore } from "../types.js";
+import { OctoPrintImplementation } from "./octoprint.js";
+import { KlipperImplementation } from "./klipper.js";
+import { DuetImplementation } from "./duet.js";
+import { RepetierImplementation } from "./repetier.js";
+import { BambuImplementation } from "./bambu.js";
+import { PrusaImplementation } from "./prusa.js";
+import { CrealityImplementation } from "./creality.js";
+import axios from "axios";
+
+export class PrinterFactory {
+  private implementations: Map<string, PrinterImplementation> = new Map();
+  private bambuPrinterStore = new BambuPrinterStore();
+  private apiClient = axios.create({ timeout: 10000 });
+
+  constructor() {
+    this.implementations.set("octoprint", new OctoPrintImplementation(this.apiClient));
+    this.implementations.set("klipper", new KlipperImplementation(this.apiClient));
+    this.implementations.set("duet", new DuetImplementation(this.apiClient));
+    this.implementations.set("repetier", new RepetierImplementation(this.apiClient));
+    this.implementations.set("bambu", new BambuImplementation(this.apiClient, this.bambuPrinterStore));
+    this.implementations.set("prusa", new PrusaImplementation(this.apiClient));
+    this.implementations.set("creality", new CrealityImplementation(this.apiClient));
+  }
+
+  getImplementation(type: string): PrinterImplementation {
+    const implementation = this.implementations.get(type.toLowerCase());
+    if (!implementation) {
+      throw new Error(`Unsupported printer type: ${type}`);
+    }
+    return implementation;
+  }
+
+  async disconnectAll(): Promise<void> {
+    await this.bambuPrinterStore.disconnectAll();
+  }
+} 

package/src/printers/prusa.ts

@@ -0,0 +1,109 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+
+export class PrusaImplementation extends PrinterImplementation {
+  async getStatus(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/v1/printer`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async getFiles(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/v1/storage`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async getFile(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/api/v1/storage/${encodeURIComponent(filename)}`;
+    const response = await this.apiClient.get(url, {
+      headers: {
+        "X-Api-Key": apiKey
+      }
+    });
+    return response.data;
+  }
+
+  async uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean) {
+    const url = `http://${host}:${port}/api/v1/storage`;
+    
+    const formData = new FormData();
+    formData.append("file", fs.createReadStream(filePath));
+    formData.append("filename", filename);
+    
+    const response = await this.apiClient.post(url, formData as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        ...formData.getHeaders()
+      }
+    });
+    
+    if (print && response.data.success) {
+      await this.startJob(host, port, apiKey, filename);
+    }
+    
+    return response.data;
+  }
+
+  async startJob(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/api/v1/job`;
+    
+    const response = await this.apiClient.post(url, {
+      command: "start",
+      file: filename
+    } as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+
+  async cancelJob(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/api/v1/job`;
+    
+    const response = await this.apiClient.post(url, {
+      command: "cancel"
+    } as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+
+  async setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number) {
+    const url = `http://${host}:${port}/api/v1/printer/temperature`;
+    
+    let data: Record<string, any> = { command: "set" };
+    if (component === "bed") {
+      data.target = { bed: temperature };
+    } else if (component.startsWith("extruder")) {
+      data.target = { tool0: temperature }; // Prusa typically uses tool0 for the extruder
+    } else {
+      throw new Error(`Unsupported component: ${component}`);
+    }
+    
+    const response = await this.apiClient.post(url, data as any, {
+      headers: {
+        "X-Api-Key": apiKey,
+        "Content-Type": "application/json"
+      }
+    });
+    
+    return response.data;
+  }
+} 

package/src/printers/repetier.ts

@@ -0,0 +1,68 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+
+export class RepetierImplementation extends PrinterImplementation {
+  async getStatus(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/printer/api/?a=getPrinterInfo&apikey=${apiKey}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async getFiles(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/printer/api/?a=ls&apikey=${apiKey}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async getFile(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/printer/api/?a=getFileInfo&apikey=${apiKey}&filename=${encodeURIComponent(filename)}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean) {
+    const url = `http://${host}:${port}/printer/api/`;
+    
+    const formData = new FormData();
+    formData.append("a", "upload");
+    formData.append("apikey", apiKey);
+    formData.append("filename", filename);
+    formData.append("print", print ? "1" : "0");
+    formData.append("file", fs.createReadStream(filePath));
+    
+    const response = await this.apiClient.post(url, formData as any, {
+      headers: {
+        ...formData.getHeaders()
+      }
+    });
+    
+    return response.data;
+  }
+  
+  async startJob(host: string, port: string, apiKey: string, filename: string) {
+    const url = `http://${host}:${port}/printer/api/?a=startJob&apikey=${apiKey}&filename=${encodeURIComponent(filename)}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async cancelJob(host: string, port: string, apiKey: string) {
+    const url = `http://${host}:${port}/printer/api/?a=stopJob&apikey=${apiKey}`;
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+  
+  async setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number) {
+    let url;
+    if (component === "bed") {
+      url = `http://${host}:${port}/printer/api/?a=setBedTemp&apikey=${apiKey}&temp=${temperature}`;
+    } else if (component === "extruder") {
+      url = `http://${host}:${port}/printer/api/?a=setExtruderTemp&apikey=${apiKey}&temp=${temperature}`;
+    } else {
+      throw new Error(`Unsupported component: ${component}`);
+    }
+    
+    const response = await this.apiClient.get(url);
+    return response.data;
+  }
+} 

package/src/types.ts

@@ -0,0 +1,46 @@
+import { AxiosInstance } from "axios";
+import { BambuPrinter } from "bambu-js";
+
+// Define shared types for the printer implementations
+export type BambuFTP = {
+  readDir: (path: string) => Promise<string[]>;
+  sendFile: (sourcePath: string, destinationPath: string, progressCallback?: (progress: number) => void) => Promise<void>;
+  removeFile: (path: string) => Promise<void>;
+};
+
+// Base class for printer implementations
+export abstract class PrinterImplementation {
+  protected apiClient: AxiosInstance;
+
+  constructor(apiClient: AxiosInstance) {
+    this.apiClient = apiClient;
+  }
+
+  abstract getStatus(host: string, port: string, apiKey: string): Promise<any>;
+  abstract getFiles(host: string, port: string, apiKey: string): Promise<any>;
+  abstract getFile(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+  abstract uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean): Promise<any>;
+  abstract startJob(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+  abstract cancelJob(host: string, port: string, apiKey: string): Promise<any>;
+  abstract setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number): Promise<any>;
+}
+
+// Store for Bambu printers
+export class BambuPrinterStore {
+  private printers: Map<string, InstanceType<typeof BambuPrinter>> = new Map();
+
+  get(host: string, serial: string, token: string): InstanceType<typeof BambuPrinter> {
+    const key = `${host}-${serial}`;
+    if (!this.printers.has(key)) {
+      const printer = new BambuPrinter(host, serial, token);
+      this.printers.set(key, printer);
+    }
+    return this.printers.get(key)!;
+  }
+
+  async disconnectAll(): Promise<void> {
+    for (const printer of this.printers.values()) {
+      await printer.disconnect();
+    }
+  }
+} 

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "declaration": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}