3D Printer MCP Server

Connects MCP to major 3D printer APIs (Orca, Bambu, OctoPrint, Klipper, Duet, Repetier, Prusa, Creality). Control prints, monitor status, and perform advanced STL operations like scaling, rotation, sectional editing, and base extension. Includes slicing and visualization.

What is an MCP Server?

Characteristics

Attribute	Details
Image Source	Official Image
Docker Image	mcp/3d-printer
Author	DMontgomery40
Repository	https://github.com/DMontgomery40/mcp-3D-printer-server
Dockerfile	https://github.com/DMontgomery40/mcp-3D-printer-server/blob/main/Dockerfile
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/3d-printer --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	GNU General Public License v2.0

Available Tools

Tools provided by this Server	Short Description
`center_model`	Translate the model so its geometric center is at the origin (0,0,0).
`confirm_temperatures`	Confirm temperature settings in a G-code file
`extend_stl_base`	Extend the base of an STL file by a specified amount
`generate_stl_visualization`	Generate an SVG visualization of an STL file from multiple angles
`get_printer_status`	Get the current status of the 3D printer
`get_stl_info`	Get detailed information about an STL file
`lay_flat`	Attempt to rotate the model so its largest flat face lies on the XY plane (Z=0).
`merge_vertices`	Merge vertices in an STL file that are closer than the specified tolerance.
`modify_stl_section`	Apply a specific transformation to a selected section of an STL file
`print_3mf`	Print a 3MF file on a Bambu Lab printer, potentially overriding settings.
`process_and_print_stl`	Process an STL file (extend base), slice it, confirm temperatures, and start printing
`rotate_stl`	Rotate an STL model around specific axes
`scale_stl`	Scale an STL model uniformly or along specific axes
`slice_stl`	Slice an STL file to generate G-code
`translate_stl`	Move an STL model along specific axes

Tools Details

Tool: `center_model`

Translate the model so its geometric center is at the origin (0,0,0).

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file to center.

Tool: `confirm_temperatures`

Confirm temperature settings in a G-code file

Parameters	Type	Description
`gcode_path`	`string`	Path to the G-code file
`bed_temp`	`number` optional	Expected bed temperature
`extruder_temp`	`number` optional	Expected extruder temperature

Tool: `extend_stl_base`

Extend the base of an STL file by a specified amount

Parameters	Type	Description
`extension_inches`	`number`	Amount to extend the base in inches
`stl_path`	`string`	Path to the STL file to modify

Tool: `generate_stl_visualization`

Generate an SVG visualization of an STL file from multiple angles

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file
`height`	`number` optional	Height of each view in pixels (default: 300)
`width`	`number` optional	Width of each view in pixels (default: 300)

Tool: `get_printer_status`

Get the current status of the 3D printer

Parameters	Type	Description
`api_key`	`string` optional	API key for authentication (default: value from env)
`bambu_serial`	`string` optional	Serial number for Bambu Lab printers (default: value from env)
`bambu_token`	`string` optional	Access token for Bambu Lab printers (default: value from env)
`host`	`string` optional	Hostname or IP address of the printer (default: value from env)
`port`	`string` optional	Port of the printer API (default: value from env)
`type`	`string` optional	Type of printer management system (octoprint, klipper, duet, repetier, bambu, prusa, creality) (default: value from env)

Tool: `get_stl_info`

Get detailed information about an STL file

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file

Tool: `lay_flat`

Attempt to rotate the model so its largest flat face lies on the XY plane (Z=0).

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file to lay flat.

Tool: `merge_vertices`

Merge vertices in an STL file that are closer than the specified tolerance.

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file to modify.
`tolerance`	`number` optional	Maximum distance between vertices to merge (in mm, default: 0.01).

Tool: `modify_stl_section`

Apply a specific transformation to a selected section of an STL file

Parameters	Type	Description
`section`	`string`	Section to modify: 'top', 'bottom', 'center', or custom bounds
`stl_path`	`string`	Path to the STL file
`transformation_type`	`string`	Type of transformation to apply
`custom_max_x`	`number` optional	Maximum X for custom section bounds
`custom_max_y`	`number` optional	Maximum Y for custom section bounds
`custom_max_z`	`number` optional	Maximum Z for custom section bounds
`custom_min_x`	`number` optional	Minimum X for custom section bounds
`custom_min_y`	`number` optional	Minimum Y for custom section bounds
`custom_min_z`	`number` optional	Minimum Z for custom section bounds
`value_x`	`number` optional	Transformation value for X axis
`value_y`	`number` optional	Transformation value for Y axis
`value_z`	`number` optional	Transformation value for Z axis

Tool: `print_3mf`

Print a 3MF file on a Bambu Lab printer, potentially overriding settings.

Parameters	Type	Description
`three_mf_path`	`string`	Path to the 3MF file to print.
`ams_mapping`	`object` optional	Override AMS filament mapping (e.g., {"Generic PLA": 0, "Generic PETG": 1}).
`bambu_serial`	`string` optional	Serial number for the Bambu Lab printer (default: value from env)
`bambu_token`	`string` optional	Access token for the Bambu Lab printer (default: value from env)
`bed_temperature`	`number` optional	Override bed temperature (°C).
`host`	`string` optional	Hostname or IP address of the Bambu printer (default: value from env)
`layer_height`	`number` optional	Override layer height (mm).
`nozzle_temperature`	`number` optional	Override nozzle temperature (°C).
`support_enabled`	`boolean` optional	Override support generation.

Tool: `process_and_print_stl`

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

Parameters	Type	Description
`extension_inches`	`number`	Amount to extend the base in inches
`stl_path`	`string`	Path to the STL file to process
`api_key`	`string` optional	API key for authentication (default: value from env)
`bed_temp`	`number` optional	Expected bed temperature
`extruder_temp`	`number` optional	Expected extruder temperature
`host`	`string` optional	Hostname or IP address of the printer (default: value from env)
`port`	`string` optional	Port of the printer API (default: value from env)
`type`	`string` optional	Type of printer management system (default: value from env)

Tool: `rotate_stl`

Rotate an STL model around specific axes

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file
`rotate_x`	`number` optional	Rotation around X-axis in degrees
`rotate_y`	`number` optional	Rotation around Y-axis in degrees
`rotate_z`	`number` optional	Rotation around Z-axis in degrees

Tool: `scale_stl`

Scale an STL model uniformly or along specific axes

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file
`scale_factor`	`number` optional	Uniform scaling factor to apply
`scale_x`	`number` optional	X-axis scaling factor (overrides scale_factor for X axis)
`scale_y`	`number` optional	Y-axis scaling factor (overrides scale_factor for Y axis)
`scale_z`	`number` optional	Z-axis scaling factor (overrides scale_factor for Z axis)

Tool: `slice_stl`

Slice an STL file to generate G-code

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file to slice
`slicer_path`	`string` optional	Path to the slicer executable (default: value from env)
`slicer_profile`	`string` optional	Profile to use for slicing (default: value from env)
`slicer_type`	`string` optional	Type of slicer to use (prusaslicer, cura, slic3r, orcaslicer) (default: value from env)

Tool: `translate_stl`

Move an STL model along specific axes

Parameters	Type	Description
`stl_path`	`string`	Path to the STL file
`translate_x`	`number` optional	Translation along X-axis in millimeters
`translate_y`	`number` optional	Translation along Y-axis in millimeters
`translate_z`	`number` optional	Translation along Z-axis in millimeters

Use this MCP Server

{
  "mcpServers": {
    "3d-printer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BAMBU_SERIAL",
        "-e",
        "PRINTER_HOST",
        "-e",
        "PRINTER_TYPE",
        "-e",
        "BAMBU_TOKEN",
        "mcp/3d-printer"
      ],
      "env": {
        "BAMBU_SERIAL": "YOUR_BAMBU_SERIAL",
        "PRINTER_HOST": "REAL",
        "PRINTER_TYPE": "bambu",
        "BAMBU_TOKEN": "YOUR_BAMBU_TOKEN"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

3D Printer MCP Server

Characteristics

Available Tools

Tools Details

Tool: center_model

Tool: confirm_temperatures

Tool: extend_stl_base

Tool: generate_stl_visualization

Tool: get_printer_status

Tool: get_stl_info

Tool: lay_flat

Tool: merge_vertices

Tool: modify_stl_section

Tool: print_3mf

Tool: process_and_print_stl

Tool: rotate_stl

Tool: scale_stl

Tool: slice_stl

Tool: translate_stl

Use this MCP Server

Tool: `center_model`

Tool: `confirm_temperatures`

Tool: `extend_stl_base`

Tool: `generate_stl_visualization`

Tool: `get_printer_status`

Tool: `get_stl_info`

Tool: `lay_flat`

Tool: `merge_vertices`

Tool: `modify_stl_section`

Tool: `print_3mf`

Tool: `process_and_print_stl`

Tool: `rotate_stl`

Tool: `scale_stl`

Tool: `slice_stl`

Tool: `translate_stl`