[{"_1":2,"_507":-5,"_508":-5},"loaderData",{"_3":4,"_22":23,"_314":315},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",16683697,"membership","referenceId","01997ec3-5d26-711c-83e8-e3c03791c852","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_80":-5,"_81":38,"_27":82,"_229":230,"_312":313},"availableLocales",[26,38,45,52,59,66,73],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","Ermöglicht die Interaktion mit 3D-Druckerverwaltungssystemen über einen MCP-Server und unterstützt die Bearbeitung, Aufteilung und Steuerung von STL-Dateien von Druckern wie OctoPrint, Klipper, Duet und mehr.","name","MCP 3D-Druckerserver","readme","# MCP 3D-Druckerserver\n\n[![npm-Version](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![Lizenz: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![Typoskript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![Wartung](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![PRs willkommen](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Node.js-Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![Downloads](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![GitHub-Stars](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* **Bambu `.3mf` -Druck:** Das Tool `print_3mf` wurde speziell für Bambu Lab-Drucker hinzugefügt. Es lädt die `.3mf` Datei hoch und sendet den Druckbefehl basierend auf den OpenBambuAPI-Spezifikationen direkt über MQTT.\n\n* **Direkte MQTT-Kommunikation (Bambu):** Die Bambu-Befehlsverarbeitung ( `print_3mf` , `cancelJob` ) wurde überarbeitet, um direktes MQTT (TLS-Port 8883) zu verwenden, anstatt sich bei Befehlen ausschließlich auf `bambu-js` zu verlassen.\n\n* **`.3mf` -Dateianalyse:** Implementierung eines Parsers ( `src/3mf_parser.ts` ) zum Lesen von Metadaten und Bambu-spezifischen Slicer-Einstellungen (aus `project_settings.config` ) in `.3mf` Dateien.\n\n* **Bambu-Vorgaberessourcen:** Unterstützung für das Lesen von Bambu Studio-Vorgabedateien ( `machine` , `filament` , `process` ) als MCP-Ressourcen (z. B. `preset://bambu/process/MyPreset` ) hinzugefügt, wenn `BAMBU_STUDIO_CONFIG_PATH` festgelegt ist.\n\n* **OrcaSlicer-Integration:** Unterstützung für die Verwendung von OrcaSlicer über seine Befehlszeilenschnittstelle für das Tool `slice_stl` hinzugefügt.\n\n* **Neue STL-Manipulationstools:** Die Tools „ `merge_vertices` , „ `center_model` “ und `lay_flat` für die grundlegende Modellvorbereitung mit `three.js` wurden hinzugefügt.\n\n* **Konfigurationsupdate:** Umgebungsvariable `BAMBU_STUDIO_CONFIG_PATH` zum Laden von Voreinstellungen hinzugefügt.\n\n* **Hinweis zur FTP-Nutzung:** In der Dokumentation wird bestätigt, dass Dateivorgänge für Bambu derzeit möglicherweise ungesichertes FTP über `bambu-js` verwenden.\n\n* **Erreichen Sie Funktionsparität:** Bringen Sie die Funktionalität (Statusdetails, Dateivorgänge, Direktdruck, wo möglich, Vorgabeverwaltung) für OctoPrint, Klipper, Duet, Repetier, Prusa Connect und Creality Cloud auf das für die Bambu-Implementierung geplante Robustheitsniveau.\n\n* **Implementieren Sie den vollständigen Bambu MQTT-Status:** Refaktorieren Sie `getStatus` für Bambu, um MQTT-Berichte zu abonnieren und den Echtzeitstatus aufrechtzuerhalten.\n\n* **Implementieren Sie eine robuste AMS-Zuordnung:** Ersetzen Sie die Platzhalterlogik; analysieren und verwenden Sie die AMS-Zuordnung aus `.3mf` Slicer-Konfiguration oder Benutzerüberschreibungen für den MQTT-Druckbefehl korrekt.\n\n* **Implementieren Sie `.3mf` Drucküberschreibungen:** Fügen Sie dem Tool `print_3mf` eine Logik hinzu, um vom Benutzer bereitgestellte Überschreibungen (z. B. Kalibrierungsflags) und möglicherweise allgemeine Slicer-Einstellungen zu verarbeiten, sofern dies über MQTT/G-Code möglich ist.\n\n* **MD5-Hash berechnen:** Fügen Sie eine Logik hinzu, um den MD5-Hash der `.3mf` Datei zu berechnen und in den MQTT-Druckbefehl einzuschließen (optional, aber vom Protokoll empfohlen).\n\n* **Bambu File Ops umgestalten:** Untersuchen Sie, ob die FTP-Operationen `bambu-js` ( `getFiles` , `uploadFile` ) sofern möglich/stabil durch direkte MQTT-Methoden ersetzt werden können, oder tragen Sie FTPS-Unterstützung zu `bambu-js` bei.\n\n* **Logik zur Voreinstellungserkennung hinzufügen:** Verbessern Sie die Auflistung voreingestellter Ressourcen (derzeit werden Listen basierend auf potenziellen Dateinamen erstellt, Indexdateien könnten analysiert werden, falls sie vorhanden sind).\n\n* **`.3mf` Unterstützung erweitern:** Fügen Sie gegebenenfalls `.3mf` Druckunterstützung für andere Druckertypen hinzu.\n\n* **Fehlerbehandlung und -berichterstattung:** Verbessern Sie die MQTT-Fehlerbehandlung und -berichterstattung zum Druckfortschritt/-abschluss.\n\n* **Testen:** Führen Sie gründliche Laufzeittests aller neuen Bambu-Funktionen durch.\n\n## Inhaltsverzeichnis\n\n* [Beschreibung](#description)\n* [Merkmale](#features)\n* [Installation](#installation)\n\n * [Voraussetzungen](#prerequisites)\n * [Von npm installieren](#install-from-npm)\n * [Von der Quelle installieren](#install-from-source)\n * [Ausführen mit Docker](#running-with-docker)\n\n * [Verwenden von Slicern mit Docker](#using-slicers-with-docker)\n* [Konfiguration](#configuration)\n* [Verwendung mit Claude Desktop](#usage-with-claude-desktop)\n* [Unterstützte Druckerverwaltungssysteme](#supported-printer-management-systems)\n\n * [OctoPrint](#octoprint)\n * [Klipper (über Moonraker)](#klipper-via-moonraker)\n * [Duett](#duet)\n * [Repetier](#repetier)\n * [Bambu Labs](#bambu-labs)\n\n * [So finden Sie die Seriennummer und den Zugriffstoken Ihres Bambu-Druckers](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Bambu-Kommunikationshinweise (MQTT und FTP)](#bambu-communication-notes-mqtt--ftp)\n * [Prusa Connect](#prusa-connect)\n\n * [Einrichten von Prusa Connect](#setting-up-prusa-connect)\n * [Creality Cloud](#creality-cloud)\n\n * [Creality Cloud einrichten](#setting-up-creality-cloud)\n* [Verfügbare Tools](#available-tools)\n\n * [STL-Manipulationswerkzeuge](#stl-manipulation-tools)\n * [Druckersteuerungstools](#printer-control-tools)\n * [Bambu-spezifische Werkzeuge](#bambu-specific-tools)\n* [Verfügbare Ressourcen](#available-resources)\n\n * [Druckerressourcen](#printer-resources)\n * [Bambu-Vorgaberessourcen](#bambu-preset-resources)\n* [Beispielbefehle für LLM](#example-commands-for-claude)\n* [Einschränkungen des Bambu Lab-Druckers](#bambu-lab-printer-limitations)\n* [Einschränkungen und Überlegungen](#limitations-and-considerations)\n\n * [Speichernutzung](#memory-usage)\n * [Einschränkungen bei der STL-Manipulation](#stl-manipulation-limitations)\n * [Visualisierungsbeschränkungen](#visualization-limitations)\n * [Überlegungen zur Leistung](#performance-considerations)\n * [Testempfehlungen](#testing-recommendations)\n* [Abzeichen](#badges)\n* [Lizenz](#license)\n\n## Beschreibung\n\nDies ist ein Server, der es MCP-Benutzern ermöglicht, eine Verbindung mit den API-Endpunkten dieser 3D-Drucker herzustellen:\n\n* OctoPrint\n* Klipper (Moonraker)\n* Duett\n* Repetier\n* Bambu Labs\n* Prusa Connect\n* Creality/Ender\n\nDieser Server ist ein Model Context Protocol (MCP)-Server zur Verbindung von Claude mit 3D-Druckerverwaltungssystemen. Er ermöglicht MCP die Interaktion mit 3D-Druckern über die APIs verschiedener Druckerverwaltungssysteme wie OctoPrint, Klipper (über Moonraker), Duet, Repetier und Bambu Labs-Druckern.\n\n**Hinweis zur Ressourcennutzung** : Dieser MCP-Server enthält erweiterte Funktionen zur 3D-Modellbearbeitung, die bei der Arbeit mit großen STL-Dateien speicherintensiv sein können. Wichtige Informationen zu Speichernutzung und Leistung finden Sie im Abschnitt „Einschränkungen und Hinweise“.\n\n## Merkmale\n\n* Druckerstatus abrufen (Temperaturen, Druckfortschritt usw.)\n* Auflisten der Dateien auf dem Drucker\n* G-Code-Dateien auf den Drucker hochladen\n* Druckaufträge starten, abbrechen und überwachen\n* Druckertemperaturen einstellen\n* Erweiterte STL-Dateibearbeitung:\n * Verlängern Sie die Basis für eine bessere Haftung\n * Modelle gleichmäßig oder entlang bestimmter Achsen skalieren\n * Drehen Sie Modelle um jede Achse\n * Modelle übersetzen (verschieben)\n * Ändern Sie bestimmte Abschnitte von STL-Dateien (oben, unten, Mitte oder benutzerdefiniert).\n* Umfassende STL-Analyse mit detaillierten Modellinformationen\n* Generieren Sie SVG-Visualisierungen aus mehreren Winkeln von STL-Dateien\n* Echtzeit-Fortschrittsberichte für lange Operationen\n* Fehlerbehandlung mit detaillierter Diagnose\n* Schneiden Sie STL-Dateien, um G-Code zu generieren\n* Temperatureinstellungen in G-Code-Dateien bestätigen\n* Vollständiger End-to-End-Workflow von der STL-Änderung bis zum Druck\n* Drucken Sie `.3mf` -Dateien direkt auf Bambu Lab-Druckern (über MQTT-Befehl)\n* Lesen Sie Bambu Studio-Vorgabedateien (Drucker, Filament, Prozess) als Ressourcen\n\n## Installation\n\n### Voraussetzungen\n\n* Node.js 18 oder höher\n* npm oder yarn\n\n### Von npm installieren\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### Von der Quelle installieren\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Ausführen mit Docker\n\nSie können den Server auch mit Docker und Docker Compose für eine Containerumgebung ausführen.\n\n1. Stellen Sie sicher, dass Sie Docker und Docker Compose installiert haben.\n\n2. Kopieren Sie `.env.example` nach `.env` und konfigurieren Sie Ihre Einstellungen.\n\n3. Erstellen und Ausführen des Containers:\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### Verwenden von Slicern mit Docker\n\nBitte beachten Sie, dass das Standard-Docker-Setup **einen auf Ihrem Host-Rechner installierten Slicer nicht direkt verwenden kann** . Das direkte Einbinden der Slicer-Programmdatei vom Host in den Container ist aufgrund von Betriebssystem- und Bibliotheksunterschieden zwischen Ihrem Host und dem Container unzuverlässig.\n\nDer empfohlene Ansatz besteht darin **, Ihren bevorzugten Slicer *im* Docker-Image zu installieren** . Dadurch wird der Container autark.\n\nDazu müssen Sie die `Dockerfile` anpassen. Hier ist ein konzeptionelles Beispiel, wie Sie PrusaSlicer oder OrcaSlicer hinzufügen können (die spezifischen Befehle können je nach Slicer, seinen Abhängigkeiten und den aktuellen Alpine-Paketen variieren):\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\nNachdem Sie die `Dockerfile` geändert haben, erstellen Sie Ihr Image neu ( `docker-compose build` ). Stellen Sie außerdem sicher, dass die Umgebungsvariable `SLICER_PATH` in Ihrer `.env` Datei oder `docker-compose.yml` auf den richtigen Pfad *innerhalb des Containers* verweist (z. `/usr/local/bin/orcaslicer` ). Setzen Sie `SLICER_TYPE` ebenfalls auf `orcaslicer` .\n\nEs tut uns leid, dass kein bestimmter Slicer standardmäßig enthalten ist. Angesichts der großen Auswahl an Slicern (PrusaSlicer, OrcaSlicer, Cura usw.) und verfügbaren Konfigurationen würde die Vorinstallation eines Slicers das Image für viele Benutzer unnötig aufblähen. Sollte ein bestimmter Slicer häufig nachgefragt werden, kann ich mich in einer zukünftigen Version um die offizielle Unterstützung dafür kümmern.\n\n## Konfiguration\n\nErstellen Sie eine `.env` Datei in dem Verzeichnis, in dem Sie den Server ausführen oder Umgebungsvariablen festlegen:\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Verwendung mit Claude Desktop\n\n1. Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. Für Bambu Labs-Drucker:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Starten Sie Claude Desktop neu\n4. Verbinden Sie sich über Claude mit Ihrem Drucker\n\n## Unterstützte Druckerverwaltungssysteme\n\n### OctoPrint\n\nOctoPrint ist eine beliebte Weboberfläche für 3D-Drucker. Sie bietet eine REST-API zur Steuerung des Druckers.\n\n* Standardport: 80 (http) oder 443 (https)\n* Authentifizierung: API-Schlüssel erforderlich\n\n### Klipper (über Moonraker)\n\nKlipper ist eine Firmware für 3D-Drucker, die mit dem Moonraker-API-Server funktioniert.\n\n* Standardport: 7125\n* Authentifizierung: Hängt von Ihrer Moonraker-Konfiguration ab\n\n### Duett\n\nDuet ist eine Steuerplatine für 3D-Drucker mit eigener Weboberfläche (DuetWebControl).\n\n* Standardport: 80 (http) oder 443 (https)\n* Authentifizierung: Hängt von Ihrer Duet-Konfiguration ab\n\n### Repetier\n\nRepetier-Server ist eine Host-Software für 3D-Drucker.\n\n* Standardport: 3344\n* Authentifizierung: API-Schlüssel erforderlich\n\n### Bambu Labs\n\nBambu Lab-Drucker verwenden MQTT für Status und Steuerung und FTP für Dateivorgänge.\n\n* Authentifizierung: Seriennummer und Zugriffstoken erforderlich ( `BAMBU_SERIAL` und `BAMBU_TOKEN` festlegen)\n* Voraussetzungen: Der Drucker muss sich im selben Netzwerk befinden oder eine aktivierte Cloud-Verbindung haben\n* Kompatibel mit: X1C, P1S, P1P, A1 und anderen Bambu Lab-Druckern\n\n#### So finden Sie die Seriennummer und den Zugriffstoken Ihres Bambu-Druckers\n\nUm eine Verbindung zu Ihrem Bambu Lab-Drucker herzustellen, benötigen Sie zwei Dinge:\n\n1. **Seriennummer des Druckers** :\n\n * Suchen Sie auf der Rückseite oder Unterseite Ihres Druckers nach einem Aufkleber mit einer Seriennummer (beginnt normalerweise mit „01P“ oder „01A“, gefolgt von Zahlen/Buchstaben).\n * Alternativ können Sie Bambu Studio öffnen, eine Verbindung zu Ihrem Drucker herstellen, zu Gerät > Geräteverwaltung gehen und die Informationen Ihres Druckers anzeigen.\n\n2. **Zugriffstoken** :\n\n * Das Zugriffstoken ist ein Sicherheitscode, der für die direkte Verbindung mit Ihrem Drucker erforderlich ist\n * Für Drucker der P1-Serie: Gehen Sie zum Touchscreen, wählen Sie Einstellungen > Netzwerk > LAN-Modus, und Sie sehen den Zugangscode\n * Für Drucker der X1-Serie: Gehen Sie zum Touchscreen, wählen Sie Einstellungen > Netzwerk > LAN-Modus und aktivieren Sie den LAN-Modus, um den Zugangscode anzuzeigen\n * Für A1 Mini: Verwenden Sie die Bambu Handy-App, um eine Verbindung zu Ihrem Drucker herzustellen, und gehen Sie dann zu Einstellungen > Netzwerk > LAN-Modus\n\n**Hinweis** : Wenn sich Ihr Drucker nicht im selben lokalen Netzwerk befindet oder Sie das Zugriffstoken nicht finden können, müssen Sie möglicherweise die Firmware Ihres Druckers auf die neueste Version aktualisieren, um den LAN-Modus zu aktivieren.\n\n#### Bambu-Kommunikationshinweise (MQTT und FTP)\n\n* **MQTT:** Dieser Server verwendet das lokale MQTT-Protokoll (Port 8883, TLS) basierend auf Community-Erkenntnissen (z. B. [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) ), um Befehle wie das Starten von Drucken und Abbrechen von Aufträgen zu senden.\n* **FTP:** Das Auflisten und Hochladen von Dateien erfolgt derzeit über den FTP-Server des Druckers (über die Hilfsbibliothek `bambu-js` ). **Hinweis:** Diese FTP-Verbindung ist aufgrund aktueller Bibliothekseinschränkungen möglicherweise **ungesichert (einfaches FTP)** . Achten Sie bei der Verwendung auf Ihre Netzwerksicherheit.\n\n### Prusa Connect\n\nPrusa Connect ist Prusas eigene Cloud-basierte Lösung zur Verwaltung ihrer Drucker.\n\n* Standardport: 80 (http) oder 443 (https)\n* Authentifizierung: API-Schlüssel erforderlich\n* Kompatibel mit: Prusa MK4, Prusa Mini, Prusa XL und anderen Prusa-Druckern mit Prusa Connect\n\n#### Einrichten von Prusa Connect\n\n1. Stellen Sie sicher, dass Ihr Prusa-Drucker auf die neueste Firmware aktualisiert ist\n2. Verbinden Sie Ihren Drucker mit Ihrem WLAN-Netzwerk\n3. Erstellen Sie ein Prusa Connect-Konto und registrieren Sie Ihren Drucker\n4. Generieren Sie einen API-Schlüssel über die Prusa Connect-Weboberfläche unter Einstellungen > API-Zugriff\n\n### Creality Cloud\n\nCreality Cloud ist das Verwaltungssystem von Creality für seine Drucker.\n\n* Standardport: 80 (http) oder 443 (https)\n* Authentifizierung: Bearer-Token erforderlich\n* Kompatibel mit: Ender-Serie, CR-Serie und anderen Creality-Druckern mit Netzwerkfunktionen\n\n#### Creality Cloud einrichten\n\n1. Installieren Sie die Creality Cloud-App auf Ihrem Mobilgerät\n2. Erstellen Sie ein Konto und fügen Sie Ihren Drucker hinzu\n3. Aktivieren Sie den lokalen Netzwerkzugriff für Ihren Drucker\n4. Generieren Sie ein Token aus der Creality Cloud-App unter Einstellungen > Entwickleroptionen\n\n## Verfügbare Tools\n\n### STL-Manipulationswerkzeuge\n\n> **Hinweis zur Speichernutzung** : Die folgenden STL-Manipulationswerkzeuge laden ganze 3D-Modelle in den Speicher. Bei großen oder komplexen STL-Dateien (> 10 MB) können diese Vorgänge erheblichen Speicherbedarf haben. Beachten Sie bei der Verwendung dieser Werkzeuge in der MCP-Umgebung die Speicherbeschränkungen.\n\n#### get\\_stl\\_info\n\nErhalten Sie detaillierte Informationen zu einer STL-Datei, einschließlich Abmessungen, Scheitelpunktanzahl und Begrenzungsrahmen.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### extend\\_stl\\_base\n\nErweitern Sie die Basis einer STL-Datei um einen angegebenen Betrag.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### scale\\_stl\n\nSkalieren Sie ein STL-Modell gleichmäßig oder entlang bestimmter Achsen.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\nOder für nicht einheitliche Skalierung:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### rotate\\_stl\n\nDrehen Sie ein STL-Modell um bestimmte Achsen (in Grad).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### translate\\_stl\n\nVerschieben Sie ein STL-Modell entlang bestimmter Achsen (in Millimetern).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### Eckpunkte zusammenführen\n\nScheitelpunkte zusammenführen, die näher als eine angegebene Toleranz liegen. Hilft beim Schließen kleiner Lücken und kann das Netz etwas vereinfachen.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### Center-Modell\n\nVerschieben Sie das Modell so, dass sich der Mittelpunkt seines Begrenzungsrahmens am Weltursprung (0,0,0) befindet.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### flach legen\n\nVersuchen Sie, die größte flache Oberfläche des Modells zu identifizieren (die nicht bereits direkt nach oben oder unten zeigt) und drehen Sie das Modell so, dass diese Fläche in der XY-Ebene (Z = 0) nach unten zeigt. Nützlich für die Ausrichtung von Modellen für den Druck.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### STL-Abschnitt ändern\n\nWenden Sie eine spezifische Transformation auf einen ausgewählten Abschnitt einer STL-Datei an. Dies ermöglicht detaillierte Änderungen bestimmter Teile eines Modells.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\nFür benutzerdefinierte Abschnittsgrenzen:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### generate\\_stl\\_visualization\n\nErstellen Sie eine SVG-Visualisierung einer STL-Datei aus mehreren Winkeln (Vorder-, Seiten-, Draufsicht und isometrische Ansicht).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### slice\\_stl\n\nSchneiden Sie eine STL-Datei in Scheiben, um G-Code zu generieren.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### Temperaturen bestätigen\n\nBestätigen Sie die Temperatureinstellungen in einer G-Code-Datei.\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### process\\_and\\_print\\_stl\n\nVerarbeiten Sie eine STL-Datei (erweitern Sie die Basis), schneiden Sie sie in Scheiben, bestätigen Sie die Temperaturen und starten Sie den Druckvorgang.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n**Hinweis:** Die automatische Ausrichtung für optimalen Druck (Minimierung der Stützen usw.) ist eine komplexe Aufgabe, die normalerweise von Slicer-GUIs (wie OrcaSlicer oder PrusaSlicer) übernommen wird und auf diesem Server nicht implementiert ist.\n\n### Druckersteuerungstools\n\n#### Druckerstatus abrufen\n\nErhalten Sie den aktuellen Status des 3D-Druckers.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBei Bambu-Druckern bestätigt dies derzeit nur die MQTT-Verbindung.\n\n#### Druckerdateien auflisten\n\nAuf dem Drucker verfügbare Dateien auflisten.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nListet für Bambu-Drucker Dateien im `gcodes` -Verzeichnis per FTP auf.\n\n#### Gcode hochladen\n\nLaden Sie eine G-Code-Datei auf den Drucker hoch.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nBei Bambu-Druckern erfolgt das Hochladen in das `gcodes` -Verzeichnis per FTP. Der Druckvorgang kann nicht automatisch gestartet werden.\n\n#### start\\_print\n\nStarten Sie den Druck einer Datei, die sich bereits auf dem Drucker befindet.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**Nicht für Bambu-Drucker empfohlen.** Verwenden Sie `print_3mf` für Bambu- `.3mf` -Dateien.\n\n#### Abbrechen\\_Drucken\n\nDen aktuellen Druckauftrag abbrechen.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nSendet für Bambu-Drucker den Befehl `stop_print` über MQTT.\n\n#### Druckertemperatur einstellen\n\nStellen Sie die Temperatur einer Druckerkomponente ein.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**Wird für Bambu-Drucker über direkte MQTT-Befehle nicht unterstützt** .\n\n### Bambu-spezifische Werkzeuge\n\n#### print\\_3mf\n\nLädt eine `.3mf` Datei per FTP auf einen Bambu-Drucker hoch und startet den Druckauftrag über einen MQTT-Befehl. Ermöglicht das Überschreiben einiger Druckparameter wie AMS-Mapping.\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n**Hinweis:** Das Überschreiben von Slicer-Einstellungen wie Schichthöhe oder Temperatur über dieses Tool wird vom MQTT-Befehl des Druckers nicht unterstützt. Nehmen Sie diese Änderungen vor dem Generieren der `.3mf` Datei vor.\n\n## Verfügbare Ressourcen\n\n### Druckerressourcen\n\n* `printer://{host}/status` – Aktueller Status des 3D-Druckers (derzeit für Bambu eingeschränkt)\n* `printer://{host}/files` – Liste der auf dem 3D-Drucker verfügbaren Dateien (FTP für Bambu)\n* `printer://{host}/file/{filename}` – Inhalt einer bestimmten G-Code-Datei (überprüft die Existenz nur für Bambu)\n\n### Bambu Preset Ressourcen\n\nWenn die Umgebungsvariable `BAMBU_STUDIO_CONFIG_PATH` auf Ihr Bambu Studio-Benutzereinstellungsverzeichnis eingestellt ist, können Sie Ihre gespeicherten Voreinstellungen lesen.\n\n* `preset://bambu/machine/{preset_name}` – Liest eine Maschinenvorgabedatei (z. B. `Bambu Lab P1S 0.4 nozzle.json` )\n* `preset://bambu/filament/{preset_name}` – Liest eine Filament-Vorgabedatei (z. `Generic PLA.json` )\n* `preset://bambu/process/{preset_name}` – Liest eine Prozessvorgabedatei (z. `0.20mm Standard @BBL P1S.json` )\n\n**Anwendungsbeispiel:** „Lies den Inhalt meiner Bambu-Prozessvorgabe mit dem Namen ‚0.16mm Optimal @BBL P1S‘“ (Claude würde ReadResource mit `preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S` aufrufen)\n\n## Beispielbefehle für Claude\n\nHier sind einige Beispielbefehle, die Sie Claude geben können, nachdem Sie eine Verbindung zum MCP-Server hergestellt haben:\n\n### Druckersteuerung\n\n* „Wie ist der aktuelle Status meines 3D-Druckers?“\n* „Zeigen Sie mir die Liste der Dateien auf meinem Drucker.“\n* „Laden Sie diesen G-Code auf meinen Drucker hoch: \\[G-Code-Inhalt]“\n* „Starten Sie den Druck der Datei mit dem Namen ‚benchy.gcode‘.“\n* \"Brechen Sie den aktuellen Druckauftrag ab.\"\n* „Stellen Sie die Extrudertemperatur auf 200 °C ein.“\n* „Stellen Sie die Betttemperatur auf 60 °C ein.“\n\n### STL-Manipulation und -Druck\n\n* „Nehmen Sie diese STL-Datei und erweitern Sie die Basis um 2 Zoll, senden Sie sie dann an den Slicer und stellen Sie sie in die Warteschlange meines Druckers.“\n* „Erweitern Sie die Basis von model.stl um 1,5 Zoll.“\n* „Skalieren Sie diese STL-Datei gleichmäßig um 150 %.“\n* „Skalieren Sie model.stl so, dass es doppelt so breit ist, aber die gleiche Höhe behält.“\n* „Drehen Sie dieses Modell um 90 Grad um die Z-Achse.“\n* „Verschieben Sie dieses STL-Modell um 5 mm nach oben, um darunter eine Lücke zu erzeugen.“\n* „Können Sie nur den oberen Teil dieses Modells so verändern, dass es 20 % größer wird?“\n* „Analysieren Sie diese STL-Datei und teilen Sie mir ihre Abmessungen und Details mit.“\n* „Erstellen Sie eine Visualisierung dieser STL-Datei, damit ich sehen kann, wie sie aussieht.“\n* „SVG-Visualisierungen meines Modells aus verschiedenen Blickwinkeln erstellen.“\n* „Machen Sie die Basis dieses Modells breiter, ohne die Höhe zu verändern.“\n* „Schneiden Sie die geänderte STL-Datei mit PrusaSlicer.“\n* „Bestätigen Sie, dass die Temperaturen im G-Code 200 °C für den Extruder und 60 °C für das Bett betragen.“\n* „Verarbeiten Sie diese STL-Datei, verlängern Sie die Basis um 2 Zoll, schneiden Sie sie in Scheiben und beginnen Sie mit dem Drucken. Bestätigen Sie jedoch zuerst die Temperaturen.“\n* „Drucken Sie `~/Downloads/my_model.3mf` auf dem Bambu-Drucker.“\n* „Laden Sie `~/Desktop/calibration_cube.3mf` über die AMS-Steckplätze 0 und 2 auf den Bambu-Drucker hoch und schalten Sie die Bettnivellierung aus.“\n* „Brechen Sie den Druckauftrag auf meinem Bambu P1S ab.“\n* „Was sind die Einstellungen in meiner Bambu-Filamentvoreinstellung ‚Generic PETG‘?“\n* „Zeigen Sie mir meine Bambu-Prozessvorgaben.“\n\n## Einschränkungen des Bambu Lab-Druckers\n\nAufgrund der Art der Bambu Lab-Drucker-API gibt es einige Einschränkungen:\n\n1. **Druckvorgänge starten** : Zum Starten eines Druckvorgangs sind der 3MF-Projektdateipfad, der G-Code-Dateiname, der Druckname und der MD5-Hash erforderlich. Die vereinfachte API auf diesem Server unterstützt dies noch nicht vollständig.\n\n2. **Temperaturregelung** : Die Bambu-API bietet keine direkten Methoden zum Einstellen von Temperaturen. Dies würde benutzerdefinierte G-Code-Befehle erfordern.\n\n3. **Dateiverwaltung** : Dateien müssen in das Verzeichnis „gcodes“ auf dem Drucker hochgeladen werden.\n\n4. **FTP-Sicherheit:** Dateivorgänge verwenden derzeit den FTP-Server des Druckers, der möglicherweise ungesichert ist (einfaches FTP).\n\n5. **Parameterüberschreibungen:** Nur vom MQTT-Befehl `project_file` unterstützte Parameter können über das Tool `print_3mf` überschrieben werden (z. B. AMS-Nutzung, Kalibrierungsflags). Slicer-Einstellungen wie Schichthöhe oder Temperatur können zum Druckzeitpunkt über diesen Befehl nicht geändert werden.\n\n6. **Statusaktualisierungen:** Die vollständige Echtzeit-Statusüberwachung über MQTT muss weiter implementiert werden.\n\n## Einschränkungen und Überlegungen\n\n### Speichernutzung\n\n* **Große STL-Dateien** : Die Verarbeitung großer oder komplexer STL-Dateien kann viel Speicherplatz beanspruchen. Die gesamte STL-Geometrie wird während der Verarbeitung in den Speicher geladen.\n* **Mehrere Vorgänge** : Das Ausführen mehrerer STL-Vorgänge nacheinander (insbesondere bei großen Dateien) kann zu einer Anhäufung von Speicher führen, wenn die Speicherbereinigung nicht Schritt hält.\n* **MCP-Umgebung** : Da dies als MCP-Server ausgeführt wird, beachten Sie, dass Claudes MCP-Umgebung Speicherbeschränkungen aufweist. Komplexe Operationen an sehr großen STL-Dateien können zu Speicherproblemen führen.\n\n### Einschränkungen bei der STL-Manipulation\n\n* **Abschnittsänderung** : Die abschnittsspezifische Änderungsfunktion eignet sich am besten für einfachere Geometrien. Komplexe oder nicht-mannigfaltige Netze können zu unerwarteten Ergebnissen führen.\n* **Basiserweiterung** : Der Basiserweiterungsalgorithmus fügt eine neue Geometrie unterhalb des Modells hinzu. Bei Modellen mit komplexen Unterseiten sind die Ergebnisse möglicherweise nicht perfekt.\n* **Fehlerbehandlung** : Obwohl wir eine robuste Fehlerbehandlung hinzugefügt haben, können einige Randfälle in komplexen STL-Dateien weiterhin Probleme verursachen.\n\n### Visualisierungsbeschränkungen\n\n* **SVG-Darstellung** : Die SVG-Visualisierung ist eine vereinfachte schematische Darstellung, kein echtes 3D-Rendering.\n* **Komplexe Modelle** : Bei sehr komplexen Modellen kann es sein, dass die Visualisierung nicht alle Details genau darstellt.\n\n### Überlegungen zur Leistung\n\n* **Slicing-Vorgänge** : Externe Slicer-Prozesse können CPU-intensiv sein und bei komplexen Modellen viel Zeit in Anspruch nehmen.\n* **Fortschrittsberichte** : Bei großen Dateien kann es vorkommen, dass die Fortschrittsaktualisierungen in bestimmten Verarbeitungsphasen ins Stocken geraten.\n\n### Testempfehlungen\n\n* Beginnen Sie mit kleineren STL-Dateien (< 10 MB), um die Funktionalität zu testen\n* Überwachen Sie die Speichernutzung bei der Verarbeitung großer Dateien\n* Testen Sie Änderungen an einfachen Geometrien, bevor Sie komplexe Änderungen vornehmen.\n* Erwägen Sie die Ausführung auf einem System mit mindestens 4 GB freiem RAM für größere Operationen\n\n## Abzeichen\n\n| Abzeichen | Beschreibung |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------- |\n| [![npm-Version](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Die aktuelle Version des Pakets auf npm |\n| [![Lizenz: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | Dieses Projekt ist unter GPL-2.0 lizenziert |\n| [![Typoskript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | Dieses Projekt ist in TypeScript 4.9+ geschrieben |\n| [![Wartung](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | Dieses Projekt wird aktiv gepflegt |\n| [![PRs willkommen](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | Wir freuen uns über Beiträge über Pull Requests |\n| [![Node.js-Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Erfordert Node.js 18.0.0 oder höher |\n| [![Downloads](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Anzahl der Downloads pro Monat von npm |\n| [![GitHub-Stars](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | Anzahl der GitHub-Sterne, die dieses Projekt erhalten hat |\n\n## Lizenz\n\nGPL-2.0","German","tag","de-DE",{"_27":39,"_31":43,"_36":44},{"_29":40,"_31":41,"_33":42},"Enables interaction with 3D printer management systems through an MCP server, supporting STL file manipulation, slicing, and control of printers like OctoPrint, Klipper, Duet, and more.","MCP 3D Printer Server","# MCP 3D Printer Server\n\n[![npm version](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server)\n[![License: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)\n[![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/)\n[![Downloads](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server)\n[![GitHub stars](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n\n $\"3D$ \n\n\n

✨ What's New / Significant Updates (as of last session)

\n\n- **Bambu `.3mf` Printing:** Added the `print_3mf` tool specifically for Bambu Lab printers. This uploads the `.3mf` file and sends the print command directly via MQTT based on OpenBambuAPI specs.\n- **Direct MQTT Communication (Bambu):** Refactored Bambu command handling (`print_3mf`, `cancelJob`) to use direct MQTT (TLS port 8883) instead of relying solely on `bambu-js` for commands.\n- **`.3mf` File Parsing:** Implemented a parser (`src/3mf_parser.ts`) to read metadata and Bambu-specific slicer settings (from `project_settings.config`) within `.3mf` files.\n- **Bambu Preset Resources:** Added support for reading Bambu Studio preset files (`machine`, `filament`, `process`) as MCP resources (e.g., `preset://bambu/process/MyPreset`) if `BAMBU_STUDIO_CONFIG_PATH` is set.\n- **OrcaSlicer Integration:** Added support for using OrcaSlicer via its command-line interface for the `slice_stl` tool.\n- **New STL Manipulation Tools:** Added `merge_vertices`, `center_model`, and `lay_flat` tools for basic model preparation using `three.js`.\n- **Configuration Update:** Added `BAMBU_STUDIO_CONFIG_PATH` environment variable for preset loading.\n- **FTP Usage Note:** Acknowledged in documentation that file operations for Bambu currently use potentially unsecured FTP via `bambu-js`.\n\n

\n\n

🗺️ Roadmap / TODO

\n\n- **Achieve Feature Parity:** Bring functionality (status detail, file operations, direct printing where possible, preset handling) for OctoPrint, Klipper, Duet, Repetier, Prusa Connect, and Creality Cloud up to the level of robustness planned for the Bambu implementation.\n- **Implement Full Bambu MQTT Status:** Refactor `getStatus` for Bambu to subscribe to MQTT reports and maintain real-time state.\n- **Implement Robust AMS Mapping:** Replace placeholder logic; correctly parse and use AMS mapping from `.3mf` slicer config or user overrides for the MQTT print command.\n- **Implement `.3mf` Print Overrides:** Add logic to the `print_3mf` tool to handle user-provided overrides (e.g., calibration flags) and potentially common slicer settings if feasible via MQTT/G-code.\n- **Calculate MD5 Hash:** Add logic to calculate and include the MD5 hash of the `.3mf` file in the MQTT print command (optional but recommended by protocol).\n- **Refactor Bambu File Ops:** Investigate replacing `bambu-js` FTP operations (`getFiles`, `uploadFile`) with direct MQTT methods if possible/stable, or contribute FTPS support to `bambu-js`.\n- **Add Preset Discovery Logic:** Improve preset resource listing (currently lists based on potential filenames, could parse index files if they exist).\n- **Expand `.3mf` Support:** Add `.3mf` printing support for other printer types where applicable.\n- **Error Handling & Reporting:** Enhance MQTT error handling and reporting of print progress/completion.\n- **Testing:** Conduct thorough runtime testing of all new Bambu features.\n\n

\n\n

Click to expand Table of Contents

\n\n## Table of Contents\n\n- [Description](#description)\n- [Features](#features)\n- [Installation](#installation)\n - [Prerequisites](#prerequisites)\n - [Install from npm](#install-from-npm)\n - [Install from source](#install-from-source)\n - [Running with Docker](#running-with-docker)\n - [Using Slicers with Docker](#using-slicers-with-docker)\n- [Configuration](#configuration)\n- [Usage with Claude Desktop](#usage-with-claude-desktop)\n- [Supported Printer Management Systems](#supported-printer-management-systems)\n - [OctoPrint](#octoprint)\n - [Klipper (via Moonraker)](#klipper-via-moonraker)\n - [Duet](#duet)\n - [Repetier](#repetier)\n - [Bambu Labs](#bambu-labs)\n - [Finding Your Bambu Printer's Serial Number and Access Token](#finding-your-bambu-printers-serial-number-and-access-token)\n - [Bambu Communication Notes (MQTT & FTP)](#bambu-communication-notes-mqtt--ftp)\n - [Prusa Connect](#prusa-connect)\n - [Setting up Prusa Connect](#setting-up-prusa-connect)\n - [Creality Cloud](#creality-cloud)\n - [Setting up Creality Cloud](#setting-up-creality-cloud)\n- [Available Tools](#available-tools)\n - [STL Manipulation Tools](#stl-manipulation-tools)\n - [Printer Control Tools](#printer-control-tools)\n - [Bambu-Specific Tools](#bambu-specific-tools)\n- [Available Resources](#available-resources)\n - [Printer Resources](#printer-resources)\n - [Bambu Preset Resources](#bambu-preset-resources)\n- [Example Commands for LLM](#example-commands-for-claude)\n- [Bambu Lab Printer Limitations](#bambu-lab-printer-limitations)\n- [Limitations and Considerations](#limitations-and-considerations)\n - [Memory Usage](#memory-usage)\n - [STL Manipulation Limitations](#stl-manipulation-limitations)\n - [Visualization Limitations](#visualization-limitations)\n - [Performance Considerations](#performance-considerations)\n - [Testing Recommendations](#testing-recommendations)\n- [Badges](#badges)\n- [License](#license)\n\n

\n\n## Description\n\nThis is a server that allows MCP users to connect with the API endpoints of these 3D Printers: \n\n- OctoPrint\n- Klipper (Moonraker)\n- Duet\n- Repetier\n- Bambu Labs\n- Prusa Connect\n- Creality/Ender\n\nThis server is a Model Context Protocol (MCP) server for connecting Claude with 3D printer management systems. It allows MCP to interact with 3D printers through the APIs of various printer management systems such as OctoPrint, Klipper (via Moonraker), Duet, Repetier, and Bambu Labs printers.\n\n**Note on Resource Usage**: This MCP server includes advanced 3D model manipulation features that can be memory-intensive when working with large STL files. Please see the \"Limitations and Considerations\" section for important information about memory usage and performance.\n\n## Features\n\n- Get printer status (temperatures, print progress, etc.)\n- List files on the printer\n- Upload G-code files to the printer\n- Start, cancel, and monitor print jobs\n- Set printer temperatures\n- Advanced STL file manipulation:\n - Extend base for better adhesion\n - Scale models uniformly or along specific axes\n - Rotate models around any axis\n - Translate (move) models\n - Modify specific sections of STL files (top, bottom, center, or custom)\n- Comprehensive STL analysis with detailed model information\n- Generate multi-angle SVG visualizations of STL files\n- Real-time progress reporting for long operations\n- Error handling with detailed diagnostics\n- Slice STL files to generate G-code\n- Confirm temperature settings in G-code files\n- Complete end-to-end workflow from STL modification to printing\n- Print `.3mf` files directly on Bambu Lab printers (via MQTT command)\n- Read Bambu Studio preset files (printer, filament, process) as resources\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18 or higher\n- npm or yarn\n\n### Install from npm\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### Install from source\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Running with Docker\n\nYou can also run the server using Docker and Docker Compose for a containerized environment.\n\n1. Ensure you have Docker and Docker Compose installed.\n2. Copy `.env.example` to `.env` and configure your settings.\n3. Build and run the container:\n ```bash\n docker-compose up --build -d\n ```\n\n#### Using Slicers with Docker\n\nPlease note that the default Docker setup **cannot directly use a slicer installed on your host machine**. Mounting the slicer executable directly from the host into the container is unreliable due to operating system and library differences between your host and the container.\n\nThe recommended approach is to **install your preferred slicer *inside* the Docker image**. This makes the container self-sufficient.\n\nTo do this, you will need to modify the `Dockerfile`. Here's a conceptual example of how you might add PrusaSlicer or OrcaSlicer (specific commands may vary depending on the slicer, its dependencies, and current Alpine packages):\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\nAfter modifying the `Dockerfile`, rebuild your image (`docker-compose build`). You'll also need to ensure the `SLICER_PATH` environment variable in your `.env` file or `docker-compose.yml` points to the correct path *inside the container* (e.g., `/usr/local/bin/orcaslicer`). Set `SLICER_TYPE` to `orcaslicer` as well.\n\nApologies for not including a specific slicer out-of-the-box, but given the wide variety of slicers (PrusaSlicer, OrcaSlicer, Cura, etc.) and configurations available, pre-installing one would unnecessarily bloat the image for many users. If a particular slicer becomes a very common request, I can certainly look into adding official support for it in a future version.\n\n## Configuration\n\nCreate a `.env` file in the directory where you'll run the server or set environment variables:\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Usage with Claude Desktop\n\n1. Edit your Claude Desktop configuration file:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. For Bambu Labs printers:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Restart Claude Desktop\n4. Connect to your printer through Claude\n\n## Supported Printer Management Systems\n\n### OctoPrint\n\nOctoPrint is a popular web interface for 3D printers. It provides a REST API for controlling the printer.\n\n- Default port: 80 (http) or 443 (https)\n- Authentication: API key required\n\n### Klipper (via Moonraker)\n\nKlipper is a firmware for 3D printers that works with the Moonraker API server.\n\n- Default port: 7125\n- Authentication: Depends on your Moonraker configuration\n\n### Duet\n\nDuet is a control board for 3D printers with its own web interface (DuetWebControl).\n\n- Default port: 80 (http) or 443 (https)\n- Authentication: Depends on your Duet configuration\n\n### Repetier\n\nRepetier-Server is a host software for 3D printers.\n\n- Default port: 3344\n- Authentication: API key required\n\n### Bambu Labs\n\nBambu Lab printers use MQTT for status and control and FTP for file operations.\n\n- Authentication: Serial number and access token required (set `BAMBU_SERIAL` and `BAMBU_TOKEN`)\n- Requirements: Printer must be on the same network or have cloud connection enabled\n- Compatible with: X1C, P1S, P1P, A1, and other Bambu Lab printers\n\n#### Finding Your Bambu Printer's Serial Number and Access Token\n\nTo connect to your Bambu Lab printer, you need two things:\n\n1. **Printer Serial Number**: \n - Look on the back or bottom of your printer for a sticker with a serial number (typically starts with \"01P\" or \"01A\" followed by numbers/letters)\n - Alternatively, open Bambu Studio, connect to your printer, go to Device > Device Management, and view your printer's information\n\n2. **Access Token**: \n - The access token is a security code needed to connect directly to your printer\n - For P1 Series printers: Go to the touchscreen, select Settings > Network > LAN Mode, and you'll see the access code\n - For X1 Series printers: Go to the touchscreen, select Settings > Network > LAN Mode, and enable LAN Mode to see the access code\n - For A1 Mini: Use the Bambu Handy app to connect to your printer, then go to Settings > Network > LAN Mode\n\n**Note**: If your printer is not on the same local network or you can't find the access token, you may need to update your printer's firmware to the latest version to enable LAN Mode.\n\n#### Bambu Communication Notes (MQTT & FTP)\n\n- **MQTT:** This server uses the local MQTT protocol (port 8883, TLS) based on community findings (e.g., [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI)) to send commands like starting prints and cancelling jobs.\n- **FTP:** File listing and uploading currently rely on the FTP server running on the printer (via the `bambu-js` library helper). **Note:** This FTP connection might be **unsecured (plain FTP)** based on current library limitations. Use with awareness of your network security.\n\n### Prusa Connect\n\nPrusa Connect is Prusa's own cloud-based solution for managing their printers.\n\n- Default port: 80 (http) or 443 (https)\n- Authentication: API key required\n- Compatible with: Prusa MK4, Prusa Mini, Prusa XL, and other Prusa printers with Prusa Connect\n\n#### Setting up Prusa Connect\n\n1. Make sure your Prusa printer is updated to the latest firmware\n2. Connect your printer to your Wi-Fi network\n3. Create a Prusa Connect account and register your printer\n4. Generate an API key from the Prusa Connect web interface under Settings > API Access\n\n### Creality Cloud\n\nCreality Cloud is Creality's management system for their printers.\n\n- Default port: 80 (http) or 443 (https)\n- Authentication: Bearer token required\n- Compatible with: Ender series, CR series, and other Creality printers with network capabilities\n\n#### Setting up Creality Cloud\n\n1. Install the Creality Cloud app on your mobile device\n2. Create an account and add your printer\n3. Enable local network access for your printer\n4. Generate a token from the Creality Cloud app under Settings > Developer Options\n\n## Available Tools\n\n

Click to expand STL Manipulation Tools

\n\n### STL Manipulation Tools\n\n> **Memory Usage Warning**: The following STL manipulation tools load entire 3D models into memory. For large or complex STL files (>10MB), these operations can consume significant memory. When using these tools within the MCP environment, be mindful of memory constraints.\n\n#### get_stl_info\n\nGet detailed information about an STL file, including dimensions, vertex count, and bounding box.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### extend_stl_base\n\nExtend the base of an STL file by a specified amount.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### scale_stl\n\nScale an STL model uniformly or along specific axes.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\nOr for non-uniform scaling:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### rotate_stl\n\nRotate an STL model around specific axes (in degrees).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### translate_stl\n\nMove an STL model along specific axes (in millimeters).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### merge_vertices\n\nMerge vertices that are closer than a specified tolerance. Helps close small gaps and can slightly simplify the mesh.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### center_model\n\nTranslate the model so the center of its bounding box is at the world origin (0,0,0).\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### lay_flat\n\nAttempt to identify the largest flat surface of the model (that isn't already facing directly up or down) and rotate the model so this face is oriented downwards on the XY plane (Z=0). Useful for orienting models for printing.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### modify_stl_section\n\nApply a specific transformation to a selected section of an STL file. This allows for detailed modifications of specific parts of a model.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\nFor custom section bounds:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### generate_stl_visualization\n\nGenerate an SVG visualization of an STL file from multiple angles (front, side, top, and isometric views).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### slice_stl\n\nSlice an STL file to generate G-code.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### confirm_temperatures\n\nConfirm temperature settings in a G-code file.\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### process_and_print_stl\n\nProcess an STL file (extend base), slice it, confirm temperatures, and start printing.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n**Note:** Automatic orientation for optimal printing (minimizing supports, etc.) is a complex task typically handled by slicer GUIs (like OrcaSlicer or PrusaSlicer) and is not implemented in this server.\n\n

\n\n

Click to expand Printer Control Tools

\n\n### Printer Control Tools\n\n#### get_printer_status\n\nGet the current status of the 3D printer.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nFor Bambu printers, this currently only confirms MQTT connection.\n\n#### list_printer_files\n\nList files available on the printer.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nFor Bambu printers, lists files in the `gcodes` directory via FTP.\n\n#### upload_gcode\n\nUpload a G-code file to the printer.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nFor Bambu printers, uploads to the `gcodes` directory via FTP. Cannot start print automatically.\n\n#### start_print\n\nStart printing a file that is already on the printer.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**Not recommended for Bambu printers.** Use `print_3mf` for Bambu `.3mf` files.\n\n#### cancel_print\n\nCancel the current print job.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nFor Bambu printers, sends the `stop_print` command via MQTT.\n\n#### set_printer_temperature\n\nSet the temperature of a printer component.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**Not supported for Bambu printers** via direct MQTT commands.\n\n

\n\n

Click to expand Bambu-Specific Tools

\n\n### Bambu-Specific Tools\n\n#### print_3mf\n\nUploads a `.3mf` file to a Bambu printer via FTP and initiates the print job via an MQTT command. Allows overriding some print parameters like AMS mapping.\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n**Note:** Overriding slicer settings like layer height or temperature via this tool is not supported by the printer's MQTT command. Apply those changes before generating the `.3mf` file.\n\n

\n\n## Available Resources\n\n

Click to expand Printer Resources

\n\n### Printer Resources\n\n- `printer://{host}/status` - Current status of the 3D printer (limited for Bambu currently)\n- `printer://{host}/files` - List of files available on the 3D printer (FTP for Bambu)\n- `printer://{host}/file/{filename}` - Content of a specific G-code file (checks existence only for Bambu)\n\n

\n\n

Click to expand Bambu Preset Resources

\n\n### Bambu Preset Resources\n\nIf the `BAMBU_STUDIO_CONFIG_PATH` environment variable is set to your Bambu Studio user settings directory, you can read your saved presets.\n\n- `preset://bambu/machine/{preset_name}` - Reads a machine preset file (e.g., `Bambu Lab P1S 0.4 nozzle.json`)\n- `preset://bambu/filament/{preset_name}` - Reads a filament preset file (e.g., `Generic PLA.json`)\n- `preset://bambu/process/{preset_name}` - Reads a process preset file (e.g., `0.20mm Standard @BBL P1S.json`)\n\n**Example Usage:**\n\"Read the content of my Bambu process preset named '0.16mm Optimal @BBL P1S'\"\n(Claude would call ReadResource with `preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S`)\n\n

\n\n## Example Commands for Claude\n\nHere are some example commands you can give to Claude after connecting the MCP server:\n\n### Printer Control\n- \"What's the current status of my 3D printer?\"\n- \"Show me the list of files on my printer.\"\n- \"Upload this G-code to my printer: [G-code content]\"\n- \"Start printing the file named 'benchy.gcode'.\"\n- \"Cancel the current print job.\"\n- \"Set the extruder temperature to 200°C.\"\n- \"Set the bed temperature to 60°C.\"\n\n### STL Manipulation and Printing\n- \"Take this STL file and extend the base by 2 inches, then send to slicer and queue up in my printer.\"\n- \"Extend the base of model.stl by 1.5 inches.\"\n- \"Scale this STL file by 150% uniformly.\"\n- \"Scale model.stl to be twice as wide but keep the same height.\"\n- \"Rotate this model 90 degrees around the Z axis.\"\n- \"Move this STL model up by 5mm to create a gap underneath.\"\n- \"Can you modify just the top part of this model to make it 20% larger?\"\n- \"Analyze this STL file and tell me its dimensions and details.\"\n- \"Generate a visualization of this STL file so I can see what it looks like.\"\n- \"Create SVG visualizations of my model from different angles.\"\n- \"Make the base of this model wider without changing its height.\"\n- \"Slice the modified STL file using PrusaSlicer.\"\n- \"Confirm that the temperatures in the G-code are 200°C for the extruder and 60°C for the bed.\"\n- \"Process this STL file, make the base 2 inches longer, slice it, and start printing, but confirm the temperatures first.\"\n- \"Print `~/Downloads/my_model.3mf` on the Bambu printer.\"\n- \"Upload `~/Desktop/calibration_cube.3mf` to the Bambu printer using AMS slots 0 and 2, and turn off bed leveling.\"\n- \"Cancel the print job on my Bambu P1S.\"\n- \"What are the settings in my Bambu filament preset 'Generic PETG'?\"\n- \"Show me my Bambu process presets.\"\n\n## Bambu Lab Printer Limitations\n\nDue to the nature of the Bambu Lab printer API, there are some limitations:\n\n1. **Starting prints**: Starting a print requires the 3MF project file path, gcode file name, print name, and MD5 hash. The simplified API in this server doesn't support this fully yet.\n\n2. **Temperature control**: The Bambu API doesn't provide direct methods to set temperatures. This would require custom G-code commands.\n\n3. **File management**: Files must be uploaded to the \"gcodes\" directory on the printer.\n\n4. **FTP Security:** File operations currently use the printer's FTP server, which may be unsecured (plain FTP).\n\n5. **Parameter Overrides:** Only parameters supported by the MQTT `project_file` command can be overridden via the `print_3mf` tool (e.g., AMS usage, calibration flags). Slicer settings like layer height or temperature cannot be changed at print time via this command.\n\n6. **Status Updates:** Full real-time status monitoring via MQTT needs further implementation.\n\n## Limitations and Considerations\n\n### Memory Usage\n- **Large STL Files**: Processing large or complex STL files can consume significant memory. The entire STL geometry is loaded into memory during operations.\n- **Multiple Operations**: Running multiple STL operations in sequence (especially on large files) may cause memory to accumulate if garbage collection doesn't keep up.\n- **MCP Environment**: Since this runs as an MCP server, be aware that Claude's MCP environment has memory constraints. Complex operations on very large STL files may cause out-of-memory issues.\n\n### STL Manipulation Limitations\n- **Section Modification**: The section-specific modification feature works best on simpler geometries. Complex or non-manifold meshes may produce unexpected results.\n- **Base Extension**: The base extension algorithm works by adding a new geometry underneath the model. For models with complex undersides, results may not be perfect.\n- **Error Handling**: While we've added robust error handling, some edge cases in complex STL files might still cause issues.\n\n### Visualization Limitations\n- **SVG Representation**: The SVG visualization is a simplified schematic representation, not a true 3D render.\n- **Complex Models**: For very complex models, the visualization may not accurately represent all details.\n\n### Performance Considerations\n- **Slicing Operations**: External slicer processes can be CPU-intensive and may take considerable time for complex models.\n- **Progress Reporting**: For large files, progress updates may appear to stall at certain processing stages.\n\n### Testing Recommendations\n- Start with smaller STL files (< 10MB) to test functionality\n- Monitor memory usage when processing large files\n- Test modifications on simple geometries before attempting complex ones\n- Consider running on a system with at least 4GB of available RAM for larger operations\n\n## Badges\n\n| Badge | Description |\n|-------|-------------|\n| [![npm version](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | The current version of the package on npm |\n| [![License: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | This project is licensed under GPL-2.0 |\n| [![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | This project is written in TypeScript 4.9+ |\n| [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | This project is actively maintained |\n| [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | We welcome contributions via Pull Requests |\n| [![Node.js Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Requires Node.js 18.0.0 or higher |\n| [![Downloads](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Number of downloads per month from npm |\n| [![GitHub stars](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | Number of GitHub stars this project has received |\n\n## License\n\nGPL-2.0\n","English","en-US",{"_27":46,"_31":50,"_36":51},{"_29":47,"_31":48,"_33":49},"Permite la interacción con sistemas de gestión de impresoras 3D a través de un servidor MCP, lo que admite la manipulación de archivos STL, el corte y el control de impresoras como OctoPrint, Klipper, Duet y más.","Servidor de impresora 3D MCP","# Servidor de impresora 3D MCP\n\n[![versión npm](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![Licencia: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![Mecanografiado](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![Mantenimiento](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![Bienvenidos los PR](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Versión de Node.js](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![Descargas](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![Estrellas de GitHub](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* **Impresión Bambu `.3mf` :** Se agregó la herramienta `print_3mf` , específica para impresoras Bambu Lab. Esta herramienta carga el archivo `.3mf` y envía el comando de impresión directamente a través de MQTT, según las especificaciones de OpenBambuAPI.\n\n* **Comunicación MQTT directa (Bambu):** se refactorizó el manejo de comandos de Bambu ( `print_3mf` , `cancelJob` ) para usar MQTT directo (puerto TLS 8883) en lugar de confiar únicamente en `bambu-js` para los comandos.\n\n* **Análisis de archivos `.3mf` :** se implementó un analizador ( `src/3mf_parser.ts` ) para leer metadatos y configuraciones de segmentación específicas de Bambu (desde `project_settings.config` ) dentro de archivos `.3mf` .\n\n* **Recursos preestablecidos de Bambu:** se agregó soporte para leer archivos preestablecidos de Bambu Studio ( `machine` , `filament` , `process` ) como recursos MCP (por ejemplo, `preset://bambu/process/MyPreset` ) si `BAMBU_STUDIO_CONFIG_PATH` está configurado.\n\n* **Integración con OrcaSlicer:** se agregó soporte para usar OrcaSlicer a través de su interfaz de línea de comandos para la herramienta `slice_stl` .\n\n* **Nuevas herramientas de manipulación de STL:** se agregaron las herramientas `merge_vertices` , `center_model` y `lay_flat` para la preparación básica del modelo usando `three.js` .\n\n* **Actualización de configuración:** se agregó la variable de entorno `BAMBU_STUDIO_CONFIG_PATH` para la carga de ajustes preestablecidos.\n\n* **Nota sobre el uso de FTP:** En la documentación se reconoce que las operaciones de archivos para Bambu actualmente utilizan FTP potencialmente no seguro a través de `bambu-js` .\n\n* **Lograr la paridad de características:** llevar la funcionalidad (detalles de estado, operaciones de archivos, impresión directa cuando sea posible, manejo de ajustes preestablecidos) para OctoPrint, Klipper, Duet, Repetier, Prusa Connect y Creality Cloud al nivel de robustez planificado para la implementación de Bambu.\n\n* **Implementar el estado MQTT completo de Bambu:** refactorizar `getStatus` para que Bambu se suscriba a los informes MQTT y mantenga el estado en tiempo real.\n\n* **Implementar un mapeo AMS robusto:** reemplazar la lógica de marcador de posición; analizar y usar correctamente el mapeo AMS desde la configuración del segmentador `.3mf` o las anulaciones del usuario para el comando de impresión MQTT.\n\n* **Implementar anulaciones de impresión `.3mf` :** agregar lógica a la herramienta `print_3mf` para manejar anulaciones proporcionadas por el usuario (por ejemplo, indicadores de calibración) y configuraciones de segmentación potencialmente comunes si es posible a través de MQTT/código G.\n\n* **Calcular hash MD5:** agrega lógica para calcular e incluir el hash MD5 del archivo `.3mf` en el comando de impresión MQTT (opcional pero recomendado por el protocolo).\n\n* **Refactorizar las operaciones de archivos de Bambu:** investigar la sustitución de las operaciones FTP `bambu-js` ( `getFiles` , `uploadFile` ) con métodos MQTT directos si es posible/estable, o contribuir con soporte FTPS para `bambu-js` .\n\n* **Agregar lógica de descubrimiento preestablecida:** mejorar la lista de recursos preestablecidos (actualmente, las listas se basan en nombres de archivos potenciales; podrían analizar archivos de índice si existen).\n\n* **Ampliar la compatibilidad con `.3mf` :** agregue compatibilidad de impresión `.3mf` para otros tipos de impresoras cuando corresponda.\n\n* **Manejo y generación de informes de errores:** mejore el manejo de errores de MQTT y los informes sobre el progreso/finalización de la impresión.\n\n* **Pruebas:** Realice pruebas de ejecución exhaustivas de todas las nuevas funciones de Bambu.\n\n## Tabla de contenido\n\n* [Descripción](#description)\n* [Características](#features)\n* [Instalación](#installation)\n\n * [Prerrequisitos](#prerequisites)\n * [Instalar desde npm](#install-from-npm)\n * [Instalar desde la fuente](#install-from-source)\n * [Ejecutando con Docker](#running-with-docker)\n\n * [Uso de segmentaciones de datos con Docker](#using-slicers-with-docker)\n* [Configuración](#configuration)\n* [Uso con Claude Desktop](#usage-with-claude-desktop)\n* [Sistemas de gestión de impresoras compatibles](#supported-printer-management-systems)\n\n * [OctoPrint](#octoprint)\n * [Klipper (vía Moonraker)](#klipper-via-moonraker)\n * [Dueto](#duet)\n * [Repetidor](#repetier)\n * [Laboratorios Bambú](#bambu-labs)\n\n * [Cómo encontrar el número de serie y el token de acceso de su impresora Bambu](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Notas de comunicación de Bambu (MQTT y FTP)](#bambu-communication-notes-mqtt--ftp)\n * [Prusa Connect](#prusa-connect)\n\n * [Configuración de Prusa Connect](#setting-up-prusa-connect)\n * [Nube de Creality](#creality-cloud)\n\n * [Configuración de Creality Cloud](#setting-up-creality-cloud)\n* [Herramientas disponibles](#available-tools)\n\n * [Herramientas de manipulación de STL](#stl-manipulation-tools)\n * [Herramientas de control de impresora](#printer-control-tools)\n * [Herramientas específicas para el bambú](#bambu-specific-tools)\n* [Recursos disponibles](#available-resources)\n\n * [Recursos de la impresora](#printer-resources)\n * [Recursos preestablecidos de Bambú](#bambu-preset-resources)\n* [Comandos de ejemplo para LLM](#example-commands-for-claude)\n* [Limitaciones de la impresora Bambu Lab](#bambu-lab-printer-limitations)\n* [Limitaciones y consideraciones](#limitations-and-considerations)\n\n * [Uso de la memoria](#memory-usage)\n * [Limitaciones de la manipulación de STL](#stl-manipulation-limitations)\n * [Limitaciones de la visualización](#visualization-limitations)\n * [Consideraciones de rendimiento](#performance-considerations)\n * [Recomendaciones de pruebas](#testing-recommendations)\n* [Insignias](#badges)\n* [Licencia](#license)\n\n## Descripción\n\nEste es un servidor que permite a los usuarios de MCP conectarse con los puntos finales de API de estas impresoras 3D:\n\n* OctoPrint\n* Klipper (Moonraker)\n* Dueto\n* Repetidor\n* Laboratorios Bambú\n* Prusa Connect\n* Creality/Ender\n\nEste servidor es un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a Claude con sistemas de gestión de impresoras 3D. Permite a MCP interactuar con impresoras 3D a través de las API de diversos sistemas de gestión de impresoras, como OctoPrint, Klipper (vía Moonraker), Duet, Repetier y Bambu Labs.\n\n**Nota sobre el uso de recursos** : Este servidor MCP incluye funciones avanzadas de manipulación de modelos 3D que pueden consumir mucha memoria al trabajar con archivos STL grandes. Consulte la sección \"Limitaciones y consideraciones\" para obtener información importante sobre el uso de memoria y el rendimiento.\n\n## Características\n\n* Obtener el estado de la impresora (temperaturas, progreso de impresión, etc.)\n* Listar archivos en la impresora\n* Subir archivos de código G a la impresora\n* Iniciar, cancelar y supervisar trabajos de impresión\n* Establecer las temperaturas de la impresora\n* Manipulación avanzada de archivos STL:\n * Extiende la base para una mejor adherencia.\n * Escalar modelos de manera uniforme o a lo largo de ejes específicos\n * Girar modelos alrededor de cualquier eje\n * Traducir (mover) modelos\n * Modificar secciones específicas de archivos STL (superior, inferior, central o personalizada)\n* Análisis STL completo con información detallada del modelo\n* Generar visualizaciones SVG multiángulo de archivos STL\n* Informes de progreso en tiempo real para operaciones largas\n* Manejo de errores con diagnósticos detallados\n* Cortar archivos STL para generar código G\n* Confirmar la configuración de temperatura en los archivos de código G\n* Flujo de trabajo completo de principio a fin, desde la modificación de STL hasta la impresión\n* Imprima archivos `.3mf` directamente en las impresoras Bambu Lab (a través del comando MQTT)\n* Lea los archivos preestablecidos de Bambu Studio (impresora, filamento, proceso) como recursos\n\n## Instalación\n\n### Prerrequisitos\n\n* Node.js 18 o superior\n* npm o hilo\n\n### Instalar desde npm\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### Instalar desde la fuente\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Ejecutando con Docker\n\nTambién puede ejecutar el servidor utilizando Docker y Docker Compose para un entorno en contenedores.\n\n1. Asegúrese de tener instalados Docker y Docker Compose.\n\n2. Copie `.env.example` a `.env` y configure sus ajustes.\n\n3. Construya y ejecute el contenedor:\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### Uso de segmentaciones de datos con Docker\n\nTenga en cuenta que la configuración predeterminada de Docker **no puede usar directamente un slicer instalado en su equipo host** . Montar el ejecutable del slicer directamente desde el host al contenedor no es fiable debido a las diferencias en el sistema operativo y las bibliotecas entre el host y el contenedor.\n\nEl enfoque recomendado es **instalar el segmentador de datos preferido *dentro de* la imagen de Docker** . Esto hace que el contenedor sea autosuficiente.\n\nPara ello, deberá modificar el `Dockerfile` . A continuación, se muestra un ejemplo conceptual de cómo podría agregar PrusaSlicer u OrcaSlicer (los comandos específicos pueden variar según el segmentador, sus dependencias y los paquetes Alpine actuales):\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\nDespués de modificar el `Dockerfile` , reconstruye tu imagen ( `docker-compose build` ). También deberás asegurarte de que la variable de entorno `SLICER_PATH` en tu archivo `.env` o `docker-compose.yml` apunte a la ruta correcta *dentro del contenedor* (p. ej., `/usr/local/bin/orcaslicer` ). Establece también `SLICER_TYPE` en `orcaslicer` .\n\nDisculpen por no incluir un rebanador específico de fábrica, pero dada la amplia variedad de rebanadores (PrusaSlicer, OrcaSlicer, Cura, etc.) y configuraciones disponibles, preinstalar uno sobrecargaría innecesariamente la imagen para muchos usuarios. Si un rebanador en particular se convierte en una solicitud frecuente, sin duda consideraré añadir soporte oficial para él en una versión futura.\n\n## Configuración\n\nCrea un archivo `.env` en el directorio donde ejecutarás el servidor o configurarás variables de entorno:\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Uso con Claude Desktop\n\n1. Edite su archivo de configuración de Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. Para impresoras Bambu Labs:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Reiniciar Claude Desktop\n4. Conéctese a su impresora a través de Claude\n\n## Sistemas de gestión de impresoras compatibles\n\n### OctoPrint\n\nOctoPrint es una interfaz web popular para impresoras 3D. Ofrece una API REST para controlar la impresora.\n\n* Puerto predeterminado: 80 (http) o 443 (https)\n* Autenticación: se requiere clave API\n\n### Klipper (vía Moonraker)\n\nKlipper es un firmware para impresoras 3D que funciona con el servidor API Moonraker.\n\n* Puerto predeterminado: 7125\n* Autenticación: depende de la configuración de Moonraker\n\n### Dueto\n\nDuet es una placa de control para impresoras 3D con su propia interfaz web (DuetWebControl).\n\n* Puerto predeterminado: 80 (http) o 443 (https)\n* Autenticación: depende de la configuración de Duet\n\n### Repetidor\n\nRepetier-Server es un software host para impresoras 3D.\n\n* Puerto predeterminado: 3344\n* Autenticación: se requiere clave API\n\n### Laboratorios Bambú\n\nLas impresoras Bambu Lab utilizan MQTT para el estado y el control y FTP para las operaciones de archivos.\n\n* Autenticación: Se requiere número de serie y token de acceso (establezca `BAMBU_SERIAL` y `BAMBU_TOKEN` )\n* Requisitos: La impresora debe estar en la misma red o tener habilitada la conexión a la nube\n* Compatible con: X1C, P1S, P1P, A1 y otras impresoras Bambu Lab\n\n#### Cómo encontrar el número de serie y el token de acceso de su impresora Bambu\n\nPara conectarse a su impresora Bambu Lab, necesita dos cosas:\n\n1. **Número de serie de la impresora** :\n\n * Busque en la parte posterior o inferior de su impresora una etiqueta con un número de serie (normalmente comienza con \"01P\" o \"01A\" seguido de números/letras)\n * Alternativamente, abra Bambu Studio, conéctese a su impresora, vaya a Dispositivo > Administración de dispositivos y vea la información de su impresora.\n\n2. **Token de acceso** :\n\n * El token de acceso es un código de seguridad necesario para conectarse directamente a su impresora\n * Para impresoras de la serie P1: Vaya a la pantalla táctil, seleccione Configuración > Red > Modo LAN y verá el código de acceso\n * Para impresoras de la serie X1: Vaya a la pantalla táctil, seleccione Configuración > Red > Modo LAN y habilite el Modo LAN para ver el código de acceso\n * Para A1 Mini: use la aplicación Bambu Handy para conectarse a su impresora, luego vaya a Configuración > Red > Modo LAN\n\n**Nota** : Si su impresora no está en la misma red local o no puede encontrar el token de acceso, es posible que deba actualizar el firmware de su impresora a la última versión para habilitar el modo LAN.\n\n#### Notas de comunicación de Bambu (MQTT y FTP)\n\n* **MQTT:** este servidor utiliza el protocolo MQTT local (puerto 8883, TLS) basado en hallazgos de la comunidad (por ejemplo, [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) ) para enviar comandos como iniciar impresiones y cancelar trabajos.\n* **FTP:** La carga y el listado de archivos dependen actualmente del servidor FTP de la impresora (mediante el asistente de la biblioteca `bambu-js` ). **Nota:** Esta conexión FTP podría **no ser segura (FTP simple)** debido a las limitaciones actuales de la biblioteca. Úsela teniendo en cuenta la seguridad de su red.\n\n### Prusa Connect\n\nPrusa Connect es la solución basada en la nube de Prusa para administrar sus impresoras.\n\n* Puerto predeterminado: 80 (http) o 443 (https)\n* Autenticación: se requiere clave API\n* Compatible con: Prusa MK4, Prusa Mini, Prusa XL y otras impresoras Prusa con Prusa Connect\n\n#### Configuración de Prusa Connect\n\n1. Asegúrese de que su impresora Prusa esté actualizada al último firmware\n2. Conecte su impresora a su red Wi-Fi\n3. Cree una cuenta de Prusa Connect y registre su impresora\n4. Genere una clave API desde la interfaz web de Prusa Connect en Configuración > Acceso API\n\n### Nube de Creality\n\nCreality Cloud es el sistema de gestión de Creality para sus impresoras.\n\n* Puerto predeterminado: 80 (http) o 443 (https)\n* Autenticación: Se requiere token de portador\n* Compatible con: serie Ender, serie CR y otras impresoras Creality con capacidades de red\n\n#### Configuración de Creality Cloud\n\n1. Instale la aplicación Creality Cloud en su dispositivo móvil\n2. Crea una cuenta y agrega tu impresora\n3. Habilite el acceso a la red local para su impresora\n4. Genere un token desde la aplicación Creality Cloud en Configuración > Opciones de desarrollador\n\n## Herramientas disponibles\n\n### Herramientas de manipulación de STL\n\n> **Advertencia sobre el uso de memoria** : Las siguientes herramientas de manipulación de STL cargan modelos 3D completos en la memoria. Para archivos STL grandes o complejos (>10 MB), estas operaciones pueden consumir una cantidad considerable de memoria. Al utilizar estas herramientas en el entorno MCP, tenga en cuenta las limitaciones de memoria.\n\n#### obtener\\_información\\_stl\n\nObtenga información detallada sobre un archivo STL, incluidas las dimensiones, el número de vértices y el cuadro delimitador.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### extender\\_base\\_stl\n\nAmplíe la base de un archivo STL por una cantidad específica.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### escala\\_stl\n\nEscalar un modelo STL de manera uniforme o a lo largo de ejes específicos.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\nO para escalamiento no uniforme:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### rotar\\_stl\n\nGirar un modelo STL alrededor de ejes específicos (en grados).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### traducir\\_stl\n\nMover un modelo STL a lo largo de ejes específicos (en milímetros).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### fusionar\\_vértices\n\nFusiona vértices que están más cerca que la tolerancia especificada. Ayuda a cerrar pequeños huecos y puede simplificar ligeramente la malla.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### modelo central\n\nTraslade el modelo de modo que el centro de su cuadro delimitador esté en el origen mundial (0,0,0).\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### posición horizontal\n\nIntente identificar la superficie plana más grande del modelo (que no esté orientada directamente hacia arriba o hacia abajo) y gire el modelo para que esta cara quede orientada hacia abajo en el plano XY (Z=0). Útil para orientar los modelos para la impresión.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### modificar\\_sección\\_stl\n\nAplique una transformación específica a una sección seleccionada de un archivo STL. Esto permite realizar modificaciones detalladas de partes específicas de un modelo.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\nPara límites de sección personalizados:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### generar\\_visualización\\_stl\n\nGenere una visualización SVG de un archivo STL desde múltiples ángulos (vista frontal, lateral, superior e isométrica).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### rebanada\\_stl\n\nCortar un archivo STL para generar código G.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### confirmar\\_temperaturas\n\nConfirmar la configuración de temperatura en un archivo de código G.\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### procesar\\_e\\_imprimir\\_stl\n\nProcese un archivo STL (extienda la base), córtelo, confirme las temperaturas y comience a imprimir.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n**Nota:** La orientación automática para una impresión óptima (minimizando soportes, etc.) es una tarea compleja que normalmente gestionan las GUI de segmentación (como OrcaSlicer o PrusaSlicer) y no está implementada en este servidor.\n\n### Herramientas de control de impresora\n\n#### obtener\\_estado\\_de\\_impresora\n\nObtenga el estado actual de la impresora 3D.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nPara las impresoras Bambu, esto actualmente solo confirma la conexión MQTT.\n\n#### lista\\_de\\_archivos\\_de\\_impresora\n\nLista de archivos disponibles en la impresora.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nPara las impresoras Bambu, enumera los archivos en el directorio `gcodes` a través de FTP.\n\n#### subir\\_gcode\n\nSube un archivo de código G a la impresora.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nPara impresoras Bambu, se sube al directorio de `gcodes` por FTP. No se puede iniciar la impresión automáticamente.\n\n#### inicio\\_impresión\n\nComience a imprimir un archivo que ya está en la impresora.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**No se recomienda para impresoras Bambú.** Use `print_3mf` para archivos Bambú `.3mf` .\n\n#### cancelar\\_impresión\n\nCancelar el trabajo de impresión actual.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nPara las impresoras Bambu, envía el comando `stop_print` a través de MQTT.\n\n#### establecer\\_temperatura\\_de\\_impresora\n\nEstablecer la temperatura de un componente de la impresora.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**No compatible con impresoras Bambu** a través de comandos MQTT directos.\n\n### Herramientas específicas para el bambú\n\n#### impresión\\_3mf\n\nSube un archivo `.3mf` a una impresora Bambu mediante FTP e inicia el trabajo de impresión mediante un comando MQTT. Permite anular algunos parámetros de impresión, como la asignación de AMS.\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n**Nota:** El comando MQTT de la impresora no permite anular la configuración de la segmentación de datos, como la altura o la temperatura de la capa, mediante esta herramienta. Aplique estos cambios antes de generar el archivo `.3mf` .\n\n## Recursos disponibles\n\n### Recursos de la impresora\n\n* `printer://{host}/status` - Estado actual de la impresora 3D (limitado para Bambu actualmente)\n* `printer://{host}/files` - Lista de archivos disponibles en la impresora 3D (FTP para Bambu)\n* `printer://{host}/file/{filename}` - Contenido de un archivo de código G específico (verifica la existencia solo para Bambu)\n\n### Recursos preestablecidos de Bambú\n\nSi la variable de entorno `BAMBU_STUDIO_CONFIG_PATH` está configurada en el directorio de configuración de usuario de Bambu Studio, podrá leer sus ajustes preestablecidos guardados.\n\n* `preset://bambu/machine/{preset_name}` - Lee un archivo de preajuste de máquina (por ejemplo, `Bambu Lab P1S 0.4 nozzle.json` )\n* `preset://bambu/filament/{preset_name}` - Lee un archivo de preajuste de filamento (por ejemplo, `Generic PLA.json` )\n* `preset://bambu/process/{preset_name}` - Lee un archivo de preajuste de proceso (por ejemplo, `0.20mm Standard @BBL P1S.json` )\n\n**Ejemplo de uso:** \"Lea el contenido de mi ajuste preestablecido de proceso Bambu llamado '0.16mm Optimal @BBL P1S'\" (Claude llamaría a ReadResource con `preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S` )\n\n## Comandos de ejemplo para Claude\n\nA continuación se muestran algunos comandos de ejemplo que puedes darle a Claude después de conectarse al servidor MCP:\n\n### Control de impresora\n\n* \"¿Cuál es el estado actual de mi impresora 3D?\"\n* \"Muéstrame la lista de archivos en mi impresora\".\n* \"Sube este código G a mi impresora: \\[Contenido del código G]\"\n* \"Comience a imprimir el archivo llamado 'benchy.gcode'.\"\n* \"Cancelar el trabajo de impresión actual.\"\n* \"Establezca la temperatura del extrusor a 200 °C\".\n* \"Establezca la temperatura de la cama a 60°C.\"\n\n### Manipulación e impresión de STL\n\n* \"Tome este archivo STL y extienda la base 2 pulgadas, luego envíelo a la cortadora y póngalo en cola en mi impresora\".\n* \"Extiende la base del modelo.stl 1,5 pulgadas\".\n* \"Escale este archivo STL al 150% de manera uniforme\".\n* \"Modelo a escala.stl que tendrá el doble de ancho pero mantendrá la misma altura\".\n* \"Gire este modelo 90 grados alrededor del eje Z\".\n* \"Mueva este modelo STL 5 mm hacia arriba para crear un espacio debajo\".\n* \"¿Puedes modificar sólo la parte superior de este modelo para hacerlo un 20% más grande?\"\n* \"Analiza este archivo STL y dime sus dimensiones y detalles\".\n* \"Genera una visualización de este archivo STL para que pueda ver cómo se ve\".\n* \"Crea visualizaciones SVG de mi modelo desde diferentes ángulos\".\n* \"Haz la base de este modelo más ancha sin cambiar su altura.\"\n* \"Corte el archivo STL modificado usando PrusaSlicer\".\n* \"Confirme que las temperaturas en el código G son 200 °C para el extrusor y 60 °C para la cama\".\n* \"Procesa este archivo STL, alarga la base 5 cm, córtala y comienza a imprimir, pero primero confirma las temperaturas\".\n* \"Imprimir `~/Downloads/my_model.3mf` en la impresora Bambu.\"\n* \"Cargue `~/Desktop/calibration_cube.3mf` a la impresora Bambu usando las ranuras AMS 0 y 2 y desactive la nivelación de la cama\".\n* \"Cancelar el trabajo de impresión en mi Bambu P1S\".\n* \"¿Cuáles son las configuraciones preestablecidas de mi filamento de bambú 'PETG genérico'?\"\n* \"Muéstrame mis ajustes preestablecidos del proceso Bambu\".\n\n## Limitaciones de la impresora Bambu Lab\n\nDebido a la naturaleza de la API de impresora Bambu Lab, existen algunas limitaciones:\n\n1. **Iniciar impresiones** : Para iniciar una impresión, se requiere la ruta del archivo de proyecto 3MF, el nombre del archivo gcode, el nombre de la impresión y el hash MD5. La API simplificada de este servidor aún no es totalmente compatible.\n\n2. **Control de temperatura** : La API de Bambu no proporciona métodos directos para configurar la temperatura. Esto requeriría comandos de código G personalizados.\n\n3. **Gestión de archivos** : Los archivos deben cargarse en el directorio \"gcodes\" de la impresora.\n\n4. **Seguridad FTP:** Las operaciones con archivos actualmente utilizan el servidor FTP de la impresora, que puede no ser seguro (FTP simple).\n\n5. **Anulaciones de parámetros:** Solo los parámetros compatibles con el comando MQTT `project_file` pueden anularse mediante la herramienta `print_3mf` (p. ej., uso de AMS, indicadores de calibración). Los ajustes de segmentación, como la altura o la temperatura de la capa, no pueden modificarse durante la impresión mediante este comando.\n\n6. **Actualizaciones de estado:** la monitorización completa del estado en tiempo real a través de MQTT necesita mayor implementación.\n\n## Limitaciones y consideraciones\n\n### Uso de la memoria\n\n* **Archivos STL grandes** : El procesamiento de archivos STL grandes o complejos puede consumir una cantidad considerable de memoria. Toda la geometría STL se carga en memoria durante las operaciones.\n* **Operaciones múltiples** : ejecutar múltiples operaciones STL en secuencia (especialmente en archivos grandes) puede provocar que se acumule memoria si la recolección de basura no se mantiene al día.\n* **Entorno MCP** : Dado que se ejecuta como un servidor MCP, tenga en cuenta que el entorno MCP de Claude tiene limitaciones de memoria. Las operaciones complejas con archivos STL muy grandes pueden causar problemas de memoria insuficiente.\n\n### Limitaciones de la manipulación de STL\n\n* **Modificación de sección** : La función de modificación específica de sección funciona mejor con geometrías más simples. Las mallas complejas o no múltiples pueden producir resultados inesperados.\n* **Extensión de la base** : El algoritmo de extensión de la base funciona añadiendo una nueva geometría debajo del modelo. En modelos con superficies inferiores complejas, los resultados pueden no ser perfectos.\n* **Manejo de errores** : si bien hemos agregado un manejo de errores sólido, algunos casos extremos en archivos STL complejos aún pueden causar problemas.\n\n### Limitaciones de la visualización\n\n* **Representación SVG** : La visualización SVG es una representación esquemática simplificada, no una verdadera representación 3D.\n* **Modelos complejos** : para modelos muy complejos, es posible que la visualización no represente con precisión todos los detalles.\n\n### Consideraciones de rendimiento\n\n* **Operaciones de segmentación** : los procesos de segmentación externos pueden consumir muchos recursos de la CPU y pueden llevar un tiempo considerable para modelos complejos.\n* **Informes de progreso** : en el caso de archivos grandes, es posible que parezca que las actualizaciones de progreso se estancan en ciertas etapas del procesamiento.\n\n### Recomendaciones de pruebas\n\n* Comience con archivos STL más pequeños (<10 MB) para probar la funcionalidad\n* Supervisar el uso de memoria al procesar archivos grandes\n* Pruebe modificaciones en geometrías simples antes de intentar realizar modificaciones complejas.\n* Considere ejecutarlo en un sistema con al menos 4 GB de RAM disponible para operaciones más grandes\n\n## Insignias\n\n| Insignia | Descripción |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |\n| [![versión npm](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | La versión actual del paquete en npm |\n| [![Licencia: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | Este proyecto está licenciado bajo GPL-2.0 |\n| [![Mecanografiado](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | Este proyecto está escrito en TypeScript 4.9+ |\n| [![Mantenimiento](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | Este proyecto se mantiene activo |\n| [![Bienvenidos los PR](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | Aceptamos contribuciones a través de solicitudes de extracción. |\n| [![Versión de Node.js](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Requiere Node.js 18.0.0 o superior |\n| [![Descargas](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Número de descargas por mes desde npm |\n| [![Estrellas de GitHub](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | Número de estrellas de GitHub que ha recibido este proyecto |\n\n## Licencia\n\nGPL-2.0","Spanish","es-ES",{"_27":53,"_31":57,"_36":58},{"_29":54,"_31":55,"_33":56},"MCP サーバーを介して 3D プリンター管理システムとのやり取りを可能にし、STL ファイルの操作、スライス、OctoPrint、Klipper、Duet などのプリンターの制御をサポートします。","MCP 3Dプリンターサーバー","# MCP 3Dプリンターサーバー\n\n[![npmバージョン](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![ライセンス: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![タイプスクリプト](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![メンテナンス](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![PR歓迎](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Node.js バージョン](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![ダウンロード](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![GitHubスター](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* **Bambu `.3mf`印刷：** Bambu Lab プリンター専用の`print_3mf`ツールを追加しました。このツールは`.3mf`ファイルをアップロードし、OpenBambuAPI 仕様に基づいて MQTT 経由で直接印刷コマンドを送信します。\n\n* \\*\\*直接 MQTT 通信 (Bambu):\\*\\*コマンドに`bambu-js`のみに依存するのではなく、直接 MQTT (TLS ポート 8883) を使用するように Bambu コマンド処理 ( `print_3mf` 、 `cancelJob` ) をリファクタリングしました。\n\n* **`.3mf`ファイルの解析:** `.3mf`ファイル内のメタデータと Bambu 固有のスライサー設定 ( `project_settings.config`から) を読み取るためのパーサー ( `src/3mf_parser.ts` ) を実装しました。\n\n* **Bambu プリセットリソース:** `BAMBU_STUDIO_CONFIG_PATH`が設定されている場合、Bambu Studio プリセットファイル ( `machine` 、 `filament` 、 `process` ) を MCP リソース (例: `preset://bambu/process/MyPreset` ) として読み取るためのサポートが追加されました。\n\n* **OrcaSlicer 統合:** `slice_stl`ツールのコマンドラインインターフェイス経由で OrcaSlicer を使用するためのサポートが追加されました。\n\n* **新しい STL 操作ツール:** `three.js`を使用して基本的なモデルを準備するための`merge_vertices` 、 `center_model` 、および`lay_flat`ツールが追加されました。\n\n* \\*\\*設定の更新:\\*\\*プリセットの読み込み用に`BAMBU_STUDIO_CONFIG_PATH`環境変数を追加しました。\n\n* **FTP 使用上の注意:** Bambu のファイル操作では現在`bambu-js`経由の潜在的に安全でない FTP が使用されていることがドキュメントで確認されています。\n\n* **機能の同等性を実現:** OctoPrint、Klipper、Duet、Repetier、Prusa Connect、Creality Cloud の機能 (ステータスの詳細、ファイル操作、可能な場合は直接印刷、プリセットの処理) を、Bambu 実装で計画されている堅牢性のレベルまで引き上げます。\n\n* **完全な Bambu MQTT ステータスを実装する:** Bambu の`getStatus`をリファクタリングして、MQTT レポートをサブスクライブし、リアルタイムの状態を維持します。\n\n* \\*\\*堅牢な AMS マッピングを実装する:\\*\\*プレースホルダーロジックを置き換え、 `.3mf`スライサー構成または MQTT 印刷コマンドのユーザーオーバーライドから AMS マッピングを正しく解析して使用します。\n\n* **`.3mf`印刷オーバーライドを実装する:** `print_3mf`ツールにロジックを追加して、ユーザー指定のオーバーライド (キャリブレーションフラグなど) と、MQTT/G コード経由で実行可能な場合は一般的なスライサー設定を処理します。\n\n* **MD5 ハッシュの計算:** `.3mf`ファイルの MD5 ハッシュを計算して MQTT 印刷コマンドに含めるロジックを追加します (オプションですが、プロトコルでは推奨されています)。\n\n* \\*\\*Bambu ファイル操作のリファクタリング:\\*\\*可能かつ安定している場合は`bambu-js` FTP 操作 ( `getFiles` 、 `uploadFile` ) を直接 MQTT メソッドに置き換えることを検討し、または`bambu-js`に FTPS サポートを提供します。\n\n* \\*\\*プリセット検出ロジックの追加:\\*\\*プリセットリソースのリスト表示を改善します (現在は潜在的なファイル名に基づいてリスト表示され、存在する場合はインデックスファイルを解析できます)。\n\n* \\*\\*`.3mf`サポートの拡張:\\*\\*該当する場合は、他のプリンタタイプに対して`.3mf`印刷サポートを追加します。\n\n* **エラー処理とレポート:** MQTT エラー処理と印刷の進行状況/完了のレポートを強化します。\n\n* \\*\\*テスト:\\*\\*すべての新しい Bambu 機能の徹底的なランタイムテストを実施します。\n\n## 目次\n\n* [説明](#description)\n* [特徴](#features)\n* [インストール](#installation)\n\n * [前提条件](#prerequisites)\n * [npmからインストール](#install-from-npm)\n * [ソースからインストール](#install-from-source)\n * [Dockerで実行する](#running-with-docker)\n\n * [Dockerでスライサーを使用する](#using-slicers-with-docker)\n* [構成](#configuration)\n* [Claude Desktopでの使用](#usage-with-claude-desktop)\n* [サポートされているプリンタ管理システム](#supported-printer-management-systems)\n\n * [オクトプリント](#octoprint)\n * [クリッパー（ムーンレイカー経由）](#klipper-via-moonraker)\n * [デュエット](#duet)\n * [レペティエ](#repetier)\n * [バンブーラボ](#bambu-labs)\n\n * [Bambuプリンターのシリアル番号とアクセストークンを見つける](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Bambu 通信ノート (MQTT および FTP)](#bambu-communication-notes-mqtt--ftp)\n * [プルサコネクト](#prusa-connect)\n\n * [Prusa Connectの設定](#setting-up-prusa-connect)\n * [クリエイティクラウド](#creality-cloud)\n\n * [Creality Cloudの設定](#setting-up-creality-cloud)\n* [利用可能なツール](#available-tools)\n\n * [STL操作ツール](#stl-manipulation-tools)\n * [プリンター制御ツール](#printer-control-tools)\n * [Bambu特有のツール](#bambu-specific-tools)\n* [利用可能なリソース](#available-resources)\n\n * [プリンターリソース](#printer-resources)\n * [Bambuプリセットリソース](#bambu-preset-resources)\n* [LLM のコマンド例](#example-commands-for-claude)\n* [Bambu Labプリンターの制限](#bambu-lab-printer-limitations)\n* [制限事項と考慮事項](#limitations-and-considerations)\n\n * [メモリ使用量](#memory-usage)\n * [STL操作の制限](#stl-manipulation-limitations)\n * [視覚化の制限](#visualization-limitations)\n * [パフォーマンスに関する考慮事項](#performance-considerations)\n * [テストの推奨事項](#testing-recommendations)\n* [バッジ](#badges)\n* [ライセンス](#license)\n\n## 説明\n\nこれは、MCP ユーザーが次の 3D プリンターの API エンドポイントに接続できるようにするサーバーです。\n\n* オクトプリント\n* クリッパー（ムーンレイカー）\n* デュエット\n* レペティエ\n* バンブーラボ\n* プルサコネクト\n* クリエイティビティ/エンダー\n\nこのサーバーは、Claudeと3Dプリンター管理システムを接続するためのModel Context Protocol（MCP）サーバーです。MCPは、OctoPrint、Klipper（Moonraker経由）、Duet、Repetier、Bambu Labsプリンターなど、様々なプリンター管理システムのAPIを介して3Dプリンターと通信できます。\n\n**リソース使用に関する注意**：このMCPサーバーには高度な3Dモデル操作機能が含まれており、大規模なSTLファイルを扱う際にはメモリを大量に消費する可能性があります。メモリ使用量とパフォーマンスに関する重要な情報については、「制限事項と考慮事項」セクションをご覧ください。\n\n## 特徴\n\n* プリンターのステータス（温度、印刷の進行状況など）を取得します\n* プリンタ上のファイルを一覧表示する\n* Gコードファイルをプリンターにアップロードする\n* 印刷ジョブの開始、キャンセル、監視\n* プリンターの温度を設定する\n* 高度な STL ファイル操作:\n * ベースを延長して接着力を高める\n * モデルを均一に、または特定の軸に沿って拡大縮小する\n * 任意の軸を中心にモデルを回転\n * モデルを移動（変換）する\n * STL ファイルの特定のセクション (上部、下部、中央、またはカスタム) ��変更します。\n* 詳細なモデル情報を含む包括的なSTL分析\n* STL ファイルのマルチアングル SVG ビジュアライゼーションを生成する\n* 長時間の操作のリアルタイム進捗レポート\n* 詳細な診断によるエラー処理\n* STLファイルをスライスしてGコードを生成する\n* Gコードファイルで温度設定を確認する\n* STL の修正から印刷までの完全なエンドツーエンドのワークフロー\n* `.3mf`ファイルを Bambu Lab プリンターで直接印刷する (MQTT コマンド経由)\n* Bambu Studio のプリセットファイル（プリンター、フィラメント、プロセス）をリソースとして読み込む\n\n## インストール\n\n### 前提条件\n\n* Node.js 18以上\n* npmまたはyarn\n\n### npmからインストール\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### ソースからインストール\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Dockerで実行する\n\nコンテナ化された環境向けに Docker と Docker Compose を使用してサーバーを実行することもできます。\n\n1. Docker と Docker Compose がインストールされていることを確認してください。\n\n2. `.env.example`を`.env`にコピーして設定を構成します。\n\n3. コンテナをビルドして実行します。\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### Dockerでスライサーを使用する\n\nデフォルトのDockerセットアップでは\\*\\*、ホストマシンにインストールされたスライサーを直接使用できない\\*\\*ことにご注意ください。ホストマシンからコンテナにスライサー実行ファイルを直接マウントすることは、ホストとコンテナのオペレーティングシステムやライブラリの違いにより、信頼性が低くなります。\n\n推奨される方法は\\*\\*、Dockerイメージ*内に* 好みのスライサーをインストールする\\*\\*ことです。これにより、コンテナは自己完結的になります。\n\nこれを行うには、 `Dockerfile`変更する必要があります。以下は、PrusaSlicer または OrcaSlicer を追加する方法の概念的な例です（具体的なコマンドは、スライサー、その依存関係、および現在の Alpine パッケージによって異なる場合があります）。\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\n`Dockerfile`を修正したら、イメージを再構築します（ `docker-compose build` ）。また、 `.env`ファイルまたは`docker-compose.yml`内の`SLICER_PATH`環境変数が*コンテナ内の*正しいパス（例： `/usr/local/bin/orcaslicer` ）を指していること`SLICER_TYPE`確認してください。SLICER\\_TYPE も`orcaslicer`に設定してください。\n\n特定のスライサーを標準搭載していないことをお詫び申し上げます。PrusaSlicer、OrcaSlicer、Curaなど、スライサーの種類や設定が多岐にわたるため、特定のスライサーをプリインストールすると、多くのユーザーにとって画像が不必要に肥大化してしまう可能性があります。特定のスライサーのご要望が非常に多くなれば、将来のバージョンで公式サポートを追加することを検討いたします。\n\n## 構成\n\nサーバーを実行するディレクトリまたは環境変数を設定するディレクトリに`.env`ファイルを作成します。\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Claude Desktopでの使用\n\n1. Claude Desktop 構成ファイルを編集します。\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. Bambu Labs プリンターの場合:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Claudeデスクトップを再起動します\n4. Claude経由でプリンターに接続する\n\n## サポートされているプリンタ管理システム\n\n### オクトプリント\n\nOctoPrintは、3Dプリンター用の人気のWebインターフェースです。プリンターを制御するためのREST APIを提供します。\n\n* デフォルトのポート: 80 (http) または 443 (https)\n* 認証: APIキーが必要です\n\n### クリッパー（ムーンレイカー経由）\n\nKlipper は、Moonraker API サーバーで動作する 3D プリンターのファームウェアです。\n\n* デフォルトポート: 7125\n* 認証: Moonrakerの設定によって異なります\n\n### デュエット\n\nDuet は、独自の Web インターフェイス (DuetWebControl) を備えた 3D プリンター用の制御ボードです。\n\n* デフォルトのポート: 80 (http) または 443 (https)\n* 認証: Duet の設定によって異なります\n\n### レペティエ\n\nRepetier-Server は 3D プリンター用のホストソフトウェアです。\n\n* デフォルトポート: 3344\n* 認証: APIキーが必要です\n\n### バンブーラボ\n\nBambu Lab プリンターは、ステータスと制御に MQTT を使用し、ファイル操作に FTP を使用します。\n\n* 認証: シリアル番号とアクセストークンが必要です ( `BAMBU_SERIAL`と`BAMBU_TOKEN`を設定してください)\n* 要件: プリンターは同じネットワーク上にあるか、クラウド接続が有効になっている必要があります\n* 互換性: X1C、P1S、P1P、A1、その他のBambu Labプリンター\n\n#### Bambuプリンターのシリアル番号とアクセストークンを見つける\n\nBambu Lab プリンターに接続するには、次の 2 つが必要です。\n\n1. **プリンタのシリアル番号**:\n\n * プリンターの背面または底面にシリアル番号が記載されたステッカーが貼ってあるか確認してください（通常は「01P」または「01A」で始まり、その後に数字や文字が続きます）。\n * または、Bambu Studioを開いてプリンターに接続し、デバイス > デバイス管理に移動してプリンターの情報を表示します。\n\n2. **アクセストークン**:\n\n * アクセストークンは、プリンターに直接接続するために必要なセキュリティコードです。\n * P1シリーズプリンタの場合: タッチスクリーンで設定 > ネットワーク > LANモードを選択すると、アクセスコードが表示されます。\n * X1シリーズプリンタの場合：タッチスクリーンで設定 > ネットワーク > LANモードを選択し、LANモードを有効にするとアクセスコードが表示されます。\n * A1 Miniの場合: Bambu Handyアプリを使用してプリンターに接続し、\\[設定] > \\[ネットワーク] > \\[LANモード]に移動します。\n\n**注**: プリンターが同じローカルネットワーク上にない場合、またはアクセストークンが見つからない場合は、LAN モードを有効にするためにプリンターのファームウェアを最新バージョンに更新する必要がある場合があります。\n\n#### Bambu 通信ノート (MQTT および FTP)\n\n* \\*\\*MQTT:\\*\\*このサーバーは、コミュニティの調査結果 (例: [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) ) に基づいてローカル MQTT プロトコル (ポート 8883、TLS) を使用して、印刷の開始やジョブのキャンセルなどのコマンドを送信します。\n* \\*\\*FTP：\\*\\*ファイルのリスト表示とアップロードは現在、プリンター上で動作しているFTPサーバー（ `bambu-js`ライブラリヘルパー経由）に依存しています。\\*\\*注：\\*\\*このFTP接続は、現在のライブラリの制限により、\\*\\*セキュリティ保護されていない（プレーンFTP）\\*\\*可能性があります。ネットワークセキュリティに十分ご留意の上、ご利用ください。\n\n### プルサコネクト\n\nPrusa Connect は、Prusa 独自のプリンター管理用クラウドベースソリューションです。\n\n* デフォルトのポート: 80 (http) または 443 (https)\n* 認証: APIキーが必要です\n* 互換性: Prusa MK4、Prusa Mini、Prusa XL、およびPrusa Connectを搭載したその他のPrusaプリンター\n\n#### Prusa Connectの設定\n\n1. Prusaプリンターが最新のファームウェアに更新されていることを確認してください\n2. プリンターをWi-Fiネットワークに接続する\n3. Prusa Connectアカウントを作成し、プリンターを登録します\n4. Prusa Connectウェブインターフェースの「設定」>「APIアクセス」からAPIキーを生成します。\n\n### クリエイティクラウド\n\nCreality Cloud は、Creality のプリンター管理システムです。\n\n* デフォルトのポート: 80 (http) または 443 (https)\n* 認証: ベアラートークンが必要\n* 互換性: Ender シリーズ、CR シリーズ、およびネットワーク機能を備えたその他の Creality プリンター\n\n#### Creality Cloudの設定\n\n1. モバイルデバイスにCreality Cloudアプリをインストールします\n2. アカウントを作成してプリンターを追加する\n3. プリンタのローカルネットワークアクセスを有効にする\n4. Creality Cloudアプリの「設定」>「開発者向けオプション」からトークンを生成します。\n\n## 利用可能なツール\n\n### STL操作ツール\n\n> **メモリ使用量に関する警告**：以下のSTL操作ツールは、3Dモデル全体をメモリに読み込みます。10MBを超える大規模または複雑なSTLファイルの場合、これらの操作は大量のメモリを消費する可能性があります。MCP環境でこれらのツールを使用する場合は、メモリ制限にご注意ください。\n\n#### get\\_stl\\_info\n\n寸法、頂点数、境界ボックスなど、STL ファイルに関する詳細情報を取得します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### 拡張stlベース\n\nSTL ファイルのベースを指定された量だけ拡張します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### スケール\\_stl\n\nSTL モデルを均一に、または特定の軸に沿って拡大縮小します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\nまたは、非均一なスケーリングの場合:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### 回転\\_stl\n\nSTL モデルを特定の軸 (度単位) を中心に回転します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### 翻訳stl\n\nSTL モデルを特定の軸 (ミリメートル単位) に沿って移動します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### 頂点のマージ\n\n指定した許容値よりも近い頂点を結合します。小さな隙間を埋め、メッシュを若干簡素化するのに役立ちます。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### センターモデル\n\nモデルを移動して、境界ボックスの中心がワールド原点 (0,0,0) になるようにします。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### 平らに置く\n\nモデルの中で最も大きな平面（既に上または下を向いていない面）を特定し、その面がXY平面（Z=0）上で下向きになるようにモデルを回転させます。これは、印刷時にモデルの向きを決めるのに役立ちます。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### stlセクションの変更\n\nSTLファイルの選択したセクションに特定の変換を適用します。これにより、モデルの特定の部分を詳細に変更することができます。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\nカスタムセクション境界の場合:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### stl視覚化を生成する\n\n複数の角度 (正面、側面、上面、等角図) から STL ファイルの SVG 視覚化を生成します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### スライスstl\n\nSTL ファイルをスライスして G コードを生成します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### 確認温度\n\nG コードファイルで温度設定を確認します。\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### プロセスと印刷のstl\n\nSTL ファイル (ベースを拡張) を処理し、スライスし、温度を確認して、印刷を開始します。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n\\*\\*注意:\\*\\*最適な印刷のための自動方向付け (サポートの最小化など) は、通常、スライサー GUI (OrcaSlicer や PrusaSlicer など) によって処理される複雑なタスクであり、このサーバーでは実装されていません。\n\n### プリンター制御ツール\n\n#### get\\_printer\\_status\n\n3D プリンターの現在のステータスを取得します。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu プリンターの場合、これは現時点では MQTT 接続のみを確認します。\n\n#### プリンタファイルのリスト\n\nプリンタで使用可能なファイルを一覧表示します。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu プリンタの場合、FTP 経由で`gcodes`ディレクトリ内のファイルを一覧表示します。\n\n#### アップロード\\_gコード\n\nG コードファイルをプリンターにアップロードします。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nBambuプリンタの場合、FTP経由で`gcodes`ディレクトリにアップロードします。自動的に印刷を開始することはできません。\n\n#### 印刷開始\n\nすでにプリンタにあるファイルの印刷を開始します。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**Bambu プリンターには推奨されません。Bambu** `.3mf`ファイルには`print_3mf`使用してください。\n\n#### キャンセル印刷\n\n現在の印刷ジョブをキャンセルします。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu プリンターの場合、MQTT 経由で`stop_print`コマンドを送信します。\n\n#### プリンターの温度を設定する\n\nプリンタコンポーネントの温度を設定します。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n直接 MQTT コマンド経由の**Bambu プリンターではサポートされません**。\n\n### Bambu特有のツール\n\n#### 印刷\\_3mf\n\nFTP経由で`.3mf`ファイルをBambuプリンターにアップロードし、MQTTコマンドで印刷ジョブを開始します。AMSマッピングなどの一部の印刷パラメータをオーバーライドできます。\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n\\*\\*注：\\*\\*このツールによるレイヤーの高さや温度などのスライサー設定の上書きは、プリンターのMQTTコマンドではサポートされていません。.3mfファイル`.3mf`生成する前に、これらの変更を適用してください。\n\n## 利用可能なリソース\n\n### プリンターリソース\n\n* `printer://{host}/status` - 3Dプリンターの現在のステータス（現在はBambuに限定）\n* `printer://{host}/files` - 3D プリンターで利用可能なファイルのリスト (Bambu の FTP)\n* `printer://{host}/file/{filename}` - 特定のGコードファイルの内容（Bambuの場合のみ存在をチェック）\n\n### Bambuプリセットリソース\n\n`BAMBU_STUDIO_CONFIG_PATH`環境変数が Bambu Studio ユーザー設定ディレクトリに設定されている場合、保存したプリセットを読み取ることができます。\n\n* `preset://bambu/machine/{preset_name}` - マシンプリセットファイルを読み取ります（例： `Bambu Lab P1S 0.4 nozzle.json` ）\n* `preset://bambu/filament/{preset_name}` - フィラメントプリセットファイル（例： `Generic PLA.json` ）を読み取ります。\n* `preset://bambu/process/{preset_name}` - プロセスプリセットファイルを読み取ります（例： `0.20mm Standard @BBL P1S.json` ）\n\n**使用例:** 「'0.16mm Optimal @BBL P1S' という名前の Bambu プロセスプリセットの内容を読み取ります」(Claude は`preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S`で ReadResource を呼び出します)\n\n## クロードのコマンド例\n\nMCP サーバーに接続した後、Claude に発行できるコマンドの例を次に示します。\n\n### プリンター制御\n\n* 「私の 3D プリンターの現在の状態はどうですか？」\n* 「プリンタ上のファイルのリストを表示してください。」\n* 「このGコードをプリンターにアップロード: \\[Gコードの内容]」\n* 「「benchy.gcode」という名前のファイルの印刷を開始します。」\n* 「現在の印刷ジョブをキャンセルします。」\n* 「押し出し機の温度を200℃に設定してください。」\n* 「ベッド温度を60℃に設定してください。」\n\n### STL操作と印刷\n\n* 「この STL ファイルを取得してベースを 2 インチ拡張し、スライサーに送信してプリンターのキューに入れます。」\n* 「model.stl のベースを 1.5 インチ拡張します。」\n* 「この STL ファイルを均一に 150% 拡大します。」\n* 「model.stl を幅 2 倍に拡大しますが、高さは同じままにします。」\n* 「このモデルを Z 軸を中心に 90 度回転させます。」\n* 「この STL モデルを 5 mm 上に移動し、下に隙間を作ります。」\n* 「このモデルの上部だけを変更して、20％大きくすることはできますか？」\n* 「この STL ファイルを分析して、寸法と詳細を教えてください。」\n* 「この STL ファイルの視覚化を生成して、どのように見えるか確認します。」\n* 「さまざまな角度からモデルの SVG 視覚化を作成します。」\n* 「このモデルの高さを変えずにベースを広くします。」\n* 「PrusaSlicer を使用して、変更した STL ファイルをスライスします。」\n* 「G コード内の温度が、押出機の場合は 200°C、ベッドの場合は 60°C であることを確認します。」\n* 「この STL ファイルを処理し、ベースを 2 インチ長くしてスライスし、印刷を開始しますが、最初に温度を確認してください。」\n* 「Bambu プリンターで`~/Downloads/my_model.3mf`を印刷します。」\n* 「AMS スロット 0 と 2 を使用して、 `~/Desktop/calibration_cube.3mf`を Bambu プリンターにアップロードし、ベッドレベリングをオフにします。」\n* 「Bambu P1S の印刷ジョブをキャンセルします。」\n* 「Bambu フィラメントプリセット「Generic PETG」の設定は何ですか？」\n* 「Bambu プロセスのプリセットを表示してください。」\n\n## Bambu Labプリンターの制限\n\nBambu Lab プリンター API の性質上、いくつかの制限があります。\n\n1. **プリントの開始**：プリントを開始するには、3MFプロジェクトファイルのパス、Gコードファイル名、プリント名、MD5ハッシュが必要です。このサーバーの簡易APIでは、まだこれらを完全にはサポートしていません。\n\n2. **温度制御**：Bambu APIは温度を直接設定するメソッドを提供していません。そのため、カスタムGコードコマンドが必要になります。\n\n3. **ファイル管理**: ファイルはプリンタの「gcodes」ディレクトリにアップロードする必要があります。\n\n4. \\*\\*FTP セキュリティ:\\*\\*ファイル操作では現在、プリンタの FTP サーバーが使用されていますが、このサーバーはセキュリティ保護されていない可能性があります (プレーン FTP)。\n\n5. **パラメータのオーバーライド：** MQTT `project_file`コマンドでサポートされているパラメータ（例：AMSの使用状況、キャリブレーションフラグ）のみが`print_3mf`ツールでオーバーライドできます。レイヤーの高さや温度などのスライサー設定は、このコマンドでは印刷時に変更できません。\n\n6. **ステータス更新:** MQTT による完全なリアルタイムステータス監視には、さらなる実装が必要です。\n\n## 制限事項と考慮事項\n\n### メモリ使用量\n\n* **大きなSTLファイル**：大規模または複雑なSTLファイルの処理は、大量のメモリを消費する可能性があります。処理中は、STLジオメトリ全体がメモリに読み込まれます。\n* **複数の操作**: 複数の STL 操作を連続して実行すると (特に大きなファイルの場合)、ガベージコレクションが追いつかず、メモリが蓄積される可能性があります。\n* **MCP環境**：これはMCPサーバーとして実行されるため、ClaudeのMCP環境にはメモリ制約があることに注意してください。非常に大きなSTLファイルに対する複雑な操作は、メモリ不足の問題を引き起こす可能性があります。\n\n### STL操作の制限\n\n* **断面変更**：断面固有の変更機能は、より単純なジオメトリで最も効果的に機能します。複雑なメッシュや非多様体メッシュでは、予期しない結果が生じる可能性があります。\n* **ベース拡張**：ベース拡張アルゴリズムは、モデルの下部に新しいジオメトリを追加することで機能します。複雑な下面を持つモデルの場合、結果が完璧ではない場合があります。\n* **エラー処理**: 堅牢なエラー処理を追加しましたが、複雑な STL ファイルの一部のエッジケースでは依然として問題が発生する可能性があります。\n\n### 視覚化の制限\n\n* **SVG 表現**: SVG 視覚化は、簡略化された概略表現であり、真の 3D レンダリングではありません。\n* **複雑なモデル**: 非常に複雑なモデルの場合、視覚化ですべての詳細が正確に表現されないことがあります。\n\n### パフォーマンスに関する考慮事項\n\n* **スライス操作**: 外部スライサープロセスは CPU を大量に消費するため、複雑なモデルの場合はかなりの時間がかかることがあります。\n* **進行状況レポート**: 大きなファイルの場合、進行状況の更新が特定の処理段階で停止しているように見えることがあります。\n\n### テストの推奨事項\n\n* 機能性をテストするには、小さい STL ファイル (< 10 MB) から始めます。\n* 大きなファイルを処理する際のメモリ使用量を監視する\n* 複雑な形状に挑戦する前に、単純な形状で変更をテストする\n* 大規模な操作の場合は、少なくとも 4GB の RAM を搭載したシステムで実行することを検討してください。\n\n## バッジ\n\n| バッジ | 説明 |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |\n| [![npmバージョン](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npm上のパッケージの現在のバージョン |\n| [![ライセンス: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | このプロジェクトはGPL-2.0ライセンスです |\n| [![タイプスクリプト](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | このプロジェクトはTypeScript 4.9以上で書かれています |\n| [![メンテナンス](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | このプロジェクトは活発に維持されています |\n| [![PR歓迎](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | プルリクエストによる貢献を歓迎します |\n| [![Node.js バージョン](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Node.js 18.0.0以上が必要です |\n| [![ダウンロード](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npmからの月間ダウンロード数 |\n| [![GitHubスター](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | このプロジェクトが獲得したGitHubスターの数 |\n\n## ライセンス\n\nGPL-2.0","Japanese","ja-JP",{"_27":60,"_31":64,"_36":65},{"_29":61,"_31":62,"_33":63},"MCP 서버를 통해 3D 프린터 관리 시스템과 상호 작용하여 STL 파일 조작, 슬라이싱, OctoPrint, Klipper, Duet 등의 프린터 제어를 지원합니다.","MCP 3D 프린터 서버","# MCP 3D 프린터 서버\n\n[![npm 버전](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![라이센스: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![타입스크립트](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![유지](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![홍보 담당자 환영](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Node.js 버전](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![다운로드](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![GitHub 별점](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* **Bambu `.3mf` 인쇄:** Bambu Lab 프린터 전용 `print_3mf` 도구를 추가했습니다. 이 도구는 `.3mf` 파일을 업로드하고 OpenBambuAPI 사양에 따라 MQTT를 통해 인쇄 명령을 직접 전송합니다.\n\n* **직접 MQTT 통신(Bambu):** 명령에 대해 `bambu-js` 에만 의존하는 대신 직접 MQTT(TLS 포트 8883)를 사용하도록 Bambu 명령 처리( `print_3mf` , `cancelJob` )를 리팩토링했습니다.\n\n* **`.3mf` 파일 구문 분석:** `.3mf` 파일 내에서 메타데이터와 Bambu 특정 슬라이서 설정( `project_settings.config` 에서)을 읽는 파서( `src/3mf_parser.ts` )를 구현했습니다.\n\n* **Bambu 사전 설정 리소스:** `BAMBU_STUDIO_CONFIG_PATH` 가 설정된 경우 Bambu Studio 사전 설정 파일( `machine` , `filament` , `process` )을 MCP 리소스(예: `preset://bambu/process/MyPreset` )로 읽을 수 있는 지원이 추가되었습니다.\n\n* **OrcaSlicer 통합:** `slice_stl` 도구에 대한 명령줄 인터페이스를 통해 OrcaSlicer를 사용할 수 있도록 지원이 추가되었습니다.\n\n* **새로운 STL 조작 도구:** `three.js` 사용하여 기본 모델을 준비할 수 있는 `merge_vertices` , `center_model` , `lay_flat` 도구가 추가되었습니다.\n\n* **구성 업데이트:** 사전 설정 로딩을 위한 `BAMBU_STUDIO_CONFIG_PATH` 환경 변수가 추가되었습니다.\n\n* **FTP 사용 참고 사항:** Bambu의 파일 작업은 현재 `bambu-js` 를 통해 보안되지 않은 FTP를 사용한다는 사실이 문서에 명시되어 있습니다.\n\n* **기능 동등성 달성:** OctoPrint, Klipper, Duet, Repetier, Prusa Connect, Creality Cloud의 기능(상태 세부 정보, 파일 작업, 가능한 경우 직접 인쇄, 사전 설정 처리)을 Bambu 구현을 위해 계획된 견고성 수준까지 끌어올립니다.\n\n* **Bambu MQTT 상태 전체 구현:** Bambu가 MQTT 보고서를 구독하고 실시간 상태를 유지할 수 있도록 `getStatus` 리팩토링합니다.\n\n* **강력한 AMS 매핑을 구현합니다.** 플레이스홀더 논리를 교체하고 `.3mf` 슬라이서 구성이나 MQTT 인쇄 명령에 대한 사용자 재정의에서 AMS 매핑을 올바르게 구문 분석하여 사용합니다.\n\n* **`.3mf` 인쇄 재정의 구현:** MQTT/G 코드를 통해 가능한 경우 사용자가 제공한 재정의(예: 보정 플래그) 및 일반적인 슬라이서 설정을 처리하기 위해 `print_3mf` 도구에 로직을 추가합니다.\n\n* **MD5 해시 계산:** MQTT 인쇄 명령에 `.3mf` 파일의 MD5 해시를 계산하고 포함하는 논리를 추가합니다(선택 사항이지만 프로토콜에서는 권장).\n\n* **Bambu 파일 작업 리팩토링:** 가능하거나 안정적이라면 `bambu-js` FTP 작업( `getFiles` , `uploadFile` )을 직접 MQTT 메서드로 바꾸는 것을 조사하거나, `bambu-js` 에 FTPS 지원을 기여합니다.\n\n* **사전 설정 검색 논리 추가:** 사전 설정 리소스 목록을 개선합니다(현재는 잠재적인 파일 이름을 기반으로 나열하지만, 인덱스 파일이 있으면 구문 분석할 수 있음).\n\n* **`.3mf` 지원 확장:** 해당되는 경우 다른 프린터 유형에 대한 `.3mf` 인쇄 지원을 추가합니다.\n\n* **오류 처리 및 보고:** MQTT 오류 처리 및 인쇄 진행률/완료 보고를 개선합니다.\n\n* **테스트:** 모든 새로운 Bambu 기능에 대해 철저한 런타임 테스트를 수행합니다.\n\n## 목차\n\n* [설명](#description)\n* [특징](#features)\n* [설치](#installation)\n\n * [필수 조건](#prerequisites)\n * [npm에서 설치](#install-from-npm)\n * [소스에서 설치](#install-from-source)\n * [Docker로 실행](#running-with-docker)\n\n * [Docker와 함께 슬라이서 사용](#using-slicers-with-docker)\n* [구성](#configuration)\n* [Claude Desktop과 함께 사용](#usage-with-claude-desktop)\n* [지원되는 프린터 관리 시스템](#supported-printer-management-systems)\n\n * [옥토프린트](#octoprint)\n * [클리퍼(Moonraker를 통해)](#klipper-via-moonraker)\n * [이중주](#duet)\n * [레피티에](#repetier)\n * [뱀부 랩스](#bambu-labs)\n\n * [Bambu 프린터의 일련 번호 및 액세스 토큰 찾기](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Bambu 커뮤니케이션 노트(MQTT 및 FTP)](#bambu-communication-notes-mqtt--ftp)\n * [프루사 커넥트](#prusa-connect)\n\n * [Prusa Connect 설정](#setting-up-prusa-connect)\n * [크리얼리티 클라우드](#creality-cloud)\n\n * [Creality Cloud 설정](#setting-up-creality-cloud)\n* [사용 가능한 도구](#available-tools)\n\n * [STL 조작 도구](#stl-manipulation-tools)\n * [프린터 제어 도구](#printer-control-tools)\n * [대나무 관련 도구](#bambu-specific-tools)\n* [사용 가능한 리소스](#available-resources)\n\n * [프린터 리소스](#printer-resources)\n * [Bambu 프리셋 리소스](#bambu-preset-resources)\n* [LLM에 대한 예제 명령](#example-commands-for-claude)\n* [Bambu Lab 프린터 제한 사항](#bambu-lab-printer-limitations)\n* [제한 사항 및 고려 사항](#limitations-and-considerations)\n\n * [메모리 사용량](#memory-usage)\n * [STL 조작 제한](#stl-manipulation-limitations)\n * [시각화 제한 사항](#visualization-limitations)\n * [성능 고려 사항](#performance-considerations)\n * [테스트 권장 사항](#testing-recommendations)\n* [배지](#badges)\n* [특허](#license)\n\n## 설명\n\n이는 MCP 사용자가 다음 3D 프린터의 API 엔드포인트에 연결할 수 있도록 해주는 서버입니다.\n\n* 옥토프린트\n* 클리퍼(문레이커)\n* 이중주\n* 레피티에\n* 뱀부 랩스\n* 프루사 커넥트\n* 크리리얼리티/엔더\n\n이 서버는 Claude와 3D 프린터 관리 시스템을 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. MCP는 OctoPrint, Klipper(Moonraker를 통해 제공), Duet, Repetier, Bambu Labs 프린터 등 다양한 프린터 관리 시스템의 API를 통해 3D 프린터와 상호 작용할 수 있습니다.\n\n**리소스 사용 관련 참고 사항** : 이 MCP 서버에는 대용량 STL 파일 작업 시 메모리 사용량이 증가할 수 있는 고급 3D 모델 조작 기능이 포함되어 있습니다. 메모리 사용 및 성능에 대한 중요 정보는 \"제한 사항 및 고려 사항\" 섹션을 참조하십시오.\n\n## 특징\n\n* 프린터 상태(온도, 인쇄 진행률 등)를 가져옵니다.\n* 프린터에 있는 파일 나열\n* G-코드 파일을 프린터에 업로드\n* 인쇄 작업 시작, 취소 및 모니터링\n* 프린터 온도 설정\n* 고급 STL 파일 조작:\n * 더 나은 접착력을 위해 베이스를 확장하세요\n * 모델을 균일하게 또는 특정 축을 따라 확장\n * 모든 축을 중심으로 모델 회전\n * 모델 번역(이동)\n * STL 파일의 특정 섹션(상단, 하단, 중앙 또는 사용자 정의)을 수정합니다.\n* 자세한 모델 정보를 포함한 포괄적인 STL 분석\n* STL 파일의 다중 각도 SVG 시각화 생성\n* 장기 작업에 대한 실시간 진행 상황 보고\n* 자세한 진단을 통한 오류 처리\n* STL 파일을 슬라이스하여 G 코드 생성\n* G-코드 파일에서 온도 설정 확인\n* STL 수정부터 인쇄까지 완벽한 엔드투엔드 워크플로\n* Bambu Lab 프린터에서 `.3mf` 파일을 직접 인쇄합니다(MQTT 명령을 통해)\n* Bambu Studio 사전 설정 파일(프린터, 필라멘트, 프로세스)을 리소스로 읽습니다.\n\n## 설치\n\n### 필수 조건\n\n* Node.js 18 이상\n* npm 또는 yarn\n\n### npm에서 설치\n\n지엑스피1\n\n### 소스에서 설치\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Docker로 실행\n\n컨테이너화된 환경에서는 Docker와 Docker Compose를 사용하여 서버를 실행할 수도 있습니다.\n\n1. Docker와 Docker Compose가 설치되어 있는지 확인하세요.\n\n2. `.env.example``.env` 로 복사하고 설정을 구성합니다.\n\n3. 컨테이너를 빌드하고 실행합니다.\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### Docker와 함께 슬라이서 사용\n\n기본 Docker 설정에서는 **호스트 머신에 설치된 슬라이서를 직접 사용할 수 없습니다** . 호스트와 컨테이너 간의 운영 체제 및 라이브러리 차이로 인해 슬라이서 실행 파일을 호스트에서 컨테이너로 직접 마운트하는 것은 신뢰할 수 없습니다.\n\n권장되는 방법은 **Docker 이미지 *내에* 원하는 슬라이서를 설치하는** 것입니다. 이렇게 하면 컨테이너가 자립적으로 동작합니다.\n\n이렇게 하려면 `Dockerfile` 수정해야 합니다. 다음은 PrusaSlicer 또는 OrcaSlicer를 추가하는 방법의 개념적인 예입니다(특정 명령은 슬라이서, 종속성 및 현재 Alpine 패키지에 따라 다를 수 있음).\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\n`Dockerfile` 수정한 후 이미지를 다시 빌드합니다( `docker-compose build` ). 또한 `.env` 파일이나 `docker-compose.yml` 파일의 `SLICER_PATH` 환경 변수가 *컨테이너 내부의* 올바른 경로(예: `/usr/local/bin/orcaslicer` )를 가리키는지 확인해야 합니다. `SLICER_TYPE` 도 `orcaslicer` 로 설정합니다.\n\n특정 슬라이서를 기본으로 포함하지 못해 죄송합니다. 하지만 다양한 슬라이서(PrusaSlicer, OrcaSlicer, Cura 등)와 사용 가능한 구성을 고려했을 때, 하나를 미리 설치하면 많은 사용자에게 불필요하게 이미지가 커질 수 있습니다. 특정 슬라이서에 대한 요청이 매우 많아진다면, 향후 버전에서 공식 지원을 추가하는 방안을 검토해 보겠습니다.\n\n## 구성\n\n서버를 실행하거나 환경 변수를 설정할 디렉토리에 `.env` 파일을 만듭니다.\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Claude Desktop과 함께 사용\n\n1. Claude Desktop 구성 파일을 편집하세요.\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. Bambu Labs 프린터의 경우:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Claude Desktop을 다시 시작하세요\n4. Claude를 통해 프린터에 연결하세요\n\n## 지원되는 프린터 관리 시스템\n\n### 옥토프린트\n\nOctoPrint는 3D 프린터용 인기 웹 인터페이스입니다. 프린터 제어를 위한 REST API를 제공합니다.\n\n* 기본 포트: 80(http) 또는 443(https)\n* 인증: API 키가 필요합니다\n\n### 클리퍼(Moonraker를 통해)\n\nKlipper는 Moonraker API 서버와 함께 작동하는 3D 프린터용 펌웨어입니다.\n\n* 기본 포트: 7125\n* 인증: Moonraker 구성에 따라 다릅니다.\n\n### 이중주\n\nDuet은 자체 웹 인터페이스(DuetWebControl)를 갖춘 3D 프린터용 제어판입니다.\n\n* 기본 포트: 80(http) 또는 443(https)\n* 인증: Duet 구성에 따라 다릅니다.\n\n### 레피티에\n\nRepetier-Server는 3D 프린터용 호스트 소프트웨어입니다.\n\n* 기본 포트: 3344\n* 인증: API 키가 필요합니다\n\n### 뱀부 랩스\n\nBambu Lab 프린터는 상태 및 제어를 위해 MQTT를 사용하고 파일 작업에는 FTP를 사용합니다.\n\n* 인증: 일련 번호 및 액세스 토큰이 필요합니다( `BAMBU_SERIAL` 및 `BAMBU_TOKEN` 설정)\n* 요구 사항: 프린터는 동일한 네트워크에 있어야 하거나 클라우드 연결이 활성화되어야 합니다.\n* 호환 가능: X1C, P1S, P1P, A1 및 기타 Bambu Lab 프린터\n\n#### Bambu 프린터의 일련 번호 및 액세스 토큰 찾기\n\nBambu Lab 프린터에 연결하려면 다음 두 가지가 필요합니다.\n\n1. **프린터 일련번호** :\n\n * 프린터 뒷면이나 바닥에서 일련 번호가 적힌 스티커를 찾아보세요(일반적으로 \"01P\" 또는 \"01A\"로 시작하고 그 뒤에 숫자/문자가 붙습니다)\n * 또는 Bambu Studio를 열고 프린터에 연결한 다음 장치 > 장치 관리로 이동하여 프린터 정보를 확인하세요.\n\n2. **액세스 토큰** :\n\n * 액세스 토큰은 프린터에 직접 연결하는 데 필요한 보안 코드입니다.\n * P1 시리즈 프린터의 경우: 터치스크린으로 이동하여 설정 > 네트워크 > LAN 모드를 선택하면 액세스 코드가 표시됩니다.\n * X1 시리즈 프린터의 경우: 터치스크린으로 이동하여 설정 > 네트워크 > LAN 모드를 선택하고 LAN 모드를 활성화하여 액세스 코드를 확인하세요.\n * A1 Mini의 경우: Bambu Handy 앱을 사용하여 프린터에 연결한 다음 설정 > 네트워크 > LAN 모드로 이동합니다.\n\n**참고** : 프린터가 동일한 로컬 네트워크에 없거나 액세스 토큰을 찾을 수 없는 경우 LAN 모드를 활성화하려면 프린터 펌웨어를 최신 버전으로 업데이트해야 할 수 있습니다.\n\n#### Bambu 커뮤니케이션 노트(MQTT 및 FTP)\n\n* **MQTT:** 이 서버는 커뮤니티 조사 결과(예: [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) )를 바탕으로 로컬 MQTT 프로토콜(포트 8883, TLS)을 사용하여 인쇄 시작 및 작업 취소와 같은 명령을 전송합니다.\n* **FTP:** 파일 목록 작성 및 업로드는 현재 프린터에서 실행되는 FTP 서버( `bambu-js` 라이브러리 도우미를 통해)에 의존합니다. **참고:** 이 FTP 연결은 현재 라이브러리 제한에 따라 보안되지 **않을 수 있습니다(일반 FTP)** . 네트워크 보안에 유의하여 사용하세요.\n\n### 프루사 커넥트\n\nPrusa Connect는 Prusa가 프린터를 관리하기 위해 개발한 클라우드 기반 솔루션입니다.\n\n* 기본 포트: 80(http) 또는 443(https)\n* 인증: API 키가 필요합니다\n* 호환 가능: Prusa MK4, Prusa Mini, Prusa XL 및 Prusa Connect가 있는 기타 Prusa 프린터\n\n#### Prusa Connect 설정\n\n1. Prusa 프린터가 최신 펌웨어로 업데이트되었는지 확인하세요.\n2. 프린터를 Wi-Fi 네트워크에 연결하세요\n3. Prusa Connect 계정을 만들고 프린터를 등록하세요\n4. 설정 > API 액세스에서 Prusa Connect 웹 인터페이스에서 API 키를 생성합니다.\n\n### 크리얼리티 클라우드\n\nCreality Cloud는 Creality의 프린터 관리 시스템입니다.\n\n* 기본 포트: 80(http) 또는 443(https)\n* 인증: 베어러 토큰이 필요합니다.\n* 호환 가능: Ender 시리즈, CR 시리즈 및 네트워크 기능이 있는 기타 Creality 프린터\n\n#### Creality Cloud 설정\n\n1. 모바일 기기에 Creality Cloud 앱을 설치하세요\n2. 계정을 만들고 프린터를 추가하세요\n3. 프린터에 대한 로컬 네트워크 액세스를 활성화하세요\n4. 설정 > 개발자 옵션에서 Creality Cloud 앱에서 토큰을 생성합니다.\n\n## 사용 가능한 도구\n\n### STL 조작 도구\n\n> **메모리 사용량 경고** : 다음 STL 조작 도구는 전체 3D 모델을 메모리에 로드합니다. 10MB 이상의 크고 복잡한 STL 파일의 경우 이러한 작업은 상당한 메모리를 소모할 수 있습니다. MCP 환경에서 이러한 도구를 사용할 때는 메모리 제약에 유의하십시오.\n\n#### get\\_stl\\_info\n\n크기, 정점 수, 경계 상자 등 STL 파일에 대한 자세한 정보를 얻으세요.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### stl\\_base 확장\n\nSTL 파일의 기본을 지정된 양만큼 확장합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### 스케일\\_stl\n\nSTL 모델을 균일하게 또는 특정 축을 따라 크기를 조정합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\n또는 비균일한 크기 조정의 경우:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### 회전\\_stl\n\nSTL 모델을 특정 축(도)을 중심으로 회전합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### 번역\\_stl\n\nSTL 모델을 특정 축(밀리미터)을 따라 이동합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### 병합\\_정점\n\n지정된 허용 오차보다 가까운 정점을 병합합니다. 작은 틈을 메우고 메시를 약간 단순화하는 데 도움이 됩니다.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### 센터\\_모델\n\n모델을 변환하여 경계 상자의 중심이 세계 원점(0,0,0)에 오도록 합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### 평평하게 놓다\n\n모델의 가장 큰 평면(이미 위나 아래를 향하지 않는 평면)을 찾고, 이 면이 XY 평면(Z=0)에서 아래쪽을 향하도록 모델을 회전해 보세요. 인쇄할 모델의 방향을 지정하는 데 유용합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### 수정\\_stl\\_섹션\n\nSTL 파일의 선택한 부분에 특정 변환을 적용합니다. 이를 통해 모델의 특정 부분을 세부적으로 수정할 수 있습니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\n사용자 정의 섹션 경계의 경우:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### 생성\\_stl\\_시각화\n\n다양한 각도(정면, 측면, 상단, 등각 투영 뷰)에서 STL 파일의 SVG 시각화를 생성합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### 슬라이스\\_stl\n\nSTL 파일을 슬라이스하여 G코드를 생성합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### 확인\\_온도\n\nG-코드 파일에서 온도 설정을 확인합니다.\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### 프로세스 및 인쇄 stl\n\nSTL 파일을 처리(베이스 확장)하고, 슬라이스하고, 온도를 확인한 후 인쇄를 시작합니다.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n**참고:** 최적의 인쇄를 위한 자동 방향 설정(지지대 최소화 등)은 일반적으로 슬라이서 GUI(예: OrcaSlicer 또는 PrusaSlicer)에서 처리하는 복잡한 작업이며 이 서버에는 구현되어 있지 않습니다.\n\n### 프린터 제어 도구\n\n#### 프린터 상태 가져오기\n\n3D 프린터의 현재 상태를 알아보세요.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu 프린터의 경우 현재 MQTT 연결만 확인합니다.\n\n#### 프린터 파일 목록\n\n프린터에서 사용 가능한 파일을 나열합니다.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu 프린터의 경우 FTP를 통해 `gcodes` 디렉토리에 있는 파일을 나열합니다.\n\n#### 업로드\\_g코드\n\n프린터에 G코드 파일을 업로드합니다.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nBambu 프린터의 경우 FTP를 통해 `gcodes` 디렉터리에 업로드합니다. 자동으로 인쇄를 시작할 수 없습니다.\n\n#### 시작\\_인쇄\n\n이미 프린터에 있는 파일의 인쇄를 시작합니다.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**Bambu 프린터에는 권장하지 않습니다.** Bambu `.3mf` 파일에는 `print_3mf` 사용하세요.\n\n#### 인쇄 취소\n\n현재 인쇄 작업을 취소합니다.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nBambu 프린터의 경우 MQTT를 통해 `stop_print` 명령을 전송합니다.\n\n#### 프린터 온도 설정\n\n프린터 구성 요소의 온도를 설정합니다.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**Bambu 프린터에서는 직접 MQTT 명령을 통해 지원되지 않습니다** .\n\n### 대나무 전용 도구\n\n#### print\\_3mf\n\nFTP를 통해 `.3mf` 파일을 Bambu 프린터에 업로드하고 MQTT 명령을 통해 인쇄 작업을 시작합니다. AMS 매핑과 같은 일부 인쇄 매개변수를 재정의할 수 있습니다.\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n**참고:** 이 도구를 사용하여 레이어 높이나 온도와 같은 슬라이서 설정을 재정의하는 것은 프린터의 MQTT 명령에서 지원되지 않습니다. `.3mf` 파일을 생성하기 전에 변경 사항을 적용하세요.\n\n## 사용 가능한 리소스\n\n### 프린터 리소스\n\n* `printer://{host}/status` - 3D 프린터의 현재 상태(현재 Bambu에서는 제한됨)\n* `printer://{host}/files` - 3D 프린터에서 사용 가능한 파일 목록(Bambu의 경우 FTP)\n* `printer://{host}/file/{filename}` - 특정 G-코드 파일의 내용(Bambu에 대해서만 존재 여부를 확인)\n\n### Bambu 프리셋 리소스\n\n`BAMBU_STUDIO_CONFIG_PATH` 환경 변수가 Bambu Studio 사용자 설정 디렉토리로 설정되어 있으면 저장된 사전 설정을 읽을 수 있습니다.\n\n* `preset://bambu/machine/{preset_name}` - 머신 사전 설정 파일을 읽습니다(예: `Bambu Lab P1S 0.4 nozzle.json` )\n* `preset://bambu/filament/{preset_name}` - 필라멘트 사전 설정 파일(예: `Generic PLA.json` )을 읽습니다.\n* `preset://bambu/process/{preset_name}` - 프로세스 사전 설정 파일을 읽습니다(예: `0.20mm Standard @BBL P1S.json` )\n\n**사용 예:** \"0.16mm Optimal @BBL P1S라는 이름의 Bambu 프로세스 사전 설정 내용을 읽어보세요\"(Claude는 readResource를 `preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S` 로 호출합니다)\n\n## Claude에 대한 예제 명령\n\nMCP 서버에 연결한 후 Claude에게 줄 수 있는 몇 가지 명령 예는 다음과 같습니다.\n\n### 프린터 제어\n\n* \"내 3D 프린터의 현재 상태는 어떻습니까?\"\n* \"프린터에 있는 파일 목록을 보여주세요.\"\n* \"이 G-코드를 내 프린터에 업로드하세요: \\[G-코드 내용]\"\n* \"benchy.gcode라는 이름의 파일을 인쇄하기 시작합니다.\"\n* \"현재 인쇄 작업을 취소합니다.\"\n* \"압출기 온도를 200°C로 설정하세요.\"\n* \"침대 온도를 60°C로 설정하세요.\"\n\n### STL 조작 및 인쇄\n\n* \"이 STL 파일을 가져와서 밑부분을 2인치 확장한 다음 슬라이서로 보내서 프린터에 대기시킵니다.\"\n* \"model.stl의 바닥을 1.5인치 확장하세요.\"\n* \"이 STL 파일의 크기를 150% 균일하게 조정합니다.\"\n* \"model.stl의 크기를 두 배로 키우되 높이는 그대로 유지합니다.\"\n* \"이 모델을 Z축을 중심으로 90도 회전시킵니다.\"\n* \"STL 모델을 5mm 위로 옮겨서 아래에 틈을 만드세요.\"\n* \"이 모델의 상단 부분만 수정해서 20% 더 크게 만들 수 있나요?\"\n* \"이 STL 파일을 분석해서 치수와 세부 정보를 알려주세요.\"\n* \"이 STL 파일의 시각화를 생성해서 어떻게 보이는지 확인해 주세요.\"\n* \"다양한 각도에서 모델의 SVG 시각화를 만듭니다.\"\n* \"높이를 바꾸지 않고 이 모델의 바닥을 더 넓게 만들어 보세요.\"\n* \"PrusaSlicer를 사용하여 수정된 STL 파일을 슬라이스합니다.\"\n* \"압출기의 G-코드 온도가 200°C, 베드의 온도가 60°C인지 확인하세요.\"\n* \"이 STL 파일을 처리하고, 밑부분을 2인치 더 길게 만들고, 잘라낸 다음 인쇄를 시작하세요. 하지만 먼저 온도를 확인하세요.\"\n* \"Bambu 프린터에서 `~/Downloads/my_model.3mf` 인쇄하세요.\"\n* \"AMS 슬롯 0과 2를 사용하여 `~/Desktop/calibration_cube.3mf` Bambu 프린터에 업로드하고 베드 레벨링을 끕니다.\"\n* \"Bambu P1S에서 인쇄 작업을 취소해 주세요.\"\n* \"Bambu 필라멘트 사전 설정 '일반 PETG'의 설정은 무엇입니까?\"\n* \"Bambu 프로세스 사전 설정을 보여주세요.\"\n\n## Bambu Lab 프린터 제한 사항\n\nBambu Lab 프린터 API의 특성상 몇 가지 제한 사항이 있습니다.\n\n1. **인쇄 시작** : 인쇄를 시작하려면 3MF 프로젝트 파일 경로, GCode 파일 이름, 인쇄 이름, MD5 해시 정보가 필요합니다. 이 서버의 간소화된 API는 아직 이 기능을 완전히 지원하지 않습니다.\n\n2. **온도 제어** : Bambu API는 온도를 설정하는 직접적인 방법을 제공하지 않습니다. 이를 위해서는 사용자 지정 G 코드 명령이 필요합니다.\n\n3. **파일 관리** : 파일은 프린터의 \"gcodes\" 디렉토리에 업로드해야 합니다.\n\n4. **FTP 보안:** 파일 작업은 현재 보안이 적용되지 않은 프린터의 FTP 서버(일반 FTP)를 사용합니다.\n\n5. **매개변수 재정의:** MQTT `project_file` 명령에서 지원하는 매개변수(예: AMS 사용, 보정 플래그)만 `print_3mf` 도구를 통해 재정의할 수 있습니다. 레이어 높이나 온도와 같은 슬라이서 설정은 인쇄 시 이 명령을 통해 변경할 수 없습니다.\n\n6. **상태 업데이트:** MQTT를 통한 실시간 전체 상태 모니터링은 추가 구현이 필요합니다.\n\n## 제한 사항 및 고려 사항\n\n### 메모리 사용량\n\n* **대용량 STL 파일** : 대용량 또는 복잡한 STL 파일을 처리할 경우 상당한 메모리를 소모할 수 있습니다. 작업 중 전체 STL 지오메트리가 메모리에 로드됩니다.\n* **여러 작업** : 여러 STL 작업을 순서대로 실행하면(특히 대용량 파일의 경우) 가비지 수집이 따라가지 못해 메모리가 누적될 수 있습니다.\n* **MCP 환경** : Claude의 MCP 환경은 MCP 서버로 실행되므로 메모리 제약이 있다는 점에 유의하십시오. 매우 큰 STL 파일에 대한 복잡한 작업은 메모리 부족 문제를 일으킬 수 있습니다.\n\n### STL 조작 제한\n\n* **단면 수정** : 단면별 수정 기능은 단순한 지오메트리에 가장 적합합니다. 복잡하거나 비다양체 메시는 예상치 못한 결과를 초래할 수 있습니다.\n* **기본 확장** : 기본 확장 알고리즘은 모델 아래에 새로운 지오메트리를 추가하는 방식으로 작동합니다. 하부가 복잡한 모델의 경우 결과가 완벽하지 않을 수 있습니다.\n* **오류 처리** : 강력한 오류 처리 기능을 추가했지만 복잡한 STL 파일의 일부 예외적인 경우는 여전히 문제를 일으킬 수 있습니다.\n\n### 시각화 제한 사항\n\n* **SVG 표현** : SVG 시각화는 진정한 3D 렌더링이 아닌 단순화된 도식적 표현입니다.\n* **복잡한 모델** : 매우 복잡한 모델의 경우 시각화를 통해 모든 세부 정보를 정확하게 표현하지 못할 수 있습니다.\n\n### 성능 고려 사항\n\n* **슬라이싱 작업** : 외부 슬라이서 프로세스는 CPU를 많이 사용하며 복잡한 모델의 경우 상당한 시간이 걸릴 수 있습니다.\n* **진행 상황 보고** : 대용량 파일의 경우 특정 처리 단계에서 진행 상황 업데이트가 중단된 것처럼 보일 수 있습니다.\n\n### 테스트 권장 사항\n\n* 기능 테스트를 위해 더 작은 STL 파일(< 10MB)로 시작하세요.\n* 대용량 파일을 처리할 때 메모리 사용량을 모니터링합니다.\n* 복잡한 형상을 시도하기 전에 간단한 형상에 대한 수정을 테스트하세요.\n* 대규모 작업의 경우 최소 4GB의 사용 가능한 RAM이 있는 시스템에서 실행하는 것을 고려하세요.\n\n## 배지\n\n| 배지 | 설명 |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |\n| [![npm 버전](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npm의 패키지의 현재 버전 |\n| [![라이센스: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | 이 프로젝트는 GPL-2.0 라이선스를 받았습니다. |\n| [![타입스크립트](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | 이 프로젝트는 TypeScript 4.9+로 작성되었습니다. |\n| [![유지](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | 이 프로젝트는 활발하게 유지 관리되고 있습니다 |\n| [![홍보 담당자 환영](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | Pull Request를 통한 기여를 환영합니다. |\n| [![Node.js 버전](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Node.js 18.0.0 이상이 필요합니다. |\n| [![다운로드](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npm에서 월별 다운로드 수 |\n| [![GitHub 별점](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | 이 프로젝트가 받은 GitHub 별 수 |\n\n## 특허\n\nGPL-2.0","Korean","ko-KR",{"_27":67,"_31":71,"_36":72},{"_29":68,"_31":69,"_33":70},"Обеспечивает взаимодействие с системами управления 3D-принтерами через сервер MCP, поддерживая обработку файлов STL, нарезку и управление такими принтерами, как OctoPrint, Klipper, Duet и другими.","Сервер 3D-принтера MCP","# Сервер 3D-принтера MCP\n\n[![npm-версия](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![Лицензия: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![Машинопись](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![Обслуживание](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![PR-сотрудники приветствуются](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Версия Node.js](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![Загрузки](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![Звезды GitHub](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* **Печать Bambu `.3mf` :** Добавлен инструмент `print_3mf` специально для принтеров Bambu Lab. Он загружает файл `.3mf` и отправляет команду печати напрямую через MQTT на основе спецификаций OpenBambuAPI.\n\n* **Прямое взаимодействие MQTT (Bambu):** переработана обработка команд Bambu ( `print_3mf` , `cancelJob` ) для использования прямого MQTT (порт TLS 8883) вместо использования исключительно `bambu-js` для команд.\n\n* **Анализ файлов `.3mf` :** реализован парсер ( `src/3mf_parser.ts` ) для чтения метаданных и настроек слайсера, специфичных для Bambu (из `project_settings.config` ) в файлах `.3mf` .\n\n* **Ресурсы предустановок Bambu:** добавлена поддержка чтения файлов предустановок Bambu Studio ( `machine` , `filament` , `process` ) как ресурсов MCP (например, `preset://bambu/process/MyPreset` ), если установлен `BAMBU_STUDIO_CONFIG_PATH` .\n\n* **Интеграция OrcaSlicer:** добавлена поддержка использования OrcaSlicer через интерфейс командной строки для инструмента `slice_stl` .\n\n* **Новые инструменты манипулирования STL:** добавлены инструменты `merge_vertices` , `center_model` и `lay_flat` для базовой подготовки модели с использованием `three.js` .\n\n* **Обновление конфигурации:** добавлена переменная среды `BAMBU_STUDIO_CONFIG_PATH` для предварительной загрузки.\n\n* **Примечание по использованию FTP:** в документации указано, что в настоящее время файловые операции для Bambu используют потенциально незащищенный FTP через `bambu-js` .\n\n* **Достижение паритета функций:** повышение функциональности (подробности статуса, операции с файлами, прямая печать, где это возможно, обработка предустановок) для OctoPrint, Klipper, Duet, Repetier, Prusa Connect и Creality Cloud до уровня надежности, запланированного для внедрения Bambu.\n\n* **Реализация полного статуса Bambu MQTT:** рефакторинг `getStatus` для Bambu для подписки на отчеты MQTT и сохранения состояния в реально�� времени.\n\n* **Реализуйте надежное сопоставление AMS:** замените логику заполнителя; правильно анализируйте и используйте сопоставление AMS из конфигурации слайсера `.3mf` или пользовательских переопределений для команды печати MQTT.\n\n* **Реализуйте переопределения печати `.3mf` :** добавьте логику в инструмент `print_3mf` для обработки переопределений, предоставленных пользователем (например, флагов калибровки), и потенциально общих настроек слайсера, если это осуществимо через MQTT/G-код.\n\n* **Вычислить хэш MD5:** добавить логику для вычисления и включить хэш MD5 файла `.3mf` в команду печати MQTT (необязательно, но рекомендуется протоколом).\n\n* **Реорганизация операций Bambu File:** рассмотрите возможность замены операций FTP `bambu-js` ( `getFiles` , `uploadFile` ) прямыми методами MQTT, если это возможно/стабильно, или добавьте поддержку FTPS в `bambu-js` .\n\n* **Добавлена предустановленная логика обнаружения:** улучшен список предустановленных ресурсов (в настоящее время списки основаны на потенциальных именах файлов, может анализировать файлы индекса, если они существуют).\n\n* **Расширение поддержки `.3mf` :** добавление поддержки печати `.3mf` для других типов принтеров, где это применимо.\n\n* **Обработка ошибок и отчетность:** улучшенная обработка ошибок MQTT и отчетность о ходе/завершении печати.\n\n* **Тестирование:** Проведите тщательное тестирование всех новых функций Bambu во время выполнения.\n\n## Оглавление\n\n* [Описание](#description)\n* [Функции](#features)\n* [Установка](#installation)\n\n * [Предпосылки](#prerequisites)\n * [Установить из npm](#install-from-npm)\n * [Установить из источника](#install-from-source)\n * [Работа с Docker](#running-with-docker)\n\n * [Использование слайсеров с Docker](#using-slicers-with-docker)\n* [Конфигурация](#configuration)\n* [Использование с Claude Desktop](#usage-with-claude-desktop)\n* [Поддерживаемые системы управления принтерами](#supported-printer-management-systems)\n\n * [OctoPrint](#octoprint)\n * [Клиппер (через Moonraker)](#klipper-via-moonraker)\n * [Дуэт](#duet)\n * [Репетитор](#repetier)\n * [Лаборатории Бамбу](#bambu-labs)\n\n * [Как найти серийный номер и токен доступа вашего принтера Bambu](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Заметки о коммуникации Bambu (MQTT и FTP)](#bambu-communication-notes-mqtt--ftp)\n * [Пруса Коннект](#prusa-connect)\n\n * [Настройка Prusa Connect](#setting-up-prusa-connect)\n * [Облако Creality](#creality-cloud)\n\n * [Настройка Creality Cloud](#setting-up-creality-cloud)\n* [Доступные инструменты](#available-tools)\n\n * [Инструменты для работы с STL](#stl-manipulation-tools)\n * [Инструменты управления принтером](#printer-control-tools)\n * [Инструменты, специфичные для бамбука](#bambu-specific-tools)\n* [Доступные ресурсы](#available-resources)\n\n * [Ресурсы принтера](#printer-resources)\n * [Ресурсы предустановок Bambu](#bambu-preset-resources)\n* [Примеры команд для LLM](#example-commands-for-claude)\n* [Ограничения принтера Bambu Lab](#bambu-lab-printer-limitations)\n* [Ограничения и соображения](#limitations-and-considerations)\n\n * [Использование памяти](#memory-usage)\n * [Ограничения манипуляций STL](#stl-manipulation-limitations)\n * [Ограничения визуализации](#visualization-limitations)\n * [Соображения производительности](#performance-considerations)\n * [Рекомендации по тестированию](#testing-recommendations)\n* [Значки](#badges)\n* [Лицензия](#license)\n\n## Описание\n\nЭто сервер, который позволяет пользователям MCP подключаться к конечным точкам API следующих 3D-принтеров:\n\n* OctoPrint\n* Клиппер (Лунный гонщик)\n* Дуэт\n* Репетитор\n* Лаборатории Бамбу\n* Пруса Коннект\n* Креативность/Эндер\n\nЭтот сервер представляет собой сервер Model Context Protocol (MCP) для соединения Claude с системами управления 3D-принтерами. Он позволяет MCP взаимодействовать с 3D-принтерами через API различных систем управления принтерами, таких как OctoPrint, Klipper (через Moonraker), Duet, Repetier и принтеры Bambu Labs.\n\n**Примечание об использовании ресурсов** : этот сервер MCP включает расширенные функции манипуляции 3D-моделями, которые могут быть ресурсоемкими при работе с большими файлами STL. Пожалуйста, ознакомьтесь с разделом «Ограничения и соображения» для получения важной информации об использовании памяти и производительности.\n\n## Функции\n\n* Получи��ь состояние принтера (температуру, ход печати и т. д.)\n* Список файлов на принтере\n* Загрузите файлы G-кода на принтер\n* Запуск, отмена и мониторинг заданий печати\n* Установите температуру принтера\n* Расширенные возможности работы с файлами STL:\n * Расширьте основание для лучшего сцепления\n * Масштабировать модели равномерно или вдоль определенных осей\n * Вращение моделей вокруг любой оси\n * Перевести (переместить) модели\n * Изменить определенные разделы файлов STL (верхний, нижний, центральный или пользовательский)\n* Комплексный анализ STL с подробной информацией о модели\n* Создание многоракурсных SVG-визуализаций файлов STL\n* Отчеты о ходе выполнения длительных операций в режиме реального времени\n* Обработка ошибок с подробной диагностикой\n* Разбиение STL-файлов на части для генерации G-кода\n* Подтвердите настройки температуры в файлах G-кода\n* Полный сквозной рабочий процесс от модификации STL до печати\n* Печатайте файлы `.3mf` напрямую на принтерах Bambu Lab (через команду MQTT)\n* Прочтите файлы предустановок Bambu Studio (принтер, нить, процесс) как ресурсы\n\n## Установка\n\n### Предпосылки\n\n* Node.js 18 или выше\n* нпм или пряжа\n\n### Установить из npm\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### Установить из источника\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### Работа с Docker\n\nВы также можете запустить сервер с помощью Docker и Docker Compose для контейнеризированной среды.\n\n1. Убедитесь, что у вас установлены Docker и Docker Compose.\n\n2. Скопируйте `.env.example` в `.env` и настройте параметры.\n\n3. Соберите и запустите контейнер:\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### Использование слайсеров с Docker\n\nОбратите внимание, что настройка Docker по умолчанию **не может напрямую использовать слайсер, установленный на вашей хост-машине** . Монтирование исполняемого файла слайсера непосредственно с хоста в контейнер ненадежно из-за различий в операционной системе и библиотеках между вашим хостом и контейнером.\n\nРекомендуемый подход — **установить ваш предпочтительный слайсер *внутри* образа Docker** . Это делает контейнер самодостаточным.\n\nДля этого вам нужно будет изменить `Dockerfile` . Вот концептуальный пример того, как вы можете добавить PrusaSlicer или OrcaSlicer (конкретные команды могут различаться в зависимости от слайсера, его зависимостей и текущих пакетов Alpine):\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\nПосле изменения `Dockerfile` перестройте свой образ ( `docker-compose build` ). Вам также нужно будет убедиться, что переменная среды `SLICER_PATH` в вашем файле `.env` или `docker-compose.yml` указывает на правильный путь *внутри контейнера* (например, `/usr/local/bin/orcaslicer` ). Также установите `SLICER_TYPE` на `orcaslicer` .\n\nИзвините, что не включил конкретный слайсер из коробки, но, учитывая широкий выбор слайсеров (PrusaSlicer, OrcaSlicer, Cura и т. д.) и доступных конфигураций, предварительная установка одного из них излишне раздула бы образ для многих пользователей. Если конкретный слайсер станет очень распространенным запросом, я, безусловно, могу рассмотреть возможность добавления официальной поддержки для него в будущей версии.\n\n## Конфигурация\n\nСоздайте файл `.env` в каталоге, где вы будете запускать сервер, или задайте переменные среды:\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## Использование с Claude Desktop\n\n1. Отредактируйте файл конфигурации Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. Для принтеров Bambu Labs:\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. Перезагрузить рабочий стол Клода\n4. Подключитесь к принтеру через Claude\n\n## Поддерживаемые системы управления принтерами\n\n### OctoPrint\n\nOctoPrint — популярный веб-интерфейс для 3D-принтеров. Он предоставляет REST API для управления принтером.\n\n* Порт по умолчанию: 80 (http) или 443 (https)\n* Аутентификация: требуется ключ API\n\n### Клиппер (через Moonraker)\n\nKlipper — это прошивка для 3D-принтеров, работающая с API-сервером Moonraker.\n\n* Порт по умолчанию: 7125\n* Аутентификация: зависит от конфигурации вашего Moonraker\n\n### Дуэт\n\nDuet — плата управления для 3D-принтеров с собственным веб-интерфейсом (DuetWebControl).\n\n* Порт по умолчанию: 80 (http) или 443 (https)\n* Аутентификация: зависит от конфигурации Duet.\n\n### Репетитор\n\nRepetier-Server — это программное обеспечение для 3D-принтеров.\n\n* Порт по умолчанию: 3344\n* Аутентификация: требуется ключ API\n\n### Лаборатории Бамбу\n\nПринтеры Bambu Lab используют MQTT для статуса и управления, а также FTP для файловых операций.\n\n* Аутентификация: требуется серийный номер и токен доступа (задайте `BAMBU_SERIAL` и `BAMBU_TOKEN` )\n* Требования: принтер должен быть в той же сети или иметь включенное облачное подключение.\n* Совместимо с: X1C, P1S, P1P, A1 и другими принтерами Bambu Lab\n\n#### Как найти серийный номер и токен доступа вашего принтера Bambu\n\nДля подключения к принтеру Bambu Lab вам понадобятся две вещи:\n\n1. **Серийный номер принтера** :\n\n * Найдите на задней или нижней панели принтера наклейку с серийным номером (обычно он начинается с «01P» или «01A», за которыми следуют цифры/буквы).\n * Либо откройте Bambu Studio, подключитесь к принтеру, перейдите в раздел «Устройство» > «Управление устройствами» и просмотрите информацию о принтере.\n\n2. **Токен доступа** :\n\n * Токен доступа — это код безопасности, необходимый для прямого подключения к вашему принтеру.\n * Для принтеров серии P1: перейдите на сенсорный экран, выберите «Настройки» > «Сеть» > «Режим локальной сети», и вы увидите код доступа.\n * Для принтеров серии X1: перейдите на сенсорный экран, выберите «Настройки» > «Сеть» > «Режим локальной сети» и включите «Режим локальной сети», чтобы увидеть код доступа.\n * Для A1 Mini: используйте приложение Bambu Handy для подключения к принтеру, затем перейдите в «Настройки» > «Сеть» > «Режим локальной сети».\n\n**Примечание** : Если ваш принтер не находится в той же локальной сети или вы не можете найти токен доступа, вам может потребоваться обновить прошивку принтера до последней версии, чтобы включить режим локальной сети.\n\n#### Заметки о коммуникации Bambu (MQTT и FTP)\n\n* **MQTT:** этот сервер использует локальный протокол MQTT (порт 8883, TLS) на основе результатов работы сообщества (например, [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) ) для отправки команд, таких как запуск печати и отмена заданий.\n* **FTP:** Список файлов и загрузка в настоящее время зависят от FTP-сервера, запущенного на принтере (через помощника библиотеки `bambu-js` ). **Примечание:** Это FTP-соединение может быть **незащищенным (обычный FTP)** из-за текущих ограничений библиотеки. Используйте с учетом безопасности вашей сети.\n\n### Пруса Коннект\n\nPrusa Connect — это собственное облачное решение Prusa для управления принтерами.\n\n* Порт по умолчанию: 80 (http) или 443 (https)\n* Аутентификация: требуется ключ API\n* Совместимо с: Prusa MK4, Prusa Mini, Prusa XL и другими принтерами Prusa с Prusa Connect\n\n#### Настройка Prusa Connect\n\n1. Убедитесь, что на вашем принтере Prusa установлена последняя версия прошивки.\n2. Подключите принтер к сети Wi-Fi.\n3. Создайте учетную запись Prusa Connect и зарегистрируйте свой принтер\n4. Сгенерируйте ключ API из веб-интерфейса Prusa Connect в разделе «Настройки» > «Доступ API».\n\n### Облако Creality\n\nCreality Cloud — это система управления принтерами компании Creality.\n\n* Порт по умолчанию: 80 (http) или 443 (https)\n* Аутентификация: требуется токен на предъявителя\n* Совместимо с: сериями Ender, CR и другими принтерами Creality с сетевыми возможностями.\n\n#### Настройка Creality Cloud\n\n1. Установите приложение Creality Cloud на свое мобильное устройство\n2. Создайте учетную запись и добавьте свой принтер\n3. Включите доступ к локальной сети для вашего принтера.\n4. Создайте токен из приложения Creality Cloud в разделе «Настройки» > «Параметры разработчика».\n\n## Доступные инструменты\n\n### Инструменты для работы с STL\n\n> **Предупреждение об использовании памяти** : следующие инструменты манипуляции STL загружают целые 3D-модели в память. Для больших или сложных файлов STL (>10 МБ) эти операции могут потреблять значительный объем памяти. При использовании этих инструментов в среде MCP помните об ограничениях памяти.\n\n#### получить\\_stl\\_информацию\n\nПолучите подробную информацию о файле STL, включая размеры, количество вершин и ограничивающую рамку.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### расширить\\_stl\\_base\n\nРасширить базу STL-файла на указанную величину.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### масштаб\\_стл\n\nМасштабируйте модель STL равномерно или вдоль определенных осей.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\nИли для неравномерного масштабирования:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### вращать\\_стл\n\nПоворот модели STL вокруг определенных осей (в градусах).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### translate\\_stl\n\nПеремещать модель STL вдоль определенных осей (в миллиметрах).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### merge\\_vertices\n\nОбъединить вершины, которые находятся ближе указанного допуска. Помогает закрыть небольшие зазоры и может немного упростить сетку.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### центр\\_модель\n\nПереместите модель так, чтобы центр ее ограничивающей рамки находился в начале координат (0,0,0).\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### lay\\_flat\n\nПопытайтесь определить самую большую плоскую поверхность модели (которая еще не обращена прямо вверх или вниз) и поверните модель так, чтобы эта грань была ориентирована вниз на плоскости XY (Z=0). Полезно для ориентации моделей для печати.\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### изменить\\_stl\\_section\n\nПрименить определенное преобразование к выбранному разделу файла STL. Это позволяет выполнять детальные модификации определенных частей модели.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\nДля пользовательских границ раздела:\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### генерировать\\_stl\\_визуализацию\n\nСоздайте SVG-визуализацию STL-файла с разных ракурсов (вид спереди, сбоку, сверху и изометрический).\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### ломтик\\_стл\n\nРазрежьте STL-файл для генерации G-кода.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### подтвердить\\_температуры\n\nПодтвердите настройки температуры в файле G-кода.\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### процесс\\_и\\_печать\\_stl\n\nОбработайте файл STL (расширьте базу), нарежьте его, подтвердите температуры и начните печать.\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n**Примечание:** Автоматическая ориентация для оптимальной печати (минимизация поддержек и т. д.) — сложная задача, обычно решаемая графическими интерфейсами слайсеров (например, OrcaSlicer или PrusaSlicer), и не реализованная на этом сервере.\n\n### Инструменты управления принтером\n\n#### получить\\_статус\\_принтера\n\nПолучите текущий статус 3D-принтера.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nДля принтеров Bambu в настоящее время подтверждается только соединение MQTT.\n\n#### список\\_файлов\\_принтера\n\nСписок файлов, доступных на принтере.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nДля принтеров Bambu выводит список файлов в каталоге `gcodes` через FTP.\n\n#### upload\\_gcode\n\nЗагрузите файл G-кода на принтер.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\nДля принтеров Bambu, загрузка в каталог `gcodes` через FTP. Невозможно начать печать автоматически.\n\n#### начать\\_печатать\n\nНачните печать файла, который уже находится на принтере.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n**Не рекомендуется для принтеров Bambu.** Используйте `print_3mf` для файлов Bambu `.3mf` .\n\n#### отменить\\_печать\n\nОтменить текущее задание на печать.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\nДля принтеров Bambu отправляет команду `stop_print` через MQTT.\n\n#### установить\\_температуру\\_принтера\n\nУстановите температуру компонента принтера.\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**Не поддерживается для принтеров Bambu** через прямые команды MQTT.\n\n### Инструменты, специфичные для бамбука\n\n#### print\\_3mf\n\nЗагружает файл `.3mf` на принтер Bambu через FTP и инициирует задание печати через команду MQTT. Позволяет переопределять некоторые параметры печати, такие как сопоставление AMS.\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n**Примечание:** Переопределение настроек слайсера, таких как высота слоя или температура, с помощью этого инструмента не поддерживается командой MQTT принтера. Примените эти изменения перед созданием файла `.3mf` .\n\n## Доступные ресурсы\n\n### Ресурсы принтера\n\n* `printer://{host}/status` - Текущее состояние 3D-принтера (в настоящее время ограничено для Bambu)\n* `printer://{host}/files` - Список файлов, доступных на 3D-принтере (FTP для Bambu)\n* `printer://{host}/file/{filename}` — Содержимое определенного файла G-кода (проверяет существование только для Bambu)\n\n### Ресурсы предустановок Bambu\n\nЕсли переменная среды `BAMBU_STUDIO_CONFIG_PATH` установлена в каталоге пользовательских настроек Bambu Studio, вы можете прочитать сохраненные вами пресеты.\n\n* `preset://bambu/machine/{preset_name}` — считывает файл предустановок машины (например, `Bambu Lab P1S 0.4 nozzle.json` )\n* `preset://bambu/filament/{preset_name}` — считывает файл предустановок нити (например, `Generic PLA.json` )\n* `preset://bambu/process/{preset_name}` — считывает файл предустановок процесса (например, `0.20mm Standard @BBL P1S.json` )\n\n**Пример использования:** «Прочитать содержимое моей предварительной настройки процесса Bambu с именем «0.16mm Optimal @BBL P1S»» (Клод вызвал бы ReadResource с `preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S` )\n\n## Примеры команд для Клода\n\nВот несколько примеров команд, которые вы можете дать Клоду после подключения к серверу MCP:\n\n### Управление принтером\n\n* «Каково текущее состояние моего 3D-принтера?»\n* «Покажи мне список файлов на моем принтере».\n* «Загрузите этот G-код на мой принтер: \\[содержимое G-кода]»\n* «Начать печать файла с именем 'benchy.gcode'».\n* «Отменить текущее задание на печать».\n* «Установите температуру экструдера на 200°C».\n* «Установите температуру кровати на 60°C».\n\n### Обработка и печать STL\n\n* «Возьмите этот STL-файл и удлините основание на 2 дюйма, затем отправьте его на слайсер и поставьте в очередь на моем принтере».\n* «Увеличьте основание model.stl на 1,5 дюйма».\n* «Масштабировать этот STL-файл на 150% равномерно».\n* «Увеличьте ширину model.stl в два раза, но сохраните ту же высоту».\n* «Поверните эту модель на 90 градусов вокруг оси Z».\n* «Переместите эту модель STL на 5 мм вверх, чтобы создать зазор снизу».\n* «Можете ли вы изменить только верхнюю часть этой модели, чтобы сделать ее на 20% больше?»\n* «Проанализируйте этот STL-файл и сообщите мне его размеры и детали».\n* «Создайте визуализацию этого STL-файла, чтобы я мог увидеть, как он выглядит».\n* «Создать SVG-визуализации моей модели с разных ракурсов».\n* «Сделайте основание этой модели шире, не меняя ее высоту».\n* «Нарежьте измененный файл STL с помощью PrusaSlicer».\n* «Убедитесь, что температура в G-коде составляет 200°C для экструдера и 60°C для стола».\n* «Обработайте этот STL-файл, удлините основание на 2 дюйма, разрежьте его и начните печать, но сначала проверьте температуру».\n* «Распечатать `~/Downloads/my_model.3mf` на принтере Bambu».\n* «Загрузите `~/Desktop/calibration_cube.3mf` в принтер Bambu, используя слоты AMS 0 и 2, и отключите выравнивание платформы».\n* «Отмените задание печати на моем Bambu P1S».\n* «Каковы настройки в моей настройке филамента Bambu «Универсальный PETG»?»\n* «Покажите мне мои настройки процесса Bambu».\n\n## Ограничения принтера Bambu Lab\n\nИз-за особенностей API принтера Bambu Lab существуют некоторые ограничения:\n\n1. **Запуск печати** : для запуска печати требуется путь к файлу проекта 3MF, имя файла gcode, имя печати и хэш MD5. Упрощенный API на этом сервере пока не поддерживает это полностью.\n\n2. **Контроль температуры** : API Bambu не предоставляет прямых методов для установки температур. Для этого потребуются специальные команды G-кода.\n\n3. **Управление файлами** : Файлы необходимо загрузить в каталог «gcodes» на принтере.\n\n4. **Безопасность FTP:** в настоящее время файловые операции используют FTP-сервер принтера, который может быть незащищенным (обычный FTP).\n\n5. **Переопределение параметров:** только параметры, поддерживаемые командой MQTT `project_file` могут быть переопределены с помощью инструмента `print_3mf` (например, использование AMS, флаги калибровки). Настройки слайсера, такие как высота слоя или температура, не могут быть изменены во время печати с помощью этой команды.\n\n6. **Обновления статуса:** полный мониторинг статуса в реальном времени через MQTT требует дальнейшей реализации.\n\n## Ограничения и соображения\n\n### Использование памяти\n\n* **Большие файлы STL** : Обработка больших или сложных файлов STL может потреблять значительный объем памяти. Вся геометрия STL загружается в память во время операций.\n* **Множественные операции** : Последовательное выполнение нескольких операций STL (особенно для больших файлов) может привести к накоплению памяти, если сборка мусора не справляется.\n* **Среда MCP** : Поскольку это работает как сервер MCP, учтите, что среда MCP Клода имеет ограничения памяти. Сложные операции с очень большими файлами STL могут вызвать проблемы с нехваткой памяти.\n\n### Ограничения манипуляций STL\n\n* **Модификация секции** : Функция модификации, специфичная для секции, лучше всего работает на более простых геометриях. Сложные или не-многообразные сетки могут давать неожиданные результаты.\n* **Расширение базы** : алгоритм расширения базы работает путем добавления новой геометрии под модель. Для моделей со сложными нижними частями результаты могут быть неидеальными.\n* **Обработка ошибок** : хотя мы добавили надежную обработку ошибок, некоторые пограничные случаи в сложных файлах STL все еще могут вызывать проблемы.\n\n### Ограничения визуализации\n\n* **Представление SVG** : Визуализация SVG представляет собой упрощенное схематическое представление, а не настоящую 3D-визуализацию.\n* **Сложные модели** : для очень сложных моделей визуализация может неточно отображать все детали.\n\n### Соображения производительности\n\n* **Операции слайсинга** : Внешние процессы слайсинга могут быть ресурсоемкими для ЦП и ��огут занять значительное время для сложных моделей.\n* **Отчеты о ходе выполнения** : для больших файлов обновления хода выполнения могут задерживаться на определенных этапах обработки.\n\n### Рекомендации по тестированию\n\n* Начните с небольших файлов STL (< 10 МБ) для проверки функциональности.\n* Мониторинг использования памяти при обработке больших файлов\n* Протестируйте модификации на простых геометрических формах, прежде чем пробовать сложные.\n* Для более масштабных операций рассмотрите возможность работы в системе с объемом оперативной памяти не менее 4 ГБ.\n\n## Значки\n\n| Значок | Описание |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |\n| [![npm-версия](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Текущая версия пакета на npm |\n| [![Лицензия: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | Этот проект распространяется по лицензии GPL-2.0 |\n| [![Машинопись](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | Этот проект написан на TypeScript 4.9+. |\n| [![Обслуживание](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | Этот проект активно поддерживается |\n| [![PR-сотрудники приветствуются](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | Мы приветствуем вклад через запросы на извлечение. |\n| [![Версия Node.js](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | Требуется Node.js 18.0.0 или выше |\n| [![Загрузки](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | Количество загрузок в месяц с npm |\n| [![Звезды GitHub](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | Количество звезд GitHub, которые получил этот проект |\n\n## Лицензия\n\nGPL-2.0","Russian","ru-RU",{"_27":74,"_31":78,"_36":79},{"_29":75,"_31":76,"_33":77},"通过 MCP 服务器实现与 3D 打印机管理系统的交互，支持 STL 文件操作、切片以及 OctoPrint、Klipper、Duet 等打印机的控制。","MCP 3D打印服务器","# MCP 3D打印服务器\n\n[![npm 版本](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![许可证：GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) [![维护](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) [![欢迎 PR](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) [![Node.js 版本](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) [![下载](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) [![GitHub 星标](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n* \\*\\*Bambu `.3mf`打印：\\*\\*新增专为 Bambu Lab 打印机设计的`print_3mf`工具。该工具会上传`.3mf`文件，并根据 OpenBambuAPI 规范通过 MQTT 直接发送打印命令。\n\n* \\*\\*直接 MQTT 通信（Bambu）：\\*\\*重构 Bambu 命令处理（ `print_3mf` 、 `cancelJob` ）以使用直接 MQTT（TLS 端口 8883），而不是仅仅依赖`bambu-js`执行命令。\n\n* \\*\\*`.3mf`文件解析：\\*\\*实现了一个解析器（ `src/3mf_parser.ts` ）来读取`.3mf`文件中的元数据和 Bambu 特定的切片器设置（来自`project_settings.config` ）。\n\n* \\*\\*Bambu 预设资源：\\*\\*如果设置了`BAMBU_STUDIO_CONFIG_PATH` ，则增加了对将 Bambu Studio 预设文件（ `machine` 、 `filament` 、 `process` ）读取为 MCP 资源（例如， `preset://bambu/process/MyPreset` ）的支持。\n\n* \\*\\*OrcaSlicer 集成：\\*\\*增加了通过其命令行界面为`slice_stl`工具使用 OrcaSlicer 的支持。\n\n* \\*\\*新的 STL 操作工具：\\*\\*添加了`merge_vertices` 、 `center_model`和`lay_flat`工具，用于使用`three.js`进行基本模型准备。\n\n* \\*\\*配置更新：\\*\\*添加了用于预设加载的`BAMBU_STUDIO_CONFIG_PATH`环境变量。\n\n* \\*\\*FTP 使用说明：\\*\\*在文档中承认，Bambu 的文件操作当前通过`bambu-js`使用可能不安全的 FTP。\n\n* \\*\\*实现功能奇偶校验：\\*\\*将 OctoPrint、Klipper、Duet、Repetier、Prusa Connect 和 Creality Cloud 的功能（状态详细信息、文件操作、尽可能直接打印、预设处理）提升到 Bambu 实施所计划的稳健性级别。\n\n* \\*\\*实现完整的 Bambu MQTT 状态：\\*\\*重构 Bambu 的`getStatus`以订阅 MQTT 报告并保持实时状态。\n\n* \\*\\*实现强大的 AMS 映射：\\*\\*替换占位符逻辑；正确解析并使用来自`.3mf`切片器配置或用户覆盖的 AMS 映射来执行 MQTT 打印命令。\n\n* \\*\\*实施`.3mf`打印覆盖：\\*\\*向`print_3mf`工具添加逻辑以处理用户提供的覆盖（例如，校准标志）以及可能通过 MQTT/G 代码实现的常见切片机设置（如果可行）。\n\n* \\*\\*计算 MD5 哈希：\\*\\*添加逻辑以计算并包含 MQTT 打印命令中的`.3mf`文件的 MD5 哈希（可选但协议推荐）。\n\n* \\*\\*重构 Bambu File Ops：\\*\\*如果可能/稳定，研究用直接 MQTT 方法替换`bambu-js` FTP 操作（ `getFiles` 、 `uploadFile` ），或者为`bambu-js`提供 FTPS 支持。\n\n* \\*\\*添加预设发现逻辑：\\*\\*改进预设资源列表（当前根据潜在文件名列出，如果存在则可以解析索引文件）。\n\n* \\*\\*扩展`.3mf`支持：\\*\\*在适用的情况下为其他打印机类型添加`.3mf`打印支持。\n\n* \\*\\*错误处理和报告：\\*\\*增强 MQTT 错误处理和打印进度/完成的报告。\n\n* \\*\\*测试：\\*\\*对所有新的 Bambu 功能进行彻底的运行时测试。\n\n## 目录\n\n* [描述](#description)\n* [特征](#features)\n* [安装](#installation)\n\n * [先决条件](#prerequisites)\n * [从 npm 安装](#install-from-npm)\n * [从源安装](#install-from-source)\n * [使用 Docker 运行](#running-with-docker)\n\n * [在 Docker 中使用切片器](#using-slicers-with-docker)\n* [配置](#configuration)\n* [与 Claude Desktop 一起使用](#usage-with-claude-desktop)\n* [支持的打印机管理系统](#supported-printer-management-systems)\n\n * [OctoPrint](#octoprint)\n * [Klipper（来自 Moonraker）](#klipper-via-moonraker)\n * [二重唱](#duet)\n * [雷佩蒂尔](#repetier)\n * [Bambu实验室](#bambu-labs)\n\n * [查找 Bambu 打印机的序列号和访问令牌](#finding-your-bambu-printers-serial-number-and-access-token)\n * [Bambu 通信说明 (MQTT & FTP)](#bambu-communication-notes-mqtt--ftp)\n * [Prusa Connect](#prusa-connect)\n\n * [设置 Prusa Connect](#setting-up-prusa-connect)\n * [创想云](#creality-cloud)\n\n * [设置Creality Cloud](#setting-up-creality-cloud)\n* [可用工具](#available-tools)\n\n * [STL操作工具](#stl-manipulation-tools)\n * [打印机控制工具](#printer-control-tools)\n * [Bambu 专用工具](#bambu-specific-tools)\n* [可用资源](#available-resources)\n\n * [打印机资源](#printer-resources)\n * [Bambu 预设资源](#bambu-preset-resources)\n* [LLM 的示例命令](#example-commands-for-claude)\n* [Bambu Lab 打印机的局限性](#bambu-lab-printer-limitations)\n* [限制和注意事项](#limitations-and-considerations)\n\n * [内存使用情况](#memory-usage)\n * [STL 操作限制](#stl-manipulation-limitations)\n * [可视化限制](#visualization-limitations)\n * [性能考虑](#performance-considerations)\n * [测试建议](#testing-recommendations)\n* [徽章](#badges)\n* [执照](#license)\n\n## 描述\n\n这是一个允许 MCP 用户连接这些 3D 打印机的 API 端点的服务器：\n\n* OctoPrint\n* 克利珀（《太空城》）\n* 二重唱\n* 雷佩蒂尔\n* Bambu实验室\n* Prusa Connect\n* Creality/Ender\n\n该服务器是一个模型上下文协议 (MCP) 服务器，用于将 Claude 与 3D 打印机管理系统连接起来。它允许 MCP 通过各种打印机管理系统（例如 OctoPrint、Klipper（通过 Moonraker）、Duet、Repetier 和 Bambu Labs 打印机）的 API 与 3D 打印机进行交互。\n\n**资源使用注意事项**：此 MCP 服务器包含高级 3D 模型处理功能，处理大型 STL 文件时可能会占用大量内存。有关内存使用情况和性能的重要信息，请参阅“限制和注意事项”部分。\n\n## 特征\n\n* 获取打印机状态（温度、打印进度等）\n* 列出打印机上的文件\n* 将 G 代码文件上传到打印机\n* 启动、取消和监控打印作业\n* 设置打印机温度\n* 高级 STL 文件操作：\n * 延长底座以获得更好的附着力\n * 均匀缩放模型或沿特定轴缩放模型\n * 围绕任意轴旋转模型\n * 平移（移动）模型\n * 修改 STL 文件的特定部分（顶部、底部、中心或自定义）\n* 具有详细模型信息的全面 STL 分析\n* 生成 STL 文件的多角度 SVG 可视化\n* 长时间操作的实时进度报告\n* 通过详细诊断进行错误处理\n* 切片 STL 文件以生成 G 代码\n* 确认 G 代码文件中的温度设置\n* 从 STL 修改到打印的完整端到端工作流程\n* 直接在 Bambu Lab 打印机上打印`.3mf`文件（通过 MQTT 命令）\n* 将 Bambu Studio 预设文件（打印机、灯丝、工艺）读取为资源\n\n## 安装\n\n### 先决条件\n\n* Node.js 18 或更高版本\n* npm 或 yarn\n\n### 从 npm 安装\n\n```bash\nnpm install -g mcp-3d-printer-server\n```\n\n### 从源安装\n\n```bash\ngit clone https://github.com/dmontgomery40/mcp-3d-printer-server.git\ncd mcp-3d-printer-server\nnpm install\nnpm link # Makes the command available globally\n```\n\n### 使用 Docker 运行\n\n您还可以使用 Docker 和 Docker Compose 在容器化环境中运行服务器。\n\n1. 确保已安装 Docker 和 Docker Compose。\n\n2. 将`.env.example`复制到`.env`并配置您的设置。\n\n3. 构建并运行容器：\n\n ```bash\n docker-compose up --build -d\n ```\n\n#### 在 Docker 中使用切片器\n\n请注意，默认的 Docker 设置**无法直接使用主机上安装的切片器**。由于主机和容器之间的操作系统和库存在差异，将切片器可执行文件直接从主机挂载到容器中是不可靠的。\n\n推荐的方法是**在 Docker 镜像*中* 安装你首选的切片器**。这使得容器能够自给自足。\n\n为此，您需要修改`Dockerfile` 。以下是如何添加 PrusaSlicer 或 OrcaSlicer 的概念示例（具体命令可能因切片器、其依赖项和当前 Alpine 软件包而异）：\n\n```dockerfile\n# ... other Dockerfile commands ...\n\n# Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)\n# Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)\n# If not available, download and install manually (e.g., AppImage):\n# RUN apk add --no-cache fuse # FUSE might be needed for AppImages\n# RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \\\n# chmod +x /usr/local/bin/orcaslicer\n\n# Set the SLICER_PATH env var accordingly in docker-compose.yml or when running\n# Example for installed executable:\nENV SLICER_PATH=/usr/local/bin/orcaslicer \n\n# ... rest of Dockerfile ...\n```\n\n修改`Dockerfile`后，重建镜像（ `docker-compose build` ）。您还需要确保`.env`文件或`docker-compose.yml`中的`SLICER_PATH`环境变量指向*容器内的*正确路径（例如， `/usr/local/bin/orcaslicer` ）。并将`SLICER_TYPE`设置为`orcaslicer` 。\n\n抱歉，没有包含某个特定的切片器，但考虑到切片器种类繁多（PrusaSlicer、OrcaSlicer、Cura 等），以及可用的配置，预装一个切片器会给许多用户带来不必要的镜像臃肿。如果某个切片器的需求变得非常普遍，我肯定会考虑在未来的版本中添加对它的官方支持。\n\n## 配置\n\n在运行服务器或设置环境变量的目录中创建一个`.env`文件：\n\n```env\n# Required for authentication with your printer management system\nAPI_KEY=your_api_key_here\n\n# Default printer connection settings\nPRINTER_HOST=localhost\nPRINTER_PORT=80 # Port for non-Bambu HTTP APIs\nPRINTER_TYPE=octoprint # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality\n\n# Optional: Directory for temporary files\nTEMP_DIR=/path/to/temp/dir\n\n# Bambu Labs specific configuration\nBAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu\nBAMBU_TOKEN=your_access_token # REQUIRED for Bambu\n\n# Slicer configuration (for slice_stl tool)\nSLICER_TYPE=prusaslicer # Options: prusaslicer, cura, slic3r, orcaslicer\nSLICER_PATH=/path/to/slicer/executable\nSLICER_PROFILE=/path/to/slicer/profile\n\n# Optional: Path to Bambu Studio user config dir (for loading presets)\n# Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID\n# Example Windows: C:\\Users\\your_user\\AppData\\Roaming\\BambuStudio\\user\\YOUR_USER_ID\n# Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID\nBAMBU_STUDIO_CONFIG_PATH=\n```\n\n## 与 Claude Desktop 一起使用\n\n1. 编辑您的 Claude Desktop 配置文件：\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"API_KEY\": \"your_api_key_here\",\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"octoprint\"\n }\n }\n }\n}\n```\n\n2. 对于 Bambu Labs 打印机：\n\n```json\n{\n \"mcpServers\": {\n \"3dprint\": {\n \"command\": \"mcp-3d-printer-server\",\n \"env\": {\n \"PRINTER_HOST\": \"your_printer_ip\",\n \"PRINTER_TYPE\": \"bambu\",\n \"BAMBU_SERIAL\": \"your_printer_serial\",\n \"BAMBU_TOKEN\": \"your_access_token\"\n }\n }\n }\n}\n```\n\n3. 重启Claude桌面\n4. 通过 Claude 连接到您的打印机\n\n## 支持的打印机管理系统\n\n### OctoPrint\n\nOctoPrint 是一款流行的 3D 打印机 Web 界面。它提供了用于控制打印机的 REST API。\n\n* 默认端口：80（http）或 443（https）\n* 身份验证：需要 API 密钥\n\n### Klipper（来自 Moonraker）\n\nKlipper 是与 Moonraker API 服务器配合使用的 3D 打印机固件。\n\n* 默认端口：7125\n* 身份验证：取决于你的 Moonraker 配置\n\n### 二重唱\n\nDuet 是一款用于 3D 打印机的控制板，具有自己的 Web 界面（DuetWebControl）。\n\n* 默认端口：80（http）或 443（https）\n* 身份验证：取决于您的 Duet 配置\n\n### 雷佩蒂尔\n\nRepetier-Server是一款3D打印机的主机软件。\n\n* 默认端口：3344\n* 身份验证：需要 API 密钥\n\n### Bambu实验室\n\nBambu Lab 打印机使用 MQTT 进行状态和控制，使用 FTP 进行文件操作。\n\n* 身份验证：需要序列号和访问令牌（设置`BAMBU_SERIAL`和`BAMBU_TOKEN` ）\n* 要求：打印机必须在同一网络上或启用云连接\n* 兼容：X1C、P1S、P1P、A1 和其他 Bambu Lab 打印机\n\n#### 查找 Bambu 打印机的序列号和访问令牌\n\n要连接到 Bambu Lab 打印机，您需要两样东西：\n\n1. **打印机序列号**：\n\n * 查看打印机背面或底部的标签，上面有序列号（通常以“01P”或“01A”开头，后跟数字/字母）\n * 或者，打开 Bambu Studio，连接到您的打印机，转到设备 > 设备管理，然后查看打印机的信息\n\n2. **访问令牌**：\n\n * 访问令牌是直接连接到打印机所需的安全代码\n * 对于 P1 系列打印机：转到触摸屏，选择“设置”>“网络”>“LAN 模式”，您将看到访问代码\n * 对于 X1 系列打印机：转到触摸屏，选择“设置”>“网络”>“LAN 模式”，然后启用 LAN 模式以查看访问代码\n * 对于 A1 Mini：使用 Bambu Handy 应用程序连接到打印机，然后转到设置 > 网络 > LAN 模式\n\n**注意**：如果您的打印机不在同一个本地网络上或者您找不到访问令牌，则可能需要将打印机的固件更新到最新版本以启用 LAN 模式。\n\n#### Bambu 通信说明 (MQTT & FTP)\n\n* \\*\\*MQTT：\\*\\*此服务器使用基于社区发现（例如， [OpenBambuAPI](https://github.com/Doridian/OpenBambuAPI) ）的本地 MQTT 协议（端口 8883，TLS）来发送诸如开始打印和取消作业之类的命令。\n* \\*\\*FTP：\\*\\*文件列表和上传目前依赖于打印机上运行的 FTP 服务器（通过`bambu-js`库助手）。**注意：**由于当前库的限制，此 FTP 连接可能**不安全（纯 FTP）** 。使用时请注意网络安全。\n\n### Prusa Connect\n\nPrusa Connect 是 Prusa 自己的基于云的打印机管理解决方案。\n\n* 默认端口：80（http）或 443（https）\n* 身份验证：需要 API 密钥\n* 兼容：Prusa MK4、Prusa Mini、Prusa XL 和其他带有 Prusa Connect 的 Prusa 打印机\n\n#### 设置 Prusa Connect\n\n1. 确保您的 Prusa 打印机已更新至最新固件\n2. 将打印机连接到 Wi-Fi 网络\n3. 创建 Prusa Connect 帐户并注册您的打印机\n4. 从 Prusa Connect Web 界面的“设置”>“API 访问”下生成 API 密钥\n\n### 创想云\n\nCreality Cloud 是 Creality 针对其打印机的管理系统。\n\n* 默认端口：80（http）或 443（https）\n* 身份验证：需要 Bearer 令牌\n* 兼容：Ender系列、CR系列以及其他具有网络功能的Creality打印机\n\n#### 设置Creality Cloud\n\n1. 在您的移动设备上安装 Creality Cloud 应用程序\n2. 创建帐户并添加您的打印机\n3. 为您的打印机启用本地网络访问\n4. 在 Creality Cloud 应用的“设置”>“开发者选项”下生成令牌\n\n## 可用工具\n\n### STL操作工具\n\n> **内存使用警告**：以下 STL 操作工具会将整个 3D 模型加载到内存中。对于大型或复杂的 STL 文件（>10MB），这些操作可能会消耗大量内存。在 MCP 环境中使用这些工具时，请注意内存限制。\n\n#### 获取stl信息\n\n获取有关 STL 文件的详细信息，包括尺寸、顶点数和边界框。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\"\n}\n```\n\n#### 扩展\\_stl\\_base\n\n将 STL 文件的基础扩展指定的量。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2\n}\n```\n\n#### scale\\_stl\n\n均匀缩放 STL 模型或沿特定轴缩放。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_factor\": 1.5\n}\n```\n\n或者对于非均匀缩放：\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"scale_x\": 1.2,\n \"scale_y\": 1.0,\n \"scale_z\": 1.5\n}\n```\n\n#### 旋转\\_stl\n\n围绕特定轴（以度为单位）旋转 STL 模型。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"rotate_x\": 45,\n \"rotate_y\": 0,\n \"rotate_z\": 90\n}\n```\n\n#### 翻译\\_stl\n\n沿特定轴（以毫米为单位）移动 STL 模型。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"translate_x\": 10,\n \"translate_y\": 5,\n \"translate_z\": 0\n}\n```\n\n#### 合并顶点\n\n合并小于指定公差的顶点。有助于缩小小间隙并略微简化网格。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\",\n \"tolerance\": 0.01 // Optional, default = 0.01mm\n}\n```\n\n#### 中心模型\n\n平移模型，使其边界框的中心位于世界原点 (0,0,0)。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### 平放\n\n尝试找出模型最大的平面（即尚未正对上方或下方的平面），并旋转模型，使该面在 XY 平面（Z=0）上朝下。这有助于确定打印模型的方向。\n\n```json\n{\n \"stl_path\": \"/path/to/model.stl\"\n}\n```\n\n#### 修改\\_stl\\_部分\n\n对 STL 文件的选定部分应用特定转换。这允许对模型的特定部分进行详细修改。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"top\",\n \"transformation_type\": \"scale\",\n \"value_x\": 1.5,\n \"value_y\": 1.5, \n \"value_z\": 1.5\n}\n```\n\n对于自定义部分边界：\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"section\": \"custom\",\n \"transformation_type\": \"rotate\",\n \"value_x\": 0,\n \"value_y\": 0, \n \"value_z\": 45,\n \"custom_min_x\": -10,\n \"custom_min_y\": 0,\n \"custom_min_z\": -10,\n \"custom_max_x\": 10,\n \"custom_max_y\": 20,\n \"custom_max_z\": 10\n}\n```\n\n#### 生成\\_stl\\_可视化\n\n从多个角度（正面、侧面、顶部和等距视图）生成 STL 文件的 SVG 可视化。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"width\": 400,\n \"height\": 400\n}\n```\n\n#### 切片\\_stl\n\n切片 STL 文件以生成 G 代码。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"slicer_type\": \"prusaslicer\",\n \"slicer_path\": \"/path/to/prusaslicer\",\n \"slicer_profile\": \"/path/to/profile.ini\"\n}\n```\n\n#### 确认温度\n\n确认 G 代码文件中的温度设置。\n\n```json\n{\n \"gcode_path\": \"/path/to/file.gcode\",\n \"extruder_temp\": 200,\n \"bed_temp\": 60\n}\n```\n\n#### 处理和打印\\_stl\n\n处理 STL 文件（扩展基础）、对其进行切片、确认温度并开始打印。\n\n```json\n{\n \"stl_path\": \"/path/to/file.stl\",\n \"extension_inches\": 2,\n \"extruder_temp\": 200,\n \"bed_temp\": 60,\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n\\*\\*注意：\\*\\*自动定位以实现最佳打印（最小化支撑等）是一项复杂的任务，通常由切片器 GUI（如 OrcaSlicer 或 PrusaSlicer）处理，并且未在此服务器中实现。\n\n### 打印机控制工具\n\n#### 获取打印机状态\n\n获取 3D 打印机的当前状态。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n对于 Bambu 打印机，目前这仅确认 MQTT 连接。\n\n#### 列出打印机文件\n\n列出打印机上可用的文件。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n对于 Bambu 打印机，通过 FTP 列出`gcodes`目录中的文件。\n\n#### 上传代码\n\n将 G 代码文件上传到打印机。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\",\n \"gcode\": \"G28\\nG1 X100 Y100 Z10 F3000\\n...\",\n \"print\": true\n}\n```\n\n对于 Bambu 打印机，通过 FTP 上传到`gcodes`目录。无法自动开始打印。\n\n#### 开始打印\n\n开始打印打印机上已有的文件。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"filename\": \"my_print.gcode\"\n}\n```\n\n\\*\\*不推荐用于 Bambu 打印机。\\*\\*请使用`print_3mf`打印 Bambu `.3mf`文件。\n\n#### 取消打印\n\n取消当前打印作业。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\"\n}\n```\n\n对于 Bambu 打印机，通过 MQTT 发送`stop_print`命令。\n\n#### 设置打印机温度\n\n设置打印机组件的温度。\n\n```json\n{\n \"host\": \"192.168.1.100\",\n \"type\": \"octoprint\",\n \"api_key\": \"YOUR_API_KEY\",\n \"component\": \"extruder\",\n \"temperature\": 200\n}\n```\n\n**不支持通过直接 MQTT 命令使用 Bambu 打印机**。\n\n### Bambu 专用工具\n\n#### 打印\\_3mf\n\n通过 FTP 将`.3mf`文件上传到 Bambu 打印机，并通过 MQTT 命令启动打印作业。允许覆盖部分打印参数，例如 AMS 映射。\n\n```json\n{\n \"three_mf_path\": \"/path/to/your_model.3mf\",\n \"host\": \"your_bambu_ip\", // Optional if default is set\n \"bambu_serial\": \"YOUR_SERIAL\", // Optional if default is set\n \"bambu_token\": \"YOUR_TOKEN\", // Optional if default is set\n // Optional Overrides:\n \"use_ams\": true, // Default: true\n \"ams_mapping\": [0, 1, 2, 3], // Array of AMS slot indices to use\n \"bed_leveling\": true, // Default: true\n \"flow_calibration\": false, // Default: false\n \"vibration_calibration\": false, // Default: false\n \"timelapse\": false // Default: false\n}\n```\n\n\\*\\*注意：\\*\\*打印机的 MQTT 命令不支持通过此工具覆盖切片器设置（例如层高或温度）。请在生成`.3mf`文件之前应用这些更改。\n\n## 可用资源\n\n### 打印机资源\n\n* `printer://{host}/status` - 3D 打印机的当前状态（目前仅限于 Bambu）\n* `printer://{host}/files` - 3D 打印机上可用文件的列表（Bambu 的 FTP）\n* `printer://{host}/file/{filename}` - 特定 G 代码文件的内容（仅检查 Bambu 是否存在）\n\n### Bambu 预设资源\n\n如果`BAMBU_STUDIO_CONFIG_PATH`环境变量设置为您的 Bambu Studio 用户设置目录，您可以读取已保存的预设。\n\n* `preset://bambu/machine/{preset_name}` - 读取机器预设文件（例如， `Bambu Lab P1S 0.4 nozzle.json` ）\n* `preset://bambu/filament/{preset_name}` - 读取灯丝预设文件（例如， `Generic PLA.json` ）\n* `preset://bambu/process/{preset_name}` - 读取工艺预设文件（例如， `0.20mm Standard @BBL P1S.json` ）\n\n**使用示例：** “读取我的 Bambu 工艺预设的内容，名为‘0.16mm Optimal @BBL P1S’”（Claude 将使用`preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S`调用 ReadResource ）\n\n## Claude 的示例命令\n\n以下是连接 MCP 服务器后可以向 Claude 发出的一些示例命令：\n\n### 打印机控制\n\n* “我的 3D 打印机目前状态如何？”\n* “显示我的打印机上的文件列表。”\n* “将此 G 代码上传到我的打印机：\\[G 代码内容]”\n* “开始打印名为‘benchy.gcode’的文件。”\n* “取消当前打印作业。”\n* “将挤出机温度设置为 200°C。”\n* “将床温设置为 60°C。”\n\n### STL 操作和打印\n\n* “获取此 STL 文件并将底座延长 2 英寸，然后发送到切片机并在我的打印机中排队。”\n* “将 model.stl 的底部延长 1.5 英寸。”\n* “将此 STL 文件均匀缩放 150%。”\n* “将 model.stl 的宽度缩放至原来的两倍，但高度保持不变。”\n* “将此模型绕 Z 轴旋转 90 度。”\n* “将此 STL 模型向上移动 5 毫米，以在下方形成间隙。”\n* “你能只修改这个模型的顶部，使其增大 20% 吗？”\n* “分析这个 STL 文件并告诉我它的尺寸和细节。”\n* “生成此 STL 文件的可视化效果，以便我可以看到它的样子。”\n* “从不同角度创建我的模型的 SVG 可视化。”\n* “在不改变该模型高度的情况下，将其底座加宽。”\n* “使用 PrusaSlicer 对修改后的 STL 文件进行切片。”\n* “确认 G 代码中的挤出机温度为 200°C，床面温度为 60°C。”\n* “处理这个 STL 文件，将底座加长 2 英寸，切片，然后开始打印，但首先确认温度。”\n* “在 Bambu 打印机上打印`~/Downloads/my_model.3mf` 。”\n* “使用 AMS 插槽 0 和 2 将`~/Desktop/calibration_cube.3mf`上传到 Bambu 打印机，然后关闭床面调平。”\n* “取消我的 Bambu P1S 上的打印作业。”\n* “我的 Bambu 灯丝预设‘通用 PETG’中的设置是什么？”\n* “向我展示我的 Bambu 流程预设。”\n\n## Bambu Lab 打印机的局限性\n\n由于 Bambu Lab 打印机 API 的性质，存在一些限制：\n\n1. **开始打印**：开始打印需要 3MF 项目文件路径、gcode 文件名、打印名称和 MD5 哈希值。此服务器中的简化 API 尚未完全支持此功能。\n\n2. **温度控制**：Bambu API 不提供直接设置温度的方法。这需要自定义 G 代码命令。\n\n3. **文件管理**：必须将文件上传到打印机上的“gcodes”目录。\n\n4. \\*\\*FTP 安全性：\\*\\*文件操作当前使用打印机的 FTP 服务器，该服务器可能不安全（普通 FTP）。\n\n5. \\*\\*参数覆盖：\\*\\*只有 MQTT `project_file`命令支持的参数可以通过`print_3mf`工具覆盖（例如 AMS 使用情况、校准标志）。切片机的设置（例如层高或温度）无法在打印时通过此命令更改。\n\n6. \\*\\*状态更新：\\*\\*通过 MQTT 进行完整的实时状态监控需要进一步实施。\n\n## 限制和注意事项\n\n### 内存使用情况\n\n* **大型 STL 文件**：处理大型或复杂的 STL 文件会消耗大量内存。在操作过程中，整个 STL 几何体都会加载到内存中。\n* **多个操作**：如果垃圾收集跟不上，按顺序运行多个 STL 操作（尤其是在大文件上）可能��导致内存累积。\n* **MCP 环境**：由于本程序以 MCP 服务器形式运行，请注意 Claude 的 MCP 环境存在内存限制。对大型 STL 文件进行复杂操作可能会导致内存不足的问题。\n\n### STL 操作限制\n\n* **截面修改**：特定截面的修改功能最适合用于较简单的几何体。复杂或非流形网格可能会产生意外结果。\n* **底部延伸**：底部延伸算法的工作原理是在模型底部添加新的几何体。对于底部复杂的模型，结果可能并不完美。\n* **错误处理**：虽然我们添加了强大的错误处理功能，但复杂 STL 文件中的一些边缘情况仍然可能导致问题。\n\n### 可视化限制\n\n* **SVG 表示**：SVG 可视化是一种简化的示意图，而不是真正的 3D 渲染。\n* **复杂模型**：对于非常复杂的模型，可视化可能无法准确地表示所有细节。\n\n### 性能考虑\n\n* **切片操作**：外部切片器进程可能占用大量 CPU 资源，并且对于复杂模型可能需要花费相当长的时间。\n* **进度报告**：对于大型文件，进度更新可能会在某些处理阶段出现停滞。\n\n### 测试建议\n\n* 从较小的 STL 文件（<10MB）开始测试功能\n* 处理大文件时监控内存使用情况\n* 在尝试修改复杂几何体之前，先测试简单几何体的修改\n* 对于较大的操作，请考虑在具有至少 4GB 可用 RAM 的系统上运行\n\n## 徽章\n\n| 徽章 | 描述 |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |\n| [![npm 版本](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npm 上软件包的当前版本 |\n| [![许可证：GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) | 该项目采用 GPL-2.0 许可 |\n| [![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/) | 该项目使用 TypeScript 4.9+ 编写 |\n| [![维护](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity) | 该项目正在积极维护 |\n| [![欢迎 PR](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) | 我们欢迎通过 Pull 请求做出贡献 |\n| [![Node.js 版本](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/) | 需要 Node.js 18.0.0 或更高版本 |\n| [![下载](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server) | npm 每月下载次数 |\n| [![GitHub 星标](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social\\&label=Star)](https://github.com/yourusername/mcp-3d-printer-server) | 该项目已收到的 GitHub 星标数量 |\n\n## 执照\n\nGPL-2.0","Chinese","zh-CN","githubUser","locale",{"_83":84,"_13":85,"_94":40,"_95":40,"_16":96,"_97":98,"_31":41,"_124":125,"_132":133,"_134":135,"_218":219,"_224":-5,"_105":195,"_225":199,"_108":226,"_227":228},"addedAt","2025-02-26T23:00:46.135047Z",[86,87,88,89,90,91,92,93],"category:app-automation","category:developer-tools","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","license_grade:a","author:claimed","descriptionMarkdown","descriptionPlainText",1108,"integrations",[99,110,117],{"_100":101,"_29":107,"_108":109},"brand",{"_102":103,"_31":104,"_105":106},"logoSvgPath","M12.662 24V8.959l8.535 3.369V24zm-9.859-.003v-7.521l8.534-3.371-.001 10.892zM2.803 0h8.533l.001 11.672-8.534 3.369zm9.859 0h8.535v10.892l-8.535-3.371z","Bambu Lab","slug","bambulab","Allows Claude to connect with Bambu Lab 3D printers to get printer status, manage files, upload G-code files, and monitor printing through their MQTT and FTP interfaces. Compatible with X1C, P1S, P1P, A1, and other Bambu Lab printers.","uid","zoxctzduyd",{"_100":111,"_29":115,"_108":116},{"_102":112,"_31":113,"_105":114},"m3.215 10.33-1.772.01c-.785.029-1.42.737-1.443 1.613v.088c.018.903.69 1.629 1.51 1.629h1.705c.01 0 .02-.011.02-.024v-.603a.022.022 0 0 0-.02-.022H1.508c-.501 0-.92-.443-.928-1.001-.007-.569.405-1.034.912-1.034l1.723-.007c.01 0 .02-.01.02-.022v-.603c0-.013-.01-.024-.02-.024zm.412 0c-.011 0-.02.011-.02.024v3.292c0 .013.009.024.02.024h.54c.012 0 .02-.011.02-.024V11c0-.012.009-.021.02-.021h1.606c.168 0 .314.145.32.333.006.198-.137.36-.313.36l-1.533.002c-.018 0-.028.023-.016.037l1.75 1.95c.004.005.009.009.014.009H6.8c.017 0 .026-.025.014-.04L5.64 12.32h.183c.496 0 .898-.454.89-1.01-.006-.546-.416-.98-.905-.98h-2.18Zm4.873 0c-.827 0-1.5.75-1.5 1.67 0 .92.673 1.67 1.5 1.67h1.68c.01 0 .02-.011.02-.024v-.603c0-.012-.01-.022-.02-.022H8.5c-.404 0-.75-.292-.871-.697h2.55c.012 0 .02-.01.02-.023v-.604c0-.012-.008-.021-.02-.021h-2.55c.123-.405.468-.697.872-.697h1.68c.01 0 .02-.012.02-.024v-.601c0-.013-.01-.024-.02-.024zm3.709 0c-.013 0-.026.009-.033.024l-1.7 3.28c-.007.016 0 .036.016.036h.625a.02.02 0 0 0 .018-.012l1.056-2.045a.02.02 0 0 1 .036 0l.71 1.375c.008.015-.002.033-.017.033h-.928c-.007 0-.012.005-.015.012l-.313.602c-.008.015.002.033.018.033h2.242c.015 0 .025-.018.017-.033l-1.697-3.281a.041.041 0 0 0-.035-.024zm2.03.002c-.01 0-.02.01-.02.022v2.94c0 .207.15.376.336.376h2.148c.01 0 .022-.011.022-.024v-.603a.022.022 0 0 0-.022-.022H14.82A.022.022 0 0 1 14.8 13v-2.646c0-.013-.01-.022-.02-.022h-.54zm2.84 0c-.01 0-.02.01-.02.022v3.292c0 .013.01.024.02.024h.542c.01 0 .02-.011.02-.024v-3.292c0-.013-.01-.022-.02-.022h-.54zm.85 0c-.01 0-.02.01-.02.022v.601c0 .012.01.024.02.024h1.169c.01 0 .02.009.02.021v2.646c0 .013.01.022.02.022h.54c.01 0 .02-.01.02-.022V11a.02.02 0 0 1 .02-.021h1.172a.02.02 0 0 1 .015.007l1.018 1.354a.02.02 0 0 1 .004.014v1.292c0 .013.008.024.02.024h.54c.011 0 .02-.011.02-.024v-1.292c0-.006.003-.01.006-.014l1.482-1.97c.011-.016.001-.038-.016-.038h-.705a.02.02 0 0 0-.015.008l-1.026 1.363a.02.02 0 0 1-.03 0l-1.026-1.363a.02.02 0 0 0-.016-.008z","Creality","creality","Allows Claude to connect with Creality/Ender 3D printers through the Creality Cloud management system to control and monitor Ender series, CR series, and other Creality printers with network capabilities.","ihdrilocb2",{"_100":118,"_29":122,"_108":123},{"_102":119,"_31":120,"_105":121},"M3.942 4.613C2.424 5.987 1.107 7.473.476 9.71c-.634 2.248-.585 5.094-.145 7.398.44 2.303 1.12 4.107 1.873 5.83h13.179c-.31-.988-.761-1.967-1.446-3.237-.685-1.268-1.658-2.692-2.648-4.178-.99-1.486-1.985-3.077-1.851-4.472.094-.987.49-1.976 1.492-2.76 1.16-.909 2.289-1.437 3.353-1.595 3.325-.496 6.422.601 8.925 3.366.288.316.36.726.545 1.127l.166-.653c.15-.589.088-1.359-.152-2.371-.243-1.029-.563-1.792-1.46-2.973-.893-1.176-2.467-2.322-4.48-3.226-1.5-.673-3.305-1-5.798-.879-2.522.124-5.494 1.177-8.087 3.526Z","OctoPrint","octoprint","Allows Claude to interact with OctoPrint-managed 3D printers to get printer status, list and upload files, start/cancel print jobs, and set temperatures through OctoPrint's REST API.","11ls4lg1wt","namespace",{"_126":127,"_105":131},"owner",{"_128":129},"githubAccount",{"_130":131},"login","DMontgomery40","redditPostExternalId","1nlyxg2","repository",{"_136":137,"_179":180,"_184":185,"_205":-5,"_206":207,"_208":209,"_213":214},"argumentsJsonSchema",{"_138":139,"_176":177,"_143":178},"properties",{"_140":141,"_145":146,"_148":149,"_151":152,"_154":155,"_159":160,"_162":163,"_166":167,"_170":171,"_173":174},"API_KEY",{"_29":142,"_143":144},"API key for authentication with your printer management system","type","string","TEMP_DIR",{"_29":147,"_143":144},"Directory for temporary files (optional)","BAMBU_TOKEN",{"_29":150,"_143":144},"Access token for Bambu Lab printers (required when PRINTER_TYPE is 'bambu')","SLICER_PATH",{"_29":153,"_143":144},"Path to the slicer executable","SLICER_TYPE",{"_156":157,"_29":158,"_143":144},"default","prusaslicer","The type of slicer to use","BAMBU_SERIAL",{"_29":161,"_143":144},"Serial number for Bambu Lab printers (required when PRINTER_TYPE is 'bambu')","PRINTER_HOST",{"_156":164,"_29":165,"_143":144},"localhost","The hostname or IP address of your 3D printer","PRINTER_PORT",{"_156":168,"_29":169,"_143":144},"80","The port used to connect to your 3D printer","PRINTER_TYPE",{"_156":121,"_29":172,"_143":144},"The type of 3D printer management system","SLICER_PROFILE",{"_29":175,"_143":144},"Path to the slicer profile","required",[140],"object","githubProject",{"_33":181,"_182":183},"\n\n# MCP 3D Printer Server\n\n[![npm version](https://img.shields.io/npm/v/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server)\n[![License: GPL-2.0](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)\n[![TypeScript](https://img.shields.io/badge/TypeScript-4.9%2B-blue)](https://www.typescriptlang.org/)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/yourusername/mcp-3d-printer-server/graphs/commit-activity)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D%2018.0.0-green.svg)](https://nodejs.org/en/download/)\n[![Downloads](https://img.shields.io/npm/dm/mcp-3d-printer-server.svg)](https://www.npmjs.com/package/mcp-3d-printer-server)\n[![GitHub stars](https://img.shields.io/github/stars/dmontgomery40/mcp-3d-printer-server.svg?style=social&label=Star)](https://github.com/yourusername/mcp-3d-printer-server)\n\n\n\n $\"3D$ \n\n\n

✨ What's New / Significant Updates (as of last session)

\n\n

🗺️ Roadmap / TODO

\n\n

Click to expand Table of Contents

Click to expand STL Manipulation Tools

\n\n

Click to expand Printer Control Tools

\n\n

Click to expand Bambu-Specific Tools

\n\n## Available Resources\n\n

Click to expand Printer Resources

\n\n

Click to expand Bambu Preset Resources

MCP directory API