Bambu Printer MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bambu Printer MCP check status of all printers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bambu Printer MCP
A privacy-conscious Model Context Protocol server for managing, monitoring, slicing for, and controlling multiple Bambu Lab 3D printers.
This project is an independent GPL-2.0 continuation of DMontgomery40/bambu-printer-mcp. It keeps the original printer, AMS, 3MF, camera, and slicing capabilities while adding a named multi-printer registry, fleet status, reconnect management, per-printer operation serialization, credential references, and stronger privacy defaults.
It is community software and is not affiliated with or endorsed by Bambu Lab.
Highlights
Named profiles for multiple printers
Explicit printer targeting with safe default selection
Redacted fleet status with bounded parallel queries
Per-printer serialization across reads, commands, reconnects, and profile changes
Runtime-only access tokens or environment-variable references
Atomic
0600registry files and0700config directoriesMQTT printer status and control
FTPS upload, listing, and guarded deletion
AMS inventory, matching, RFID reread, and supported dryer controls
Camera snapshots for supported printer families
Bambu Studio and compatible Orca-family slicing workflows
H2-family 3MF routing and crash-resistant dependency patching
Stdio and loopback-only Streamable HTTP MCP transports
Related MCP server: OrcaSlicer MCP
Safety model
This server can move hardware, heat components, upload files, and start or stop prints. The following rules are intentional:
A verified printer model is required for print operations.
Physical commands target one named printer at a time.
allis limited to fleet status and explicitly confirmed reconnect operations.File deletion requires
confirm:trueand is restricted to printer-managed directories.Persisted printer profiles may reference identifiers and secrets, but may not contain plaintext serial numbers, device IDs, or access tokens.
Streamable HTTP is restricted to loopback because the server does not provide remote authentication.
Always check the build plate, nozzle, filament, AMS mapping, and selected printer before starting a job.
Requirements
Node.js 20 or newer
A supported Bambu Lab printer reachable on the same trusted LAN
LAN Only or Developer Mode as required by the printer firmware
Bambu Studio only when using local slicing tools
ffmpegonly when using RTSP-based camera snapshots
Supported model identifiers:
p1s, p1p, p2s, x1c, x1e, a1, a1mini, h2d, h2s, h2c
Install
This is a public GitHub project, but it is intentionally not published to npm. Install from the audited source tree so its dependency overrides and Bambu compatibility patch are applied exactly as tested.
git clone https://github.com/ceweldy/bambu-printer-mcp.git
cd bambu-printer-mcp
npm ci
npm testRun the MCP server over stdio:
npm startMulti-printer configuration
The default registry path is:
~/.config/bambu-printer-mcp/printers.jsonThe registry stores only nonsecret metadata and environment-variable names. Create it with private permissions:
mkdir -p ~/.config/bambu-printer-mcp
chmod 700 ~/.config/bambu-printer-mcpExample registry:
{
"version": 1,
"defaultPrinter": "shop-p1s",
"printers": [
{
"id": "shop-p1s",
"name": "Shop P1S",
"host": "printer-one.local",
"model": "p1s",
"serialEnv": "BAMBU_SHOP_P1S_SERIAL",
"accessTokenEnv": "BAMBU_SHOP_P1S_TOKEN",
"devIdEnv": "BAMBU_SHOP_P1S_DEVICE_ID",
"bedType": "textured_plate",
"nozzleDiameter": "0.4"
},
{
"id": "engineering-x1c",
"name": "Engineering X1C",
"host": "printer-two.local",
"model": "x1c",
"serialEnv": "BAMBU_ENGINEERING_X1C_SERIAL",
"accessTokenEnv": "BAMBU_ENGINEERING_X1C_TOKEN",
"devIdEnv": "BAMBU_ENGINEERING_X1C_DEVICE_ID",
"bedType": "engineering_plate",
"nozzleDiameter": "0.4"
}
]
}Then set the referenced values in the private environment used to launch the MCP server. Do not commit them to this repository.
You may select a different registry path with BAMBU_PRINTERS_FILE. BAMBU_PRINTERS_JSON is also supported for clients that inject a complete private configuration through the process environment.
Backward-compatible single-printer environment
The original environment variables still work:
PRINTER_HOST
BAMBU_SERIAL
BAMBU_TOKEN
BAMBU_MODEL
BED_TYPE
NOZZLE_DIAMETERMulti-printer configuration is preferred because it avoids repeatedly passing credentials through tool arguments.
H2 client certificates
H2-family firmware that requires mutual TLS can load a Bambu-issued client
certificate and key from BAMBU_CLIENT_CERT and BAMBU_CLIENT_KEY. When those
variables are omitted, the server checks these private standard paths:
~/.config/bambu-printer-mcp/client.crt
~/.config/bambu-printer-mcp/client.keySet the key file to mode 0600. Both files must exist as a pair. No certificate
or key material belongs in the repository.
Version 2.0 automatically migrates the legacy
~/Desktop/bambu certs/embedded-cert.pem and embedded-key.pem pair into the
private standard paths. The current process can still use the legacy pair if
that migration cannot be completed.
MCP client configuration
Build the project first, then configure your MCP client to run the compiled entry point. Replace the path with the private local checkout path on that machine.
{
"mcpServers": {
"bambu-printers": {
"command": "node",
"args": ["/absolute/path/to/bambu-printer-mcp/dist/index.js"],
"env": {
"BAMBU_PRINTERS_FILE": "/absolute/path/to/private/printers.json",
"BAMBU_SHOP_P1S_SERIAL": "set-in-private-client-config",
"BAMBU_SHOP_P1S_TOKEN": "set-in-private-client-config",
"BAMBU_SHOP_P1S_DEVICE_ID": "set-in-private-client-config",
"BAMBU_ENGINEERING_X1C_SERIAL": "set-in-private-client-config",
"BAMBU_ENGINEERING_X1C_TOKEN": "set-in-private-client-config",
"BAMBU_ENGINEERING_X1C_DEVICE_ID": "set-in-private-client-config"
}
}
}
}Fleet tools
Tool | Purpose |
| List redacted profile summaries and readiness |
| Add an in-memory profile or persist safe metadata references |
| Remove a profile after |
| Select the implicit target |
| Query every ready printer with bounded concurrency |
| Reconnect one printer or an explicitly confirmed fleet |
Every printer-specific tool accepts a printer field containing the configured ID. If it is omitted, the registry uses the configured default or automatically selects the only configured printer. When multiple printers exist without a default, the call fails and lists the valid IDs.
Example operator requests:
List my configured printers.
Get fleet status.
Show AMS inventory for printer shop-p1s.
Capture a camera snapshot from engineering-x1c.
Pause the current job on shop-p1s.Core printer capabilities
The server includes tools for:
printer status, HMS diagnostics, temperatures, print progress, and AMS data
printer file listing, uploads, guarded deletion, and print start
pause, resume, cancel, speed, fan, light, temperature, airduct, and object-skip commands
AMS filament inventory, automatic 3MF-to-AMS matching, RFID reread, and drying controls
chamber-camera JPEG snapshots
STL inspection and transformations
Bambu Studio and compatible Orca-family slicing
pre-sliced
.gcode.3mfprinting with plate and AMS mapping controlsoptional BambuNetwork bridge workflows
Use tools/list from an MCP client for the authoritative schema and descriptions.
MCP resources
Configured printers are exposed by stable ID instead of IP address:
fleet://status
printer://shop-p1s/status
printer://shop-p1s/files
printer://shop-p1s/hmsResource listings never include printer IPs, serial numbers, or access tokens.
Version 2.0 resource migration
Version 2.0 intentionally replaces legacy host-based resource URIs with
profile IDs. Update printer://<host>/... consumers to
printer://<printer-id>/.... Host aliases are not retained because combining
caller-selected endpoints with stored credentials would weaken profile
isolation.
Transports
Stdio is the default and recommended transport.
For local Streamable HTTP:
MCP_TRANSPORT=streamable-http \
MCP_HTTP_HOST=127.0.0.1 \
MCP_HTTP_PORT=3000 \
MCP_HTTP_PATH=/mcp \
npm startOnly loopback hosts are accepted. Use a separately authenticated gateway if remote access is required.
Printer communication
MQTT over TLS on printer port 8883 carries status and control commands.
Implicit FTPS on printer port 990 handles file operations.
Some camera families use TLS port 6000; others use RTSPS with
ffmpeg.
Bambu printers commonly use self-signed local certificates, so the current printer transports do not perform public-CA verification. Keep printers and this MCP process on a trusted LAN or isolated VLAN. Do not expose printer ports to the public internet.
H2-family behavior
The upstream bambu-node dependency does not natively identify every H2 model and can throw from an asynchronous MQTT listener. This project carries a patch-package patch that:
preserves the configured model for unknown OTA serial prefixes
treats missing OTA model metadata as recoverable
treats unusual printer state transitions as recoverable instead of terminating the MCP process
Regression tests exercise those event paths after every install.
Validation order for a real printer
Use this order when connecting a new printer:
list_printersget_printer_statusHMS and AMS reads
file listing
camera snapshot
disconnect and reconnect
upload a known harmless file without printing
physical controls only when the operator can observe the printer
print start only with a verified plate, nozzle, material, model, and AMS mapping
Automated tests never start a real print.
Verified hardware coverage
The multi-printer release has been exercised against P1S and A1 hardware on a local network. Status, fleet status, HMS diagnostics, AMS inventory, FTPS file listing, disconnect, reconnect, and post-reconnect status were verified through the packaged MCP interface. That validation did not start, pause, resume, or cancel a print, move an axis, change a heater, or upload a file.
Development
npm ci
npm run build
npm test
npm audit --omit=dev
npm run privacy:check
npm pack --dry-runCI runs the same build, test, dependency-audit, package, and privacy gates.
Privacy
Do not commit:
printer IP addresses or private hostnames
serial numbers, LAN access codes, cloud credentials, or tokens
Wi-Fi information or network screenshots
camera images or MQTT captures
operator names or printer nicknames
local absolute paths, logs,
.envfiles, certificates, or private keys
The first public history of this repository is a sanitized snapshot. Earlier upstream history remains available from the attributed upstream repository but is intentionally not mirrored here.
License and provenance
GPL-2.0. See LICENSE and UPSTREAM.md.
Available Tools
46 toolsadd_printerA
Add or update a named printer profile. Plaintext tokens remain in memory only; persisted profiles must reference an environment variable.
Inputs: id (required), host (required), model (required), name, +11 more.
bambu_network_bridge_statusC
Inspect or probe the FULU OrcaSlicer-bambulab BambuNetwork bridge runtime used for cloud and restored BambuNetwork printing.
Inputs: connect, user_info, timeout_ms, country_code, +2 more.
bambu_network_callB
Call a raw FULU OrcaSlicer-bambulab BambuNetwork bridge method, optionally with an initialized network agent injected into the payload.
Inputs: method (required), payload, user_info, timeout_ms, +4 more.
blender_mcp_edit_modelB
Send STL-edit instructions to a Blender MCP bridge command for advanced model edits
Inputs: stl_path (required), operations (required), execute, bridge_command.
camera_snapshotA
Capture a single JPEG frame from the printer's chamber camera. A1/P1 use TCP-on-6000; X1/P2S/H2 use RTSP via ffmpeg. Returns JPEG as base64; pass save_path to also write the bytes to disk.
Inputs: host, printer, save_path, timeout_ms, +5 more.
cancel_printB
Cancel the current print job on the Bambu Lab printer
Inputs: host, printer, bambu_token, bambu_serial.
center_modelB
Translate the model so its geometric center is at the origin (0,0,0)
Inputs: stl_path (required).
clear_hms_errorsC
Clear HMS or print error state on the Bambu Lab printer using the clean_print_error MQTT command.
Inputs: host, printer, bambu_token, bambu_serial.
delete_printer_fileA
Delete a file from the Bambu Lab printer's SD card via FTPS. Destructive: requires confirm:true. Restricted to cache/, timelapse/, and logs/ directories. Path traversal segments (..) are rejected.
Inputs: filename (required), host, confirm, printer, +2 more.
extend_stl_baseC
Extend the base of an STL file by a specified amount
Inputs: stl_path (required), extension_height (required).
get_fleet_statusA
Get a redacted, failure-isolated status summary for every configured printer.
Inputs: concurrency.
get_printer_filamentsA
Get the live AMS/external filament inventory from the printer over MQTT, including loaded/empty slot summary, resolved slicer profile paths, match confidence, and recommended load_filaments when the printer model is known.
Inputs: host, printer, bambu_model, bambu_token, +2 more.
get_printer_statusB
Get the current status of the Bambu Lab printer
Inputs: host, printer, bambu_token, bambu_serial.
get_slice_settingsA
Inspect slicer settings from a saved 3MF template or a JSON/config slicer profile without slicing anything.
Inputs: source_path, template_dir, template_name.
get_stl_infoA
Get detailed information about an STL file (bounding box, face count, dimensions)
Inputs: stl_path (required).
lay_flatA
Rotate the model so its largest flat face lies on the XY plane (Z=0)
Inputs: stl_path (required).
list_3mf_plate_objectsA
List object IDs from a sliced 3MF plate. Use these IDs with skip_objects during a running print.
Inputs: three_mf_path (required), plate_index.
list_printer_filesB
List files stored on the Bambu Lab printer
Inputs: host, printer, bambu_token, bambu_serial.
list_printersA
List configured printer profiles without exposing hosts, serial numbers, or access tokens.
Inputs: no named parameters.
list_templatesB
List saved slicing templates from the local template registry directory.
Inputs: template_dir.
merge_verticesB
Merge vertices in an STL file closer than the specified tolerance
Inputs: stl_path (required), tolerance.
pause_printA
Pause the current print job on the Bambu Lab printer (resumable via resume_print)
Inputs: host, printer, bambu_token, bambu_serial.
print_3mfA
Print a 3MF file on a Bambu Lab printer. Auto-slices if the 3MF has no gcode. IMPORTANT: bambu_model must be specified to ensure safe printer operation.
Inputs: three_mf_path (required), host, dev_id, dev_ip, +28 more.
print_3mf_bambu_networkC
Print a 3MF through FULU OrcaSlicer-bambulab's restored BambuNetwork path instead of the MCP LAN MQTT/FTPS path.
Inputs: three_mf_path (required), host, dev_id, dev_ip, +42 more.
reconnect_printerB
Disconnect and reconnect one configured printer, or all configured printers with confirm_all:true.
Inputs: printer (required), confirm_all.
remove_printerA
Remove a named printer profile after explicit confirmation.
Inputs: confirm (required), printer (required), persist.
reread_ams_rfidA
Trigger a Bambu AMS RFID re-read for one AMS slot. This can move AMS filament; use only when the printer is idle and unloaded.
Inputs: ams_id (required), slot_id (required), host, printer, +2 more.
resolve_3mf_ams_slotsA
Inspect a sliced 3MF and match its tray_info_idx filament requirements against the live AMS inventory. Does not upload or start a print.
Inputs: three_mf_path (required), host, printer, bambu_model, +4 more.
resume_printA
Resume a paused print job on the Bambu Lab printer
Inputs: host, printer, bambu_token, bambu_serial.
rotate_stlB
Rotate an STL file by specified angles (degrees)
Inputs: stl_path (required), angle_x, angle_y, angle_z.
save_templateB
Copy a 3MF, JSON, or config file into the local template registry and register it under a template name.
Inputs: source_path (required), template_dir, template_name.
scale_stlB
Scale an STL file by specified factors
Inputs: stl_path (required), scale_x, scale_y, scale_z.
set_airduct_modeB
Set H2/P2 airduct mode to cooling or heating.
Inputs: mode (required), host, printer, bambu_token, +1 more.
set_ams_dryingA
Start or stop the AMS filament drying cycle. Available on AMS units with heating capability (AMS Pro / AMS-HT). Sends an ams_control MQTT command to the printer.
Inputs: action (required), ams_id (required), host, printer, +2 more.
set_default_printerA
Select the printer used when a tool call omits printer.
Inputs: printer (required), persist.
set_fan_speedB
Set a Bambu printer fan speed percentage using the printer's MQTT fan command
Inputs: fan (required), speed (required), host, printer, +2 more.
set_lightB
Set a Bambu printer light node mode using the printer's MQTT LED command
Inputs: mode (required), light (required), host, printer, +2 more.
set_print_speedB
Set the active print speed mode: silent, standard, sport, or ludicrous.
Inputs: mode (required), host, printer, bambu_token, +1 more.
set_temperatureB
Set the temperature of a printer component (bed, nozzle)
Inputs: component (required), temperature (required), host, printer, +2 more.
skip_objectsA
Skip specific object IDs during a running multi-object print using the printer's MQTT skip_objects command
Inputs: object_ids (required), host, printer, bambu_token, +1 more.
slice_stlB
Slice an STL or 3MF file using a slicer to generate printable G-code or sliced 3MF. IMPORTANT: bambu_model must be specified to ensure the slicer generates safe G-code for the correct printer.
Inputs: stl_path (required), bambu_model (required), scale, orient, +27 more.
slice_with_templateB
Slice an STL or 3MF using a named template from the local registry. This is a higher-level wrapper around slice_stl for template-based workflows.
Inputs: stl_path (required), bambu_model (required), template_name (required), host, +23 more.
start_printA
Start printing a G-code file already on the Bambu Lab printer. Alias of start_print_job for upstream MCP compatibility.
Inputs: filename (required), host, printer, bambu_model, +2 more.
start_print_jobB
Start printing a G-code file already on the Bambu Lab printer
Inputs: filename (required), host, printer, bambu_model, +2 more.
upload_fileC
Upload a local file to the Bambu Lab printer
Inputs: filename (required), file_path (required), host, print, +4 more.
upload_gcodeC
Upload a G-code file to the Bambu Lab printer
Inputs: filename (required), host, gcode, printer, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Several tools have overlapping purposes, such as start_print/start_print_job, print_3mf/print_3mf_bambu_network, slice_with_template/slice_stl, and upload_gcode/upload_file. While individual descriptions attempt to clarify, the similarities may confuse an agent.
Naming is mixed: some tools follow verb_noun (save_template, list_printers), others use verb_stl (scale_stl, rotate_stl), and some are verbose (bambu_network_bridge_status). The pattern is inconsistent, though generally readable.
46 tools is high for a single MCP server, covering slicing, STL editing, printer control, camera, and AMS. While the domain is broad, the number feels heavy and could benefit from modularization.
The toolset covers a wide range of Bambu printer operations: printer management, file operations, slicing, print control, STL editing, AMS, and camera. Minor gaps like firmware updates exist, but core workflows are well-supported.
Maintenance
Related MCP Connectors
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
Real 3D-print slicing, quoting, DFM, orientation & material/settings advisors. Free personal tier.
3D printing: printable models, calculators, troubleshooting wiki, build guides, AI 3D + CAD design.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Bambu Lab-focused MCP server for controlling Bambu printers, manipulating STL files, and managing end-to-end 3MF print workflows from any MCP-compatible client.3755 npmGPL 2.0
- AlicenseAqualityCmaintenanceEnables headless slicing with OrcaSlicer, preset management, G-code analysis, and printer control over LAN for Klipper, OctoPrint, Prusa, Duet, Elegoo, and Bambu printers.153MIT
- AlicenseAqualityCmaintenanceEnables LAN-based monitoring and control of Bambu Lab P2S/P1S printers, including confirm-gated print, pause, resume, stop, file upload, and slicing workflows.1037 npmMIT
- AlicenseBqualityCmaintenanceEnables LAN-based control and monitoring of Bambu Lab printers, including pause/resume/stop, temperature and G-code commands, and automatic plate ejection. Adds a filament-aware job queue with retries, AI print supervision, spool inventory, and cost reporting.48PolyForm Noncommercial 1.0.0