🗺️ Roadmap / TODO

- **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. - **Implement Full Bambu MQTT Status:** Refactor `getStatus` for Bambu to subscribe to MQTT reports and maintain real-time state. - **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. - **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. - **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). - **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`. - **Add Preset Discovery Logic:** Improve preset resource listing (currently lists based on potential filenames, could parse index files if they exist). - **Expand `.3mf` Support:** Add `.3mf` printing support for other printer types where applicable. - **Error Handling & Reporting:** Enhance MQTT error handling and reporting of print progress/completion. - **Testing:** Conduct thorough runtime testing of all new Bambu features.

Click to expand Table of Contents

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

## Description This is a server that allows MCP users to connect with the API endpoints of these 3D Printers: - OctoPrint - Klipper (Moonraker) - Duet - Repetier - Bambu Labs - Prusa Connect - Creality/Ender Thi