Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 TrackMCP. All rights reserved.

Built with ❤️ by Krishna Goyal

    Mcp 3d Printer Server

    Connects MCP to major 3D printer APIs (Orca, Bambu, OctoPrint, Klipper, Duet, Repetier, Prusa, Creality).

    106 stars
    TypeScript
    Updated Oct 15, 2025
    3d-printing
    3mf
    bambu-lab
    bambu-studio
    duet
    g-code
    klipper
    mcp
    mcp-orca-slicer
    mcp-server
    mcp-stl-3mf
    modelcontextprotocol
    moonraker
    octoprint
    orca-slicer
    repetier
    repetier-server
    stl-files
    three-js
    threejs

    Table of Contents

    • Table of Contents
    • Description
    • Features
    • Installation
    • Prerequisites
    • Install from npm
    • Install from source
    • Running with Docker
    • Using Slicers with Docker
    • Configuration
    • Usage with Claude Desktop
    • Supported Printer Management Systems
    • OctoPrint
    • Klipper (via Moonraker)
    • Duet
    • Repetier
    • Bambu Labs
    • Finding Your Bambu Printer's Serial Number and Access Token
    • Bambu Communication Notes (MQTT & FTP)
    • Prusa Connect
    • Setting up Prusa Connect
    • Creality Cloud
    • Setting up Creality Cloud
    • Available Tools
    • STL Manipulation Tools
    • get_stl_info
    • extend_stl_base
    • scale_stl
    • rotate_stl
    • translate_stl
    • merge_vertices
    • center_model
    • lay_flat
    • modify_stl_section
    • generate_stl_visualization
    • slice_stl
    • confirm_temperatures
    • process_and_print_stl
    • Printer Control Tools
    • get_printer_status
    • list_printer_files
    • upload_gcode
    • start_print
    • cancel_print
    • set_printer_temperature
    • Bambu-Specific Tools
    • print_3mf
    • Available Resources
    • Printer Resources
    • Bambu Preset Resources
    • Example Commands for Claude
    • Printer Control
    • STL Manipulation and Printing
    • Bambu Lab Printer Limitations
    • Limitations and Considerations
    • Memory Usage
    • STL Manipulation Limitations
    • Visualization Limitations
    • Performance Considerations
    • Testing Recommendations
    • Appendix: MCP in Practice (Code Execution, Scale, and Safety)
    • State of MCP Right Now
    • Why Code Mode / Code Execution Has Become Important
    • Setup Guidance for Users
    • Peter Steinberger Workflow Pattern
    • What Works Best With Which Clients
    • Prompt Injection: Risks, Consequences, and Mitigations
    • Badges
    • License

    Table of Contents

    • Table of Contents
    • Description
    • Features
    • Installation
    • Prerequisites
    • Install from npm
    • Install from source
    • Running with Docker
    • Using Slicers with Docker
    • Configuration
    • Usage with Claude Desktop
    • Supported Printer Management Systems
    • OctoPrint
    • Klipper (via Moonraker)
    • Duet
    • Repetier
    • Bambu Labs
    • Finding Your Bambu Printer's Serial Number and Access Token
    • Bambu Communication Notes (MQTT & FTP)
    • Prusa Connect
    • Setting up Prusa Connect
    • Creality Cloud
    • Setting up Creality Cloud
    • Available Tools
    • STL Manipulation Tools
    • get_stl_info
    • extend_stl_base
    • scale_stl
    • rotate_stl
    • translate_stl
    • merge_vertices
    • center_model
    • lay_flat
    • modify_stl_section
    • generate_stl_visualization
    • slice_stl
    • confirm_temperatures
    • process_and_print_stl
    • Printer Control Tools
    • get_printer_status
    • list_printer_files
    • upload_gcode
    • start_print
    • cancel_print
    • set_printer_temperature
    • Bambu-Specific Tools
    • print_3mf
    • Available Resources
    • Printer Resources
    • Bambu Preset Resources
    • Example Commands for Claude
    • Printer Control
    • STL Manipulation and Printing
    • Bambu Lab Printer Limitations
    • Limitations and Considerations
    • Memory Usage
    • STL Manipulation Limitations
    • Visualization Limitations
    • Performance Considerations
    • Testing Recommendations
    • Appendix: MCP in Practice (Code Execution, Scale, and Safety)
    • State of MCP Right Now
    • Why Code Mode / Code Execution Has Become Important
    • Setup Guidance for Users
    • Peter Steinberger Workflow Pattern
    • What Works Best With Which Clients
    • Prompt Injection: Risks, Consequences, and Mitigations
    • Badges
    • License

    Documentation

    MCP 3D Printer Server

    npm version

    License: GPL-2.0

    TypeScript

    Maintenance

    PRs Welcome

    Node.js Version

    Downloads

    GitHub stars

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

    • Dual Local Transports: Added explicit stdio and streamable-http runtime modes with environment-based transport selection.
    • Bambu Reliability Pass: Fixed Bambu argument wiring bugs, added FTP-backed file operations, improved status refresh behavior, and implemented practical command paths for startJob, setTemperature, and print_3mf.
    • Blender Bridge Tooling: Added blender_mcp_edit_model with optional execution mode for model-edit collaboration workflows.
    • Transport Behavior Tests: Added real behavior tests for both transports (initialize, tools/list, success + failing tools/call, origin rejection).
    • Docker Modernization: Updated Docker build flow to work without BuildKit-specific features and verified streamable HTTP initialization in container smoke testing.

    🗺️ 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
    • Features
    • Installation
    • Prerequisites
    • Install from npm
    • Install from source
    • Running with Docker
    • Using Slicers with Docker
    • Configuration
    • Usage with Claude Desktop
    • Supported Printer Management Systems
    • OctoPrint
    • Klipper (via Moonraker)
    • Duet
    • Repetier
    • Bambu Labs
    • Finding Your Bambu Printer's Serial Number and Access Token
    • Bambu Communication Notes (MQTT & FTP)
    • Prusa Connect
    • Setting up Prusa Connect
    • Creality Cloud
    • Setting up Creality Cloud
    • Available Tools
    • STL Manipulation Tools
    • Printer Control Tools
    • Bambu-Specific Tools
    • Available Resources
    • Printer Resources
    • Bambu Preset Resources
    • Example Commands for LLM
    • Bambu Lab Printer Limitations
    • Limitations and Considerations
    • Memory Usage
    • STL Manipulation Limitations
    • Visualization Limitations
    • Performance Considerations
    • Testing Recommendations
    • Appendix: MCP in Practice (Code Execution, Scale, and Safety)
    • Badges
    • 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

    This 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.

    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.

    Features

    • Get printer status (temperatures, print progress, etc.)
    • List files on the printer
    • Upload G-code files to the printer
    • Start, cancel, and monitor print jobs
    • Set printer temperatures
    • Advanced STL file manipulation:
    • Extend base for better adhesion
    • Scale models uniformly or along specific axes
    • Rotate models around any axis
    • Translate (move) models
    • Modify specific sections of STL files (top, bottom, center, or custom)
    • Comprehensive STL analysis with detailed model information
    • Generate multi-angle SVG visualizations of STL files
    • Real-time progress reporting for long operations
    • Error handling with detailed diagnostics
    • Slice STL files to generate G-code
    • Confirm temperature settings in G-code files
    • Complete end-to-end workflow from STL modification to printing
    • Print .3mf files directly on Bambu Lab printers (via MQTT command)
    • Read Bambu Studio preset files (printer, filament, process) as resources

    Installation

    Prerequisites

    • Node.js 18 or higher
    • npm or yarn

    Install from npm

    bash
    npm install -g mcp-3d-printer-server

    Install from source

    bash
    git clone https://github.com/dmontgomery40/mcp-3d-printer-server.git
    cd mcp-3d-printer-server
    npm install
    npm link  # Makes the command available globally

    Running with Docker

    You can also run the server using Docker and Docker Compose for a containerized environment.

    1. Ensure you have Docker and Docker Compose installed.

    2. Copy .env.example to .env and configure your settings.

    3. Build and run the container:

    bash
    docker-compose up --build -d

    Using Slicers with Docker

    Please 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.

    The recommended approach is to **install your preferred slicer *inside* the Docker image**. This makes the container self-sufficient.

    To 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):

    dockerfile
    # ... other Dockerfile commands ...
    
    # Example: Install PrusaSlicer or OrcaSlicer (adjust command as needed)
    # Check Alpine package repositories first (e.g., apk add prusaslicer or apk add orcaslicer)
    # If not available, download and install manually (e.g., AppImage):
    # RUN apk add --no-cache fuse # FUSE might be needed for AppImages
    # RUN wget https://example.com/path/to/OrcaSlicer_Linux_Vxxxx.AppImage -O /usr/local/bin/orcaslicer && \
    #     chmod +x /usr/local/bin/orcaslicer
    
    # Set the SLICER_PATH env var accordingly in docker-compose.yml or when running
    # Example for installed executable:
    ENV SLICER_PATH=/usr/local/bin/orcaslicer 
    
    # ... rest of Dockerfile ...

    After 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.

    Apologies 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.

    Configuration

    Create a .env file in the directory where you'll run the server or set environment variables:

    env
    # Required for authentication with your printer management system
    API_KEY=your_api_key_here
    
    # Default printer connection settings
    PRINTER_HOST=localhost
    PRINTER_PORT=80 # Port for non-Bambu HTTP APIs
    PRINTER_TYPE=octoprint  # Options: octoprint, klipper, duet, repetier, bambu, prusa, creality
    
    # Optional: Directory for temporary files
    TEMP_DIR=/path/to/temp/dir
    
    # Bambu Labs specific configuration
    BAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu
    BAMBU_TOKEN=your_access_token    # REQUIRED for Bambu
    
    # Slicer configuration (for slice_stl tool)
    SLICER_TYPE=prusaslicer  # Options: prusaslicer, cura, slic3r, orcaslicer
    SLICER_PATH=/path/to/slicer/executable
    SLICER_PROFILE=/path/to/slicer/profile
    
    # Optional: Path to Bambu Studio user config dir (for loading presets)
    # Example macOS: /Users/your_user/Library/Application Support/BambuStudio/user/YOUR_USER_ID
    # Example Windows: C:\Users\your_user\AppData\Roaming\BambuStudio\user\YOUR_USER_ID
    # Example Linux: /home/your_user/.config/BambuStudio/user/YOUR_USER_ID
    BAMBU_STUDIO_CONFIG_PATH=
    
    # MCP transport configuration
    MCP_TRANSPORT=stdio             # Options: stdio, streamable-http
    MCP_HTTP_HOST=127.0.0.1
    MCP_HTTP_PORT=3000
    MCP_HTTP_PATH=/mcp
    MCP_HTTP_STATEFUL=true
    MCP_HTTP_JSON_RESPONSE=true
    MCP_HTTP_ALLOWED_ORIGINS=http://localhost
    
    # Optional bridge command for blender_mcp_edit_model execute=true mode
    BLENDER_MCP_BRIDGE_COMMAND=

    Usage with Claude Desktop

    1. Edit your Claude Desktop configuration file:

    json
    {
      "mcpServers": {
        "3dprint": {
          "command": "mcp-3d-printer-server",
          "env": {
            "API_KEY": "your_api_key_here",
            "PRINTER_HOST": "your_printer_ip",
            "PRINTER_TYPE": "octoprint"
          }
        }
      }
    }

    2. For Bambu Labs printers:

    json
    {
      "mcpServers": {
        "3dprint": {
          "command": "mcp-3d-printer-server",
          "env": {
            "PRINTER_HOST": "your_printer_ip",
            "PRINTER_TYPE": "bambu",
            "BAMBU_SERIAL": "your_printer_serial",
            "BAMBU_TOKEN": "your_access_token"
          }
        }
      }
    }

    3. Restart Claude Desktop

    4. Connect to your printer through Claude

    Supported Printer Management Systems

    OctoPrint

    OctoPrint is a popular web interface for 3D printers. It provides a REST API for controlling the printer.

    • Default port: 80 (http) or 443 (https)
    • Authentication: API key required

    Klipper (via Moonraker)

    Klipper is a firmware for 3D printers that works with the Moonraker API server.

    • Default port: 7125
    • Authentication: Depends on your Moonraker configuration

    Duet

    Duet is a control board for 3D printers with its own web interface (DuetWebControl).

    • Default port: 80 (http) or 443 (https)
    • Authentication: Depends on your Duet configuration

    Repetier

    Repetier-Server is a host software for 3D printers.

    • Default port: 3344
    • Authentication: API key required

    Bambu Labs

    Bambu Lab printers use MQTT for status and control and FTP for file operations.

    • Authentication: Serial number and access token required (set BAMBU_SERIAL and BAMBU_TOKEN)
    • Requirements: Printer must be on the same network or have cloud connection enabled
    • Compatible with: X1C, P1S, P1P, A1, and other Bambu Lab printers

    Finding Your Bambu Printer's Serial Number and Access Token

    To connect to your Bambu Lab printer, you need two things:

    1. Printer Serial Number:

    • 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)
    • Alternatively, open Bambu Studio, connect to your printer, go to Device > Device Management, and view your printer's information

    2. Access Token:

    • The access token is a security code needed to connect directly to your printer
    • For P1 Series printers: Go to the touchscreen, select Settings > Network > LAN Mode, and you'll see the access code
    • For X1 Series printers: Go to the touchscreen, select Settings > Network > LAN Mode, and enable LAN Mode to see the access code
    • For A1 Mini: Use the Bambu Handy app to connect to your printer, then go to Settings > Network > LAN Mode

    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.

    Bambu Communication Notes (MQTT & FTP)

    • MQTT: This server uses the local MQTT protocol (port 8883, TLS) based on community findings (e.g., OpenBambuAPI) to send commands like starting prints and cancelling jobs.
    • 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.

    Prusa Connect

    Prusa Connect is Prusa's own cloud-based solution for managing their printers.

    • Default port: 80 (http) or 443 (https)
    • Authentication: API key required
    • Compatible with: Prusa MK4, Prusa Mini, Prusa XL, and other Prusa printers with Prusa Connect

    Setting up Prusa Connect

    1. Make sure your Prusa printer is updated to the latest firmware

    2. Connect your printer to your Wi-Fi network

    3. Create a Prusa Connect account and register your printer

    4. Generate an API key from the Prusa Connect web interface under Settings > API Access

    Creality Cloud

    Creality Cloud is Creality's management system for their printers.

    • Default port: 80 (http) or 443 (https)
    • Authentication: Bearer token required
    • Compatible with: Ender series, CR series, and other Creality printers with network capabilities

    Setting up Creality Cloud

    1. Install the Creality Cloud app on your mobile device

    2. Create an account and add your printer

    3. Enable local network access for your printer

    4. Generate a token from the Creality Cloud app under Settings > Developer Options

    Available Tools

    Click to expand STL Manipulation Tools

    STL Manipulation Tools

    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.

    get_stl_info

    Get detailed information about an STL file, including dimensions, vertex count, and bounding box.

    json
    {
      "stl_path": "/path/to/file.stl"
    }

    extend_stl_base

    Extend the base of an STL file by a specified amount.

    json
    {
      "stl_path": "/path/to/file.stl",
      "extension_inches": 2
    }

    scale_stl

    Scale an STL model uniformly or along specific axes.

    json
    {
      "stl_path": "/path/to/file.stl",
      "scale_factor": 1.5
    }

    Or for non-uniform scaling:

    json
    {
      "stl_path": "/path/to/file.stl",
      "scale_x": 1.2,
      "scale_y": 1.0,
      "scale_z": 1.5
    }

    rotate_stl

    Rotate an STL model around specific axes (in degrees).

    json
    {
      "stl_path": "/path/to/file.stl",
      "rotate_x": 45,
      "rotate_y": 0,
      "rotate_z": 90
    }

    translate_stl

    Move an STL model along specific axes (in millimeters).

    json
    {
      "stl_path": "/path/to/file.stl",
      "translate_x": 10,
      "translate_y": 5,
      "translate_z": 0
    }

    merge_vertices

    Merge vertices that are closer than a specified tolerance. Helps close small gaps and can slightly simplify the mesh.

    json
    {
      "stl_path": "/path/to/model.stl",
      "tolerance": 0.01 // Optional, default = 0.01mm
    }

    center_model

    Translate the model so the center of its bounding box is at the world origin (0,0,0).

    json
    {
      "stl_path": "/path/to/model.stl"
    }

    lay_flat

    Attempt 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.

    json
    {
      "stl_path": "/path/to/model.stl"
    }

    modify_stl_section

    Apply a specific transformation to a selected section of an STL file. This allows for detailed modifications of specific parts of a model.

    json
    {
      "stl_path": "/path/to/file.stl",
      "section": "top",
      "transformation_type": "scale",
      "value_x": 1.5,
      "value_y": 1.5, 
      "value_z": 1.5
    }

    For custom section bounds:

    json
    {
      "stl_path": "/path/to/file.stl",
      "section": "custom",
      "transformation_type": "rotate",
      "value_x": 0,
      "value_y": 0, 
      "value_z": 45,
      "custom_min_x": -10,
      "custom_min_y": 0,
      "custom_min_z": -10,
      "custom_max_x": 10,
      "custom_max_y": 20,
      "custom_max_z": 10
    }

    generate_stl_visualization

    Generate an SVG visualization of an STL file from multiple angles (front, side, top, and isometric views).

    json
    {
      "stl_path": "/path/to/file.stl",
      "width": 400,
      "height": 400
    }

    slice_stl

    Slice an STL file to generate G-code.

    json
    {
      "stl_path": "/path/to/file.stl",
      "slicer_type": "prusaslicer",
      "slicer_path": "/path/to/prusaslicer",
      "slicer_profile": "/path/to/profile.ini"
    }

    confirm_temperatures

    Confirm temperature settings in a G-code file.

    json
    {
      "gcode_path": "/path/to/file.gcode",
      "extruder_temp": 200,
      "bed_temp": 60
    }

    process_and_print_stl

    Process an STL file (extend base), slice it, confirm temperatures, and start printing.

    json
    {
      "stl_path": "/path/to/file.stl",
      "extension_inches": 2,
      "extruder_temp": 200,
      "bed_temp": 60,
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY"
    }

    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.

    Click to expand Printer Control Tools

    Printer Control Tools

    get_printer_status

    Get the current status of the 3D printer.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY"
    }

    For Bambu printers, this currently only confirms MQTT connection.

    list_printer_files

    List files available on the printer.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY"
    }

    For Bambu printers, lists files in the gcodes directory via FTP.

    upload_gcode

    Upload a G-code file to the printer.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY",
      "filename": "my_print.gcode",
      "gcode": "G28\nG1 X100 Y100 Z10 F3000\n...",
      "print": true
    }

    For Bambu printers, uploads to the gcodes directory via FTP. Cannot start print automatically.

    start_print

    Start printing a file that is already on the printer.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY",
      "filename": "my_print.gcode"
    }

    Not recommended for Bambu printers. Use print_3mf for Bambu .3mf files.

    cancel_print

    Cancel the current print job.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY"
    }

    For Bambu printers, sends the stop_print command via MQTT.

    set_printer_temperature

    Set the temperature of a printer component.

    json
    {
      "host": "192.168.1.100",
      "type": "octoprint",
      "api_key": "YOUR_API_KEY",
      "component": "extruder",
      "temperature": 200
    }

    Not supported for Bambu printers via direct MQTT commands.

    Click to expand Bambu-Specific Tools

    Bambu-Specific Tools

    print_3mf

    Uploads 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.

    json
    {
      "three_mf_path": "/path/to/your_model.3mf",
      "host": "your_bambu_ip", // Optional if default is set
      "bambu_serial": "YOUR_SERIAL", // Optional if default is set
      "bambu_token": "YOUR_TOKEN", // Optional if default is set
      // Optional Overrides:
      "use_ams": true, // Default: true
      "ams_mapping": [0, 1, 2, 3], // Array of AMS slot indices to use
      "bed_leveling": true, // Default: true
      "flow_calibration": false, // Default: false
      "vibration_calibration": false, // Default: false
      "timelapse": false // Default: false
    }

    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.

    Available Resources

    Click to expand Printer Resources

    Printer Resources

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

    Click to expand Bambu Preset Resources

    Bambu Preset Resources

    If the BAMBU_STUDIO_CONFIG_PATH environment variable is set to your Bambu Studio user settings directory, you can read your saved presets.

    • preset://bambu/machine/{preset_name} - Reads a machine preset file (e.g., Bambu Lab P1S 0.4 nozzle.json)
    • preset://bambu/filament/{preset_name} - Reads a filament preset file (e.g., Generic PLA.json)
    • preset://bambu/process/{preset_name} - Reads a process preset file (e.g., 0.20mm Standard @BBL P1S.json)

    Example Usage:

    "Read the content of my Bambu process preset named '0.16mm Optimal @BBL P1S'"

    (Claude would call ReadResource with preset://bambu/process/0.16mm%20Optimal%20%40BBL%20P1S)

    Example Commands for Claude

    Here are some example commands you can give to Claude after connecting the MCP server:

    Printer Control

    • "What's the current status of my 3D printer?"
    • "Show me the list of files on my printer."
    • "Upload this G-code to my printer: [G-code content]"
    • "Start printing the file named 'benchy.gcode'."
    • "Cancel the current print job."
    • "Set the extruder temperature to 200°C."
    • "Set the bed temperature to 60°C."

    STL Manipulation and Printing

    • "Take this STL file and extend the base by 2 inches, then send to slicer and queue up in my printer."
    • "Extend the base of model.stl by 1.5 inches."
    • "Scale this STL file by 150% uniformly."
    • "Scale model.stl to be twice as wide but keep the same height."
    • "Rotate this model 90 degrees around the Z axis."
    • "Move this STL model up by 5mm to create a gap underneath."
    • "Can you modify just the top part of this model to make it 20% larger?"
    • "Analyze this STL file and tell me its dimensions and details."
    • "Generate a visualization of this STL file so I can see what it looks like."
    • "Create SVG visualizations of my model from different angles."
    • "Make the base of this model wider without changing its height."
    • "Slice the modified STL file using PrusaSlicer."
    • "Confirm that the temperatures in the G-code are 200°C for the extruder and 60°C for the bed."
    • "Process this STL file, make the base 2 inches longer, slice it, and start printing, but confirm the temperatures first."
    • "Print ~/Downloads/my_model.3mf on the Bambu printer."
    • "Upload ~/Desktop/calibration_cube.3mf to the Bambu printer using AMS slots 0 and 2, and turn off bed leveling."
    • "Cancel the print job on my Bambu P1S."
    • "What are the settings in my Bambu filament preset 'Generic PETG'?"
    • "Show me my Bambu process presets."

    Bambu Lab Printer Limitations

    Due to the nature of the Bambu Lab printer API, there are some limitations:

    1. Printable 3MF requirement: print_3mf requires a sliced 3MF that includes at least one Metadata/plate_.gcode entry so the server can compute MD5 and start the job correctly.

    2. AMS behavior caveat: The current bambu-js project-file command path always sends use_ams=true; passing use_ams=false is treated as best-effort and surfaced with a warning.

    3. Temperature control path: Temperature updates are implemented through G-code command dispatch (M104/M140) over MQTT, so effective behavior still depends on printer firmware acceptance and current printer state.

    4. File transfer channel: File operations use Bambu's FTPS path (port 990) via bambu-js. This is more secure than plain FTP, but still assumes a trusted local network environment and library-managed TLS behavior.

    5. Direct start path scope: startJob currently targets .gcode files on printer storage; .3mf jobs should be initiated through print_3mf so metadata and plate selection are handled.

    6. Status consistency: Status reads force a pushall refresh when possible, but complete real-time, event-stream status semantics across all Bambu models still need deeper hardening.

    Limitations and Considerations

    Memory Usage

    • Large STL Files: Processing large or complex STL files can consume significant memory. The entire STL geometry is loaded into memory during operations.
    • Multiple Operations: Running multiple STL operations in sequence (especially on large files) may cause memory to accumulate if garbage collection doesn't keep up.
    • 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.

    STL Manipulation Limitations

    • Section Modification: The section-specific modification feature works best on simpler geometries. Complex or non-manifold meshes may produce unexpected results.
    • 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.
    • Error Handling: While we've added robust error handling, some edge cases in complex STL files might still cause issues.

    Visualization Limitations

    • SVG Representation: The SVG visualization is a simplified schematic representation, not a true 3D render.
    • Complex Models: For very complex models, the visualization may not accurately represent all details.

    Performance Considerations

    • Slicing Operations: External slicer processes can be CPU-intensive and may take considerable time for complex models.
    • Progress Reporting: For large files, progress updates may appear to stall at certain processing stages.

    Testing Recommendations

    • Start with smaller STL files (< 10MB) to test functionality
    • Monitor memory usage when processing large files
    • Test modifications on simple geometries before attempting complex ones
    • Consider running on a system with at least 4GB of available RAM for larger operations

    Appendix: MCP in Practice (Code Execution, Scale, and Safety)

    Last updated: 2026-02-24

    State of MCP Right Now

    MCP remains a high-value protocol for interoperability, but large tool surfaces have a real downside: tool schemas, retries, and tool-call traces can flood the context window. More tools often means more token overhead unless the execution model is disciplined.

    Why Code Mode / Code Execution Has Become Important

    Recent production workflows increasingly move orchestration out of conversational turns and into executable code loops. This keeps context leaner, makes behavior easier to audit, and improves reproducibility.

    Core reading:

    • Cloudflare: https://blog.cloudflare.com/code-mode/
    • Cloudflare: https://blog.cloudflare.com/code-execution-with-mcp/
    • Anthropic: https://www.anthropic.com/engineering/code-execution-with-mcp

    Setup Guidance for Users

    For practical day-to-day use, start with a codemode-oriented gateway and keep direct tool exposure narrow:

    • codemode-mcp: https://github.com/jx-codes/codemode-mcp
    • UTCP routing guidance: https://www.utcp.io

    Even with strong setup, model/tool usage can still be inconsistent across client versions and model releases, so retries and deterministic fallbacks are still required.

    Peter Steinberger Workflow Pattern

    A high-signal pattern is converting broad MCP toolsets into targeted CLIs so the model calls fewer, better-defined commands:

    • MCPorter: https://github.com/steipete/mcporter
    • OpenClaw: https://github.com/steipete/openclaw

    What Works Best With Which Clients

    • Claude Code, Codex CLI, and Cursor agent modes: strong fit for direct MCP and code-execution workflows.
    • Thin hosted chat clients: usually better when MCP servers are wrapped behind narrower CLIs/gateways.
    • Large multi-tool servers: best when grouped into task-specific wrappers instead of exposing every tool directly.

    This ecosystem changes quickly; if you are reading this later, parts of this section may already be stale.

    Prompt Injection: Risks, Consequences, and Mitigations

    Prompt injection is still an open problem for tool-using agents. It is manageable, but not solved.

    Primary risks:

    • Hidden malicious instructions in remote content or tool output.
    • Secret exfiltration via unintended network/tool calls.
    • Unauthorized state changes (filesystem, infrastructure, or printer actions).

    Practical mitigations:

    • Least-privilege credentials and short-lived tokens.
    • Strict schema validation and explicit allowlists for actions/hosts.
    • Human confirmation gates for destructive operations.
    • Execution sandboxing with resource/time limits.
    • Structured logs and replayable runs for incident response.

    Treat tool output as untrusted input by default.

    Badges

    BadgeDescription
    npm versionThe current version of the package on npm
    License: GPL-2.0This project is licensed under GPL-2.0
    TypeScriptThis project is written in TypeScript 4.9+
    MaintenanceThis project is actively maintained
    PRs WelcomeWe welcome contributions via Pull Requests
    Node.js VersionRequires Node.js 18.0.0 or higher
    DownloadsNumber of downloads per month from npm
    GitHub starsNumber of GitHub stars this project has received

    License

    GPL-2.0

    Similar MCP

    Based on tags & features

    • MC

      Mcp Open Library

      TypeScript·
      42
    • FH

      Fhir Mcp Server

      Python·
      55
    • MC

      Mcp Ipfs

      TypeScript·
      11
    • AW

      Aws Mcp Server

      Python·
      165

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • MC

      Mcp Open Library

      TypeScript·
      42
    • FH

      Fhir Mcp Server

      Python·
      55
    • MC

      Mcp Ipfs

      TypeScript·
      11
    • AW

      Aws Mcp Server

      Python·
      165

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k