mcp-3d-printer-server 0.1.0

package/dist/printers/duet.js

@@ -0,0 +1,66 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+export class DuetImplementation extends PrinterImplementation {
+    async getStatus(host, port, apiKey) {
+        const url = `http://${host}:${port}/machine/status`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFiles(host, port, apiKey) {
+        const url = `http://${host}:${port}/machine/file-list`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFile(host, port, apiKey, filename) {
+        const url = `http://${host}:${port}/machine/file/${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}/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, {
+            headers: {
+                ...formData.getHeaders()
+            }
+        });
+        if (print && response.data.err === 0) {
+            await this.startJob(host, port, apiKey, filename);
+        }
+        return response.data;
+    }
+    async startJob(host, port, apiKey, filename) {
+        const url = `http://${host}:${port}/machine/code`;
+        const response = await this.apiClient.post(url, {
+            code: `M32 "${filename}"`
+        });
+        return response.data;
+    }
+    async cancelJob(host, port, apiKey) {
+        const url = `http://${host}:${port}/machine/code`;
+        const response = await this.apiClient.post(url, {
+            code: "M0"
+        });
+        return response.data;
+    }
+    async setTemperature(host, port, apiKey, component, temperature) {
+        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
+        });
+        return response.data;
+    }
+}

package/dist/printers/klipper.d.ts

@@ -0,0 +1,10 @@
+import { PrinterImplementation } from "../types.js";
+export declare class KlipperImplementation 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/klipper.js

@@ -0,0 +1,62 @@
+import { PrinterImplementation } from "../types.js";
+import fs from "fs";
+import FormData from "form-data";
+export class KlipperImplementation extends PrinterImplementation {
+    async getStatus(host, port, apiKey) {
+        const url = `http://${host}:${port}/printer/info`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFiles(host, port, apiKey) {
+        const url = `http://${host}:${port}/server/files/list`;
+        const response = await this.apiClient.get(url);
+        return response.data;
+    }
+    async getFile(host, port, apiKey, filename) {
+        const url = `http://${host}:${port}/server/files/metadata?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}/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, {
+            headers: {
+                ...formData.getHeaders()
+            }
+        });
+        if (print && response.data.result === "success") {
+            await this.startJob(host, port, apiKey, filename);
+        }
+        return response.data;
+    }
+    async startJob(host, port, apiKey, filename) {
+        const url = `http://${host}:${port}/printer/print/start`;
+        const response = await this.apiClient.post(url, { filename });
+        return response.data;
+    }
+    async cancelJob(host, port, apiKey) {
+        const url = `http://${host}:${port}/printer/print/cancel`;
+        const response = await this.apiClient.post(url, null);
+        return response.data;
+    }
+    async setTemperature(host, port, apiKey, component, temperature) {
+        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
+        });
+        return response.data;
+    }
+}

package/dist/printers/octoprint.d.ts

@@ -0,0 +1,10 @@
+import { PrinterImplementation } from "../types.js";
+export declare class OctoPrintImplementation 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/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/types.d.ts

@@ -0,0 +1,23 @@
+import { AxiosInstance } from "axios";
+import { BambuPrinter } from "bambu-js";
+export type BambuFTP = {
+    readDir: (path: string) => Promise<string[]>;
+    sendFile: (sourcePath: string, destinationPath: string, progressCallback?: (progress: number) => void) => Promise<void>;
+    removeFile: (path: string) => Promise<void>;
+};
+export declare abstract class PrinterImplementation {
+    protected apiClient: AxiosInstance;
+    constructor(apiClient: AxiosInstance);
+    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>;
+}
+export declare class BambuPrinterStore {
+    private printers;
+    get(host: string, serial: string, token: string): InstanceType<typeof BambuPrinter>;
+    disconnectAll(): Promise<void>;
+}

package/dist/types.js

@@ -0,0 +1,26 @@
+import { BambuPrinter } from "bambu-js";
+// Base class for printer implementations
+export class PrinterImplementation {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+}
+// Store for Bambu printers
+export class BambuPrinterStore {
+    constructor() {
+        this.printers = new Map();
+    }
+    get(host, serial, token) {
+        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() {
+        for (const printer of this.printers.values()) {
+            await printer.disconnect();
+        }
+    }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "mcp-3d-printer-server",
+    "version": "0.1.0",
+    "description": "MCP server for connecting Claude with 3D printer management systems",
+    "main": "src/index.js",
+    "type": "module",
+    "scripts": {
+        "start": "node src/index.js",
+        "dev": "nodemon src/index.js",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "bin": {
+        "mcp-3d-printer-server": "./src/index.js"
+    },
+    "keywords": [
+        "mcp",
+        "3d-printer",
+        "octoprint",
+        "klipper",
+        "duet",
+        "repetier",
+        "bambu",
+        "prusa",
+        "creality",
+        "ender"
+    ],
+    "author": "David Montgomery",
+    "license": "GPL-2.0",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.6.0",
+        "axios": "^1.6.2",
+        "bambu-js": "^2.2.2",
+        "dotenv": "^16.3.1",
+        "form-data": "^4.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^18.0.0",
+        "nodemon": "^2.0.22"
+    }
+}

package/scripts/mcp-inspector.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+import { MCP } from '@modelcontextprotocol/sdk';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+// Configuration from environment variables
+const MCP_PORT = process.env.MCP_PORT || 3000;
+const MCP_HOST = process.env.MCP_HOST || 'localhost';
+
+async function inspectMCP() {
+  console.log('MCP Inspector Starting...');
+  console.log(`Connecting to MCP server at ${MCP_HOST}:${MCP_PORT}`);
+  
+  try {
+    const mcp = new MCP({
+      port: MCP_PORT,
+      host: MCP_HOST,
+    });
+    
+    // Get available services
+    const services = await mcp.getServices();
+    console.log('\nAvailable Services:');
+    console.table(services);
+    
+    // Test connection status
+    const status = await mcp.getStatus();
+    console.log('\nMCP Connection Status:');
+    console.table(status);
+    
+    // Get capabilities if supported
+    try {
+      const capabilities = await mcp.getCapabilities();
+      console.log('\nMCP Capabilities:');
+      console.table(capabilities);
+    } catch (e) {
+      console.log('\nCapabilities endpoint not supported or error occurred');
+    }
+    
+    console.log('\nMCP Inspection Complete');
+  } catch (error) {
+    console.error('\nError connecting to MCP server:');
+    console.error(error.message);
+    process.exit(1);
+  }
+}
+
+inspectMCP();