Skip to main content
Glama
Bambu Workflow MCP

Bambu Workflow MCP

by netuneed

Bambu Workflow MCP

Model-aware CAD-to-printer workflows for Bambu Lab on Windows and macOS. Version 0.5.1.

First installation or laboratory handoff: use the English Lab quickstart. It includes a copyable Codex setup request, a verified release installer, local P2S configuration, a shareable readiness report, and the first-print procedure. File-based printing needs neither Git nor Blender.

Export selected Blender objects or use Fusion/QymCAD STL/3MF exports, verify millimeters and mesh topology, resolve installed Bambu Studio profiles, and inspect the executable plate. Jobs bind the chosen printer, nozzle revision, exact filament variants and feed positions to a checksum-verified artifact. Fresh telemetry confirms the exact physical job.

Jobs, source snapshots, launch intentions and printer locks survive MCP restarts. Retrying the same request cannot silently create a second print. Access codes stay in the operating system keyring.

Install on Windows

Requirements: Python 3.12+, installed official Bambu Studio and a Bambu Lab printer on your local network. Live export additionally needs a running Blender MCP connection. Printer firmware and LAN permissions must permit local control; see setup. The release/skill installation does not need Git. To build from source, install Git and run:

git clone https://github.com/netuneed/bambu-workflow-mcp.git
cd bambu-workflow-mcp
python -m pip install build
python -m build --wheel
.\scripts\install.ps1 -WheelPath '.\dist\bambu_workflow_mcp-0.5.1-py3-none-any.whl' -Python python -InstallSkill

The installer creates a separate versioned environment under %LOCALAPPDATA%\BambuWorkflow\app. Bambu Studio, Blender and a Python interpreter are not bundled. Installation, updates and release ZIPs.

Run the installed launcher's -m bambu_workflow.cli onboard command in a local terminal. It configures a new device and registers MCP without contacting a printer or printing. Use lab-check for an offline report or add --online for explicit read-only telemetry checks. Configuration and persistent jobs live outside the checkout. Select a non-default configuration with BAMBU_WORKFLOW_CONFIG or --config.

Related MCP server: freecad-bambu-mcp

Install on macOS

Install the official Bambu Studio application and Python 3.12+. Use the Lab quickstart for installation without Git. The optional source-build route is:

git clone https://github.com/netuneed/bambu-workflow-mcp.git
cd bambu-workflow-mcp
python3 -m venv .build
.build/bin/python -m pip install build
.build/bin/python -m build --wheel
sh scripts/install.sh --python .build/bin/python --wheel-path dist/bambu_workflow_mcp-0.5.1-py3-none-any.whl --install-skill

The runtime is created under ~/Library/Application Support/BambuWorkflow/app/0.5.1. Access codes use the system keyring (Keychain on macOS). The installer reports the venv launcher path for Codex; it does not register the global Python interpreter. Installed application bundles under /Applications and ~/Applications, including Contents/Resources and Contents/resources, are discovered automatically.

Release ZIPs include a platform-specific installer. Dependencies download separately. For cameras using RTSPS, an optional ffmpeg executable is required; models using the TCP camera do not need it.

Printer coverage

The printers share LAN protocols, with model-specific profiles, temperatures, storage routes, camera protocols and tool systems. list_models in MCP or bambu-workflow models shows exact operation support without reading printer credentials.

Models

Preparation

Automatic launch

A1 mini, A1, P1P, P1S, X1, X1 Carbon, X1E

Supported

Single-material LAN workflow implemented

P2S, H2S, A2L

Supported with matching installed profiles

Model-specific single-tool LAN workflow implemented; no hardware validation

H2D, H2D Pro, H2C

Single-material factory multi-tool profiles

Multi-tool launch adapter remains unavailable; launch using Bambu Studio

X2D

Single-material factory multi-tool profile

Native eMMC uploader and multi-tool launch adapter remain unavailable

Only A1 mini has physical launch evidence. P2S, AMS, custom nozzles, and fins have no physical acceptance evidence in this project. Missing nozzle telemetry requires explicit installed-nozzle facts; custom facts expire and must be renewed before start. Known live mismatches always block launch. Unknown models are rejected. Detailed capabilities.

Use from Codex

Install the included bambu-print skill together with its MCP runtime using the Lab quickstart, then ask:

$bambu-print Print the model in the current Blender scene's Print collection.

For preparation only, ask to prepare or export. That does not authorize printing. An explicit print instruction covers normal checked preparation and launch.

Use inspect_project(path) for offline 3MF material/variant and authored plate checks. Editable multi-object or multi-plate projects stay in Studio to preserve layout. A successful CLI export does not prove GUI loading. See portable-project checks.

The skill resolves the collection in the active scene, checks real slicer layers and preserves the original model. It never selects an old collection from another scene merely because it has the same base name.

For CAD, use neutral exports and record source application/version, units, and control dimensions. Multiple colors and painted/manual supports use the supported sliced-3MF path prepared in Bambu Studio; the normalized-STL path does not preserve those assignments. The English skill has focused references for CAD import, P2S, AMS and nozzles, and support/diagonal review.

Three decision levels

Level

Behaviour

Critical

Block launch. Invalid scale or mesh, oversized model, incompatible profile, unclassified slicer diagnostic, printer fault and missing physical bed readiness are blockers. Silence cannot override them.

Medium

Keep the job prepared, describe the concern and offer a concrete optional change. If the owner does not answer after a reasonable opportunity and mandatory checks pass, continue with the original printable geometry.

Clear

Continue the authorized print without another general approval. Informational notices do not force a review.

An unanswered suggestion never authorizes scaling, cutting, remeshing or changing functional dimensions. Required repairs remain blocked. The skill handles the conversation; the server enforces mandatory checks and retains medium review across restarts. There is no unattended countdown that launches after a disconnected client.

Use from code

The server speaks standard MCP over stdio:

python -m bambu_workflow.server

Tools include list_models, list_printers, material_inventory, confirm_nozzle, prepare_print, print_model, print_assessment, record_layer_review, start_prepared, job_status and mark_bed_ready. Optional generate_support_fins creates a derivative using a pinned local tool; it never starts a print. Supply one stable request_id per human instruction and reuse identical arguments on retries. A sent command is not proof of printing. An uncertain launch is reconciled, never blindly resent.

Usage and Python examples cover MCP clients and CLI calls. scripts/call_mcp.py lists tools by default; printing needs explicit arguments. Printer addresses are configurable.

Before every physical start, a human must observe a clear bed and the correct plate. A readiness token lasts at most 30 minutes and is consumed once. Camera images and idle status cannot prove an empty bed. A busy printer is never canceled to make room for another job.

Validation and limits

The complete export, slice, upload and start path was exercised on A1 mini firmware 01.08.01.00 and Bambu Studio 02.08.02.61. One print reached its reported final layer and FINISH; a second independently reviewed model was launched and later stopped after reported bed detachment. Finished-part dimensions, strength and surface quality have not been certified. Validation.

Geometry reslicing remains a single-material normalized-mesh workflow. Supported pre-sliced 3MF can retain a validated multi-filament palette and explicit AMS mapping; it requires review of the current sliced artifact. Complex per-object settings that cannot be preserved are rejected. Standard/HighFlow selection requires the matching installed profile; custom nozzles additionally require compatible geometry, calibrated limits, and fresh human evidence. These software checks are not hardware qualification.

Manual, finned, tilted, imported sliced, and multicolor jobs need real-layer review bound to the artifact SHA256. A successful fin-generator exit or mesh check does not establish support contact or complete coverage. No strength, adhesion, minimum-wall, self-intersection, or complete collision guarantee is made. Multiple source shells in geometry reslicing become one slicer object; individual-object skipping is unavailable. Sources checked 2026-11-06 and review decisions.

python -m pip install -e ".[dev]"
python -m pytest

Recovery · Capabilities · Protocol sources · Third-party notices

Own code: MIT. No access codes, printer addresses, private models, runtime state or proprietary network plugin are distributed. This project is not affiliated with Bambu Lab.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides end-to-end 3D printing automation for Bambu Lab printers, allowing users to generate, slice, and monitor prints using natural language. It features model generation from text or images, real-time camera monitoring, and automated print quality improvement.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables a reviewable FreeCAD-to-Bambu Studio workflow with resumable jobs, bounded 3MF preflight, explicit review checkpoints, and LAN upload/control, including experimental guarded printing.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LAN-based monitoring and control of Bambu Lab P2S/P1S printers, including confirm-gated print, pause, resume, stop, file upload, and slicing workflows.
      10
      37 npm
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      48
      PolyForm Noncommercial 1.0.0