bambu-gateway-mcp

An MCP server that exposes the bambu-gateway print-session HTTP API to an LLM agent, enabling agent-driven Bambu Lab 3D printer control.

Setup

pip install -e .
cp .env.example .env
# Edit .env and set GATEWAY_BASE_URL to your bambu-gateway instance

Configuration

Variable	Default	Description
GATEWAY_BASE_URL	—	URL of the bambu-gateway instance, e.g. http://10.0.1.9:4844

Running

bambu-gateway-mcp

The server listens on stdio and is ready for an MCP client (Claude Code, Cursor, etc.) to connect.

Tools

The MCP server exposes the following tools:

• list_printers — List configured printers (id, name, machine, online status)
• get_ams(printer_id) — Get AMS tray/filament state for filament selection
• list_filaments — Available slicer filament profiles
• list_processes — Available slicer process profiles
• create_print_session(model_path, printer_id, ...) — Configure a print from a local 3MF/STL file. Returns job_id, sliced status, and handoff_url to review/tweak in the browser.
• get_print_session(session_id) — Poll session status and handoff_url
• start_print(session_id) — Start printing a configured, sliced session (elicitation-gated — asks for approval first)

Typical Flow

1. Call list_printers to pick a target printer
2. Call get_ams(printer_id) to see filament availability
3. Call create_print_session(model_path, printer_id, ...) with your 3MF/STL and desired profiles
4. Share the returned handoff_url with the user to review/adjust in the browser
5. Once ready, call start_print(session_id) — the server asks for confirmation before printing

Safety

start_print always asks for explicit user approval in the conversation. No print starts silently; the tool prompts for elicitation and only proceeds if the user confirms. Clients that don't support elicitation fail safe (no print).