3D Printer Manager

by dmontgomery40

199 1.6k downloads Not rated yet GPL-2.0

About

Integrates with multiple 3D printer management systems to enable remote control, file handling, and advanced STL manipulation for automated print job management and custom model modifications.

Details

Repository
DMontgomery40/mcp-3D-printer-server
License
GPL-2.0

Explore

- 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)
- Slice Bambu projects with FULU OrcaSlicer-bambulab (SLICER_TYPE=orcaslicer-bambulab) and auto-slice unsliced 3MF files before Bambu printing when a project slicer is configured
- Inspect and probe the FULU BambuNetwork runtime (check_fulu_orca_setup) and call safe-by-default FULU bridge RPC methods for diagnostics and development (fulu_bambu_network_rpc)
- Read Bambu Studio preset files (printer, filament, process) as resources

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name 3D Printer Manager
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 mcp-3d-printer-server
    Environment
    • BAMBU_MODEL p1s
    • BAMBU_TOKEN your_access_token
    • SLICER_PATH /path/to/FULU/OrcaSlicer
    • SLICER_TYPE orcaslicer-bambulab
    • BAMBU_SERIAL your_printer_serial
    • PRINTER_HOST your_printer_ip
    • PRINTER_TYPE bambu
    • FULU_ORCA_PLUGIN_DIR /Applications/OrcaSlicer.app/Contents/MacOS

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Node.js 18 or higher
- npm or yarn

npm install -g mcp-3d-printer-server
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

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:

    docker-compose up --build -d

ENV SLICER_PATH=/usr/local/bin/orcaslicer

API_KEY=your_api_key_here

BAMBU_SERIAL=your_printer_serial # REQUIRED for Bambu
BAMBU_TOKEN=your_access_token # REQUIRED for Bambu
BAMBU_MODEL=p1s # REQUIRED for Bambu: p1s, p1p, x1c, x1e, a1, a1mini, h2d
BED_TYPE=textured_plate # Bed plate: textured_plate, cool_plate, engineering_plate, hot_plate
NOZZLE_DIAMETER=0.4 # Nozzle diameter in mm (default: 0.4)

BAMBU_STUDIO_CONFIG_PATH=

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

The FULU README currently says macOS is work in progress, but the source tree already ships macOS Lima runtime scripts and Windows WSL runtime scripts. This MCP knows those file layouts and returns the exact commands through check_fulu_orca_setup.

get_stl_info

Get detailed information about an STL file, including dimensions, vertex count, and bounding box. Parameters: stl_path (string)

extend_stl_base

Extend the base of an STL file by a specified amount. Parameters: stl_path (string), extension_inches (number)

scale_stl

Scale an STL model uniformly or along specific axes. Parameters: stl_path (string), scale_factor (number) or scale_x (number), scale_y (number), scale_z (number)

rotate_stl

Rotate an STL model around specific axes (in degrees). Parameters: stl_path (string), rotate_x (number), rotate_y (number), rotate_z (number)

translate_stl

Move an STL model along specific axes (in millimeters). Parameters: stl_path (string), translate_x (number), translate_y (number), translate_z (number)

merge_vertices

Merge vertices that are closer than a specified tolerance. Helps close small gaps and can slightly simplify the mesh. Parameters: stl_path (string), tolerance (optional number, default = 0.01mm)

center_model

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

lay_flat

Attempt to identify the largest flat surface of the model and rotate the model so this face is oriented downwards on the XY plane. Parameters: stl_path (string)

modify_stl_section

Apply a specific transformation to a selected section of an STL file. Parameters: stl_path (string), section (string), transformation_type (string), value_x (number), value_y (number), value_z (number), custom_min_x (number), custom_min_y (number), custom_min_z (number), custom_max_x (number), custom_max_y (number), custom_max_z (number)

generate_stl_visualization

Generate an SVG visualization of an STL file from multiple angles. Parameters: stl_path (string), width (number), height (number)

slice_stl

Slice an STL file to generate G-code. Parameters: stl_path (string), slicer_type (string), slicer_path (string), slicer_profile (string), filament_profile (string)

confirm_temperatures

Confirm temperature settings in a G-code file. Parameters: gcode_path (string), extruder_temp (number), bed_temp (number)

process_and_print_stl

Process an STL file (extend base), slice it, confirm temperatures, and start printing. Parameters: stl_path (string), extension_inches (number), extruder_temp (number), bed_temp (number), host (string), type (string), api_key (string)

get_printer_status

Get the current status of the 3D printer. Parameters: host (string), type (string), api_key (string)

list_printer_files

List files available on the printer. Parameters: host (string), type (string), api_key (string)

upload_gcode

Upload G-code content or a local G-code file path to the printer. Parameters: host (string), type (string), api_key (string), filename (string), gcode (string), print (boolean), gcode_path (string)

start_print

Start printing a file that is already on the printer. Parameters: host (string), type (string), api_key (string), filename (string)

cancel_print

Cancel the current print job. Parameters: host (string), type (string), api_key (string)

set_printer_temperature

Set the temperature of a printer component. Parameters: host (string), type (string), api_key (string), component (string), temperature (number)

check_fulu_orca_setup

Inspects the FULU OrcaSlicer-bambulab executable and setup commands. Parameters: platform (string), slicer_path (string), plugin_dir (string), run_bridge_probe (boolean), bridge_command (string)

fulu_bambu_network_rpc

Calls one FULU BambuNetwork bridge JSON RPC method. Parameters: method (string), bridge_command (string)

print_3mf

Uploads a sliced .3mf file to a Bambu printer via FTP and initiates the print job. Parameters: three_mf_path (string), bambu_model (string), bed_type (string), host (string), bambu_serial (string), bambu_token (string), slicer_type (string), slicer_path (string), use_ams (boolean), ams_mapping (array), bed_leveling (boolean), flow_calibration (boolean), vibration_calibration (boolean), timelapse (boolean)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "3d printer manager": {
            "env": {
                "BAMBU_MODEL": "p1s",
                "BAMBU_TOKEN": "your_access_token",
                "SLICER_PATH": "/path/to/FULU/OrcaSlicer",
                "SLICER_TYPE": "orcaslicer-bambulab",
                "BAMBU_SERIAL": "your_printer_serial",
                "PRINTER_HOST": "your_printer_ip",
                "PRINTER_TYPE": "bambu",
                "FULU_ORCA_PLUGIN_DIR": "/Applications/OrcaSlicer.app/Contents/MacOS"
            },
            "args": [
                "-y",
                "mcp-3d-printer-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "BAMBU_MODEL": "p1s",
        "BAMBU_TOKEN": "your_access_token",
        "SLICER_PATH": "/path/to/FULU/OrcaSlicer",
        "SLICER_TYPE": "orcaslicer-bambulab",
        "BAMBU_SERIAL": "your_printer_serial",
        "PRINTER_HOST": "your_printer_ip",
        "PRINTER_TYPE": "bambu",
        "FULU_ORCA_PLUGIN_DIR": "/Applications/OrcaSlicer.app/Contents/MacOS"
    },
    "args": [
        "-y",
        "mcp-3d-printer-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "BAMBU_MODEL": "p1s",
        "BAMBU_TOKEN": "your_access_token",
        "SLICER_PATH": "/path/to/FULU/OrcaSlicer",
        "SLICER_TYPE": "orcaslicer-bambulab",
        "BAMBU_SERIAL": "your_printer_serial",
        "PRINTER_HOST": "your_printer_ip",
        "PRINTER_TYPE": "bambu",
        "FULU_ORCA_PLUGIN_DIR": "/Applications/OrcaSlicer.app/Contents/MacOS"
    },
    "args": [
        "-y",
        "mcp-3d-printer-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "BAMBU_MODEL": "p1s",
        "BAMBU_TOKEN": "your_access_token",
        "SLICER_PATH": "/path/to/FULU/OrcaSlicer",
        "SLICER_TYPE": "orcaslicer-bambulab",
        "BAMBU_SERIAL": "your_printer_serial",
        "PRINTER_HOST": "your_printer_ip",
        "PRINTER_TYPE": "bambu",
        "FULU_ORCA_PLUGIN_DIR": "/Applications/OrcaSlicer.app/Contents/MacOS"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "mcp-3d-printer-server"
    ],
    "command": "cmd"
}

Thank You To FULU And Louis Rossmann

Thank you to the FULU Foundation and Louis Rossmann for standing up for consumer ownership, open source developers, repair rights, and users who should not have working hardware made worse by locked-down software. This MCP server treats the FULU OrcaSlicer-bambulab fork as a first-class Bambu project slicer target.

MCP 3D Printer Server

npm version
License: GPL-2.0
TypeScript
Maintenance
PRs Welcome
Node.js Version
Downloads
GitHub stars

<a href="https://glama.ai/mcp/servers/7f6v2enbgk">
3D Printer Server MCP server
</a>

<details>
<summary><strong>✨ What's New / Significant Updates (as of last session)</strong></summary>

- Dual Local Transports: Added explicit stdio and streamable-http runtime modes with environment-based transport selection.
- FULU OrcaSlicer-bambulab Support: Added orcaslicer-bambulab / fulu_orca slicer support for Bambu project 3MF export, and made it the default Bambu slicer target when no slicer is configured.
- 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.

</details>

<details>
<summary><strong>🗺️ Roadmap / TODO</strong></summary>

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

</details>

<details>
<summary>Click to expand Table of Contents</summary>

Table of Contents

- Description
- Features
- Installation
- Prerequisites
- Install from npm
- Install from source
- Running with Docker
- Using Slicers with Docker
- Configuration
- Usage
- 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 Safety Notes
- Badges
- License

</details>

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

…

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.