mcp-3d-printer-server 1.0.0 → 1.0.1

package/dist/printers/octoprint.js

@@ -0,0 +1,97 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+export class OctoPrintImplementation extends PrinterImplementation {
+    async getStatus(host, port, apiKey) {
+        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, port, apiKey) {
+        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, port, apiKey, filename) {
+        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, port, apiKey, filePath, filename, print) {
+        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, {
+            headers: {
+                "X-Api-Key": apiKey,
+                ...formData.getHeaders()
+            }
+        });
+        return response.data;
+    }
+    async startJob(host, port, apiKey, filename) {
+        const url = `http://${host}:${port}/api/files/local/${filename}`;
+        const response = await this.apiClient.post(url, {
+            command: "select",
+            print: true
+        }, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+    async cancelJob(host, port, apiKey) {
+        const url = `http://${host}:${port}/api/job`;
+        const response = await this.apiClient.post(url, {
+            command: "cancel"
+        }, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+    async setTemperature(host, port, apiKey, component, temperature) {
+        let url = `http://${host}:${port}/api/printer/tool`;
+        const data = {};
+        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, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+}

package/dist/printers/printer-factory.d.ts

@@ -0,0 +1,9 @@
+import { PrinterImplementation } from "../types.js";
+export declare class PrinterFactory {
+    private implementations;
+    private bambuPrinterStore;
+    private apiClient;
+    constructor();
+    getImplementation(type: string): PrinterImplementation;
+    disconnectAll(): Promise<void>;
+}

package/dist/printers/printer-factory.js

@@ -0,0 +1,33 @@
+import { 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 {
+    constructor() {
+        this.implementations = new Map();
+        this.bambuPrinterStore = new BambuPrinterStore();
+        this.apiClient = axios.create({ timeout: 10000 });
+        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) {
+        const implementation = this.implementations.get(type.toLowerCase());
+        if (!implementation) {
+            throw new Error(`Unsupported printer type: ${type}`);
+        }
+        return implementation;
+    }
+    async disconnectAll() {
+        await this.bambuPrinterStore.disconnectAll();
+    }
+}

package/dist/printers/prusa.d.ts

@@ -0,0 +1,10 @@
+import { PrinterImplementation } from "../types.js";
+export declare class PrusaImplementation extends PrinterImplementation {
+    getStatus(host: string, port: string, apiKey: string): Promise<any>;
+    getFiles(host: string, port: string, apiKey: string): Promise<any>;
+    getFile(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+    uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean): Promise<any>;
+    startJob(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+    cancelJob(host: string, port: string, apiKey: string): Promise<any>;
+    setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number): Promise<any>;
+}

package/dist/printers/prusa.js

@@ -0,0 +1,93 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+export class PrusaImplementation extends PrinterImplementation {
+    async getStatus(host, port, apiKey) {
+        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, port, apiKey) {
+        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, port, apiKey, filename) {
+        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, port, apiKey, filePath, filename, print) {
+        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, {
+            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, port, apiKey, filename) {
+        const url = `http://${host}:${port}/api/v1/job`;
+        const response = await this.apiClient.post(url, {
+            command: "start",
+            file: filename
+        }, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+    async cancelJob(host, port, apiKey) {
+        const url = `http://${host}:${port}/api/v1/job`;
+        const response = await this.apiClient.post(url, {
+            command: "cancel"
+        }, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+    async setTemperature(host, port, apiKey, component, temperature) {
+        const url = `http://${host}:${port}/api/v1/printer/temperature`;
+        let data = { 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, {
+            headers: {
+                "X-Api-Key": apiKey,
+                "Content-Type": "application/json"
+            }
+        });
+        return response.data;
+    }
+}

package/dist/printers/repetier.d.ts

@@ -0,0 +1,10 @@
+import { PrinterImplementation } from "../types.js";
+export declare class RepetierImplementation extends PrinterImplementation {
+    getStatus(host: string, port: string, apiKey: string): Promise<any>;
+    getFiles(host: string, port: string, apiKey: string): Promise<any>;
+    getFile(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+    uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean): Promise<any>;
+    startJob(host: string, port: string, apiKey: string, filename: string): Promise<any>;
+    cancelJob(host: string, port: string, apiKey: string): Promise<any>;
+    setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number): Promise<any>;
+}

package/dist/printers/repetier.js

@@ -0,0 +1,59 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+export class RepetierImplementation extends PrinterImplementation {
+    async getStatus(host, port, apiKey) {
+        const url = `http://${host}:${port}/printer/api/?a=getPrinterInfo&apikey=${apiKey}`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFiles(host, port, apiKey) {
+        const url = `http://${host}:${port}/printer/api/?a=ls&apikey=${apiKey}`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFile(host, port, apiKey, filename) {
+        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, port, apiKey, filePath, filename, print) {
+        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, {
+            headers: {
+                ...formData.getHeaders()
+            }
+        });
+        return response.data;
+    }
+    async startJob(host, port, apiKey, filename) {
+        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, port, apiKey) {
+        const url = `http://${host}:${port}/printer/api/?a=stopJob&apikey=${apiKey}`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async setTemperature(host, port, apiKey, component, temperature) {
+        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/dist/stl/stl-manipulator.d.ts

@@ -0,0 +1,140 @@
+import * as THREE from 'three';
+import { EventEmitter } from 'events';
+export type ProgressCallback = (progress: number, message?: string) => void;
+export type OperationResult = {
+    success: boolean;
+    filePath?: string;
+    error?: string;
+    operationId: string;
+};
+export type TransformationType = 'scale' | 'rotate' | 'translate' | 'extendBase' | 'customModify';
+export type TransformationAxis = 'x' | 'y' | 'z' | 'all';
+export type BoundingBox = {
+    min: THREE.Vector3;
+    max: THREE.Vector3;
+    center: THREE.Vector3;
+    dimensions: THREE.Vector3;
+};
+export type TransformationParams = {
+    type: TransformationType;
+    axis?: TransformationAxis;
+    value: number | number[];
+    relative?: boolean;
+    selectionBounds?: THREE.Box3;
+};
+export declare class STLManipulator extends EventEmitter {
+    private tempDir;
+    private activeOperations;
+    constructor(tempDir?: string);
+    /**
+     * Generate a unique operation ID
+     */
+    private generateOperationId;
+    /**
+     * Load STL file and return geometry and bounding box
+     */
+    private loadSTL;
+    /**
+     * Save a geometry to STL file
+     */
+    private saveSTL;
+    /**
+     * Get comprehensive information about an STL file
+     */
+    getSTLInfo(stlFilePath: string): Promise<{
+        filePath: string;
+        fileName: string;
+        fileSize: number;
+        boundingBox: BoundingBox;
+        vertexCount: number;
+        faceCount: number;
+    }>;
+    /**
+     * Scale an STL model uniformly or along specific axes
+     */
+    scaleSTL(stlFilePath: string, scaleFactors: number | [number, number, number], progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Rotate an STL model around specific axes
+     */
+    rotateSTL(stlFilePath: string, rotationAngles: [number, number, number], // [x, y, z] in degrees
+    progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Translate (move) an STL model along specific axes
+     */
+    translateSTL(stlFilePath: string, translationValues: [number, number, number], // [x, y, z] in mm
+    progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Cancel an ongoing operation
+     */
+    cancelOperation(operationId: string): boolean;
+    /**
+     * Generate an SVG visualization of an STL file from multiple angles
+     * @param stlFilePath Path to the STL file
+     * @param width Width of each view in pixels
+     * @param height Height of each view in pixels
+     * @param progressCallback Optional callback for progress updates
+     * @returns Path to the generated SVG file
+     */
+    generateVisualization(stlFilePath: string, width?: number, height?: number, progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Apply a specific transformation to a selected section of an STL file
+     * This allows for targeted modifications of specific parts of a model
+     */
+    modifySection(stlFilePath: string, selection: THREE.Box3 | 'top' | 'bottom' | 'center', transformation: TransformationParams, progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Enhanced version of extendBase with progress reporting
+     * @param stlFilePath Path to the input STL file
+     * @param extensionInches Amount to extend base in inches
+     * @param progressCallback Optional callback for progress updates
+     * @returns Path to the modified STL file
+     */
+    extendBase(stlFilePath: string, extensionInches: number, progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Slice an STL file using the specified slicer
+     * @param stlFilePath Path to the input STL file
+     * @param slicerType Type of slicer (prusaslicer, cura, slic3r, orcaslicer)
+     * @param slicerPath Path to the slicer executable
+     * @param slicerProfile Optional path to the slicer profile/config file
+     * @param progressCallback Optional callback for progress updates
+     * @returns Path to the generated G-code file
+     */
+    sliceSTL(stlFilePath: string, slicerType: 'prusaslicer' | 'cura' | 'slic3r' | 'orcaslicer', slicerPath: string, slicerProfile?: string, progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Enhanced version of confirmTemperatures with better error handling
+     * @param gcodePath Path to the G-code file
+     * @param expected Expected temperature settings
+     * @param progressCallback Optional callback for progress updates
+     * @returns Object with comparison results
+     */
+    confirmTemperatures(gcodePath: string, expected: {
+        extruder?: number;
+        bed?: number;
+    }, progressCallback?: ProgressCallback): Promise<{
+        match: boolean;
+        actual: {
+            extruder?: number;
+            bed?: number;
+        };
+        expected: {
+            extruder?: number;
+            bed?: number;
+        };
+        allTemperatures: {
+            extruder: number[];
+            bed: number[];
+        };
+    }>;
+    /**
+     * Merge vertices within a specified tolerance.
+     */
+    mergeVertices(stlFilePath: string, tolerance?: number, // Default tolerance in mm
+    progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Center the model at the origin (0,0,0).
+     */
+    centerModel(stlFilePath: string, progressCallback?: ProgressCallback): Promise<string>;
+    /**
+     * Rotate the model so its largest flat face lies on the XY plane (Z=0).
+     */
+    layFlat(stlFilePath: string, progressCallback?: ProgressCallback): Promise<string>;
+}