Bambu Studio Advisor
This server gives Claude a local Bambu Studio/3D-printing toolkit for analyzing models, slicing, comparing variants, managing presets, editing 3MFs, and reading printer status.
Analyze STL/3MF geometry: dimensions, volume, bed fit, overhangs, bridges, best orientation, support/brim advice.
Inspect 3MF projects and read their print settings.
Edit a 3MF into a changed copy without modifying the original.
Slice models with the real Bambu Studio engine and return time, weight, warnings, and result.3mf.
Compare custom slicing variants in parallel and run optimized recipes (quality, balanced, speed, strength, light).
Prepare raw STL/geometry-only 3MF into a print-ready project.
Check settings without slicing: flow, speed, cooling, and material pitfalls.
List, read, compare, and save Bambu Studio presets with backups.
Provide material advice, slice history, and first-use/default configuration.
Read live printer status over LAN (read-only: job, temperatures, AMS, HMS errors).
Never starts a print; original files are left untouched and outputs go under output/.
Connects to Bambu Lab printers and Bambu Studio to analyze STL/3MF models, slice print variants locally, compare time and material usage, manage Bambu Studio presets, and optionally read printer status, temperatures, AMS information, and HMS errors over the local network.
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 Studio Advisor slice camera_case.stl in PLA Matte and compare print variants"
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 Studio Advisor - MCP
An MCP connector that gives Claude access to Bambu Studio and your Bambu Lab printer.
Hand Claude an STL or 3MF file: it analyzes the part, asks which filament you use, slices several
variants with the real Bambu Studio engine, compares time and weight, then gives you a .3mf
project ready to open and print. Everything runs locally on your PC.
Works with Bambu Lab printers (P1S, P1P, X1 Carbon, A1, A1 mini…): on first use, Claude asks for your printer, build plate and usual filament. Recipes are tuned on a 0.4 mm nozzle.
Contents
Related MCP server: bambu-mcp
What it does
First-use setup: your printer, build plate and usual filament, asked once and saved. Build volume, presets and accelerations follow the printer you chose.
Part analysis: dimensions, volume, fit on the bed, overhangs and bridges for 6 orientations, best orientation, need for supports or a brim.
Real slicing with
bambu-studio.exe: time, weight, time per line type, warnings.Recipe comparison in parallel (
quality,balanced,speed,strength,light), with the recommended variant and per-plate details.Multi-plate projects: a single
result.3mfholds every plate and its G-code.Automatic conversion: a project made for another printer is converted to yours, keeping the author's print settings.
Filament swap: applies your filament (temperatures, build plate, flow, cooling) to any project.
Checks: volumetric flow and actual speed per line type, layers too thick, cooling, lightning infill, pitfalls per material.
Presets: read, compare, create or modify your Bambu Studio presets (with backups).
Printer (optional): status over the local network, temperatures, AMS, HMS errors, read-only.
The connector never starts a print: you open the produced 3MF in Bambu Studio and print it yourself.
Example
You: here's my camera case, print it in Bambu PLA Matte black
C:\Users\me\Downloads\case.3mfClaude: analyzes the 4 plates, converts the project (made for an X1C) to your printer, applies the
Bambu PLA Mattepreset, slices the 6 variants in parallel, then answers:
Variant
Time
Weight
Original
9 h 11
459.3 g
Balanced
9 h 32
454.1 g
Speed
7 h 29
379.4 g
…
Recommendation, things to watch, per-plate details and the path of the
result.3mfto open.
This summary comes from the 3d-printing skill shipped with the
connector (installed with the plugin, or by hand in step 4).
Requirements
System | Windows 10 or 11 |
Bambu Studio | Installed (default path: |
Python | 3.10 or newer (python.org), or uv for the Claude plugin |
Claude | Claude Code (terminal, desktop app or IDE) or Claude Desktop |
Git | To clone the repository (or download the ZIP from GitHub) |
Installation
Option A: Claude plugin (simplest)
The plugin installs the connector and the 3d-printing skill in one go, and keeps them up to date.
Install uv once, following its official installation page (the Windows installer or WinGet package both work).
In Claude Code, add the plugin:
/plugin marketplace add JohanRouyer/BambuStudio-Advisor-MCP /plugin install bambu-studio-advisor@bambu-studio-advisorOptional: fill in the printer IP address, serial number and access code when Claude Code asks (only the printer status needs them). The access code is kept in your system's secure storage.
On first start, uv creates the Python environment from uv.lock in the plugin folder (about 30 s), then the connector is
ready: go to First use. Your defaults and results are kept in the plugin's data folder
(~/.claude/plugins/data/…), so they survive updates. If you had copied the skill by hand
(step 4 below), delete ~\.claude\skills\3d-printing to avoid having it twice.
Option B: manual installation
Run the following commands in PowerShell.
1. Get the project
git clone https://github.com/JohanRouyer/BambuStudio-Advisor-MCP.git
cd BambuStudio-Advisor-MCPPut the folder wherever you like, but do not move it afterwards: Claude starts it by its full path.
2. Create the Python environment
python -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt3. Register the connector with Claude
Claude Code: from the project folder, register it for all your projects (--scope user):
claude mcp add --scope user bambu-studio -- "$PWD\.venv\Scripts\python.exe" "$PWD\run_server.py"Claude Desktop: open Settings → Developer → Edit Config and add the following, replacing the path with your folder's (with doubled backslashes):
{
"mcpServers": {
"bambu-studio": {
"command": "C:\\path\\to\\BambuStudio-Advisor-MCP\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\BambuStudio-Advisor-MCP\\run_server.py"]
}
}
}Then restart Claude so it loads the connector.
4. Install the 3d-printing skill (recommended)
The skill tells Claude how to chain the tools as soon as you talk about 3D printing or give an STL / 3MF file: analysis, filament question, slicing, full summary. Without it the tools still work, but you have to ask for them one by one.
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force skills\3d-printing "$env:USERPROFILE\.claude\skills\"The skill is used by Claude Code. To update it after a git pull, run the Copy-Item command again.
5. First use
Give Claude a file, or ask "set up my printer". Since nothing is set yet, it first asks for:
your printer (P1S, X1 Carbon, A1, A1 mini… and the nozzle if it is not 0.4 mm);
your usual build plate (Textured PEI, Cool Plate, High Temp, Engineering);
your usual filament (Bambu PLA Basic, PLA Matte, PETG HF…).
It saves these choices in config.json (in the plugin's data folder with option A), then carries on with your request. To change them later,
just say so: "I switched to an A1", "my usual plate is the Cool Plate".
To check the installation, ask "show me the bambu-studio connector info": the answer should contain
"exists": true for Bambu Studio and the path of your presets.
Configuration
Defaults are set by talking to Claude (see First use): it writes them to
config.json, which is not tracked by git. You can also edit that file by hand, starting from the
example:
Copy-Item config.example.json config.jsonKey | Purpose | Default |
| Printer targeted by every slice (exact machine preset name) |
|
| Starting process for an STL without presets (set along with the printer) |
|
| Build plate used when slicing | the project's |
| Filament offered first, and used for an STL without a specified filament | PLA Basic |
| Results folder |
|
| Bambu Studio install folder |
|
| Bambu Studio data folder |
|
| Bambu account whose user presets are read | the first account found |
| Printer connection over the local network (see below) | empty |
Bambu's P1S presets reuse the X1C processes: that is why the default process is named
@BBL X1C. It is picked automatically when you change printer.
Printer connection (optional)
Only the printer_status tool needs it. With the plugin, enter it in the plugin settings (they take
precedence over config.json). Otherwise, in config.json, fill in the printer section:
Key | Where to find it on the printer's screen |
| IP address: Settings → Network |
| Serial number: Settings → Device |
| LAN access code: Settings → Network |
The PC and the printer must be on the same network.
Available tools
Tool | Purpose |
| Geometry of an STL / 3MF: dimensions, volume, overhangs and bridges for 6 orientations, best orientation |
| Summary of a 3MF: presets, objects and their own settings, plates, slicing results |
| Advice per material: preset, build plates and temperatures, lid / door, AMS, nozzle, drying |
| STL / 3MF → ready project in one call: orientation, material preset, build plate, supports, brim, copies, slice |
| The 5 recipes and the original sliced in parallel, with the recommended variant |
| Your own variants |
| A single slice, with presets and settings of your choice |
| Checks a 3MF without slicing: flow, actual speeds, cooling, pitfalls |
| Every setting of a 3MF project, filterable by keyword |
| Edited copy of a 3MF ( |
| Process / filament / machine presets compatible with your default printer |
| Settings of a preset, inheritance resolved |
| Differences between two presets |
| Creates or modifies a user preset (the old one is backed up in |
| Latest slices: models, presets, settings, time, weight, produced file |
| Printer status: print job, temperatures, AMS, HMS errors (read-only) |
| Default printer, build plate and filament: read, available choices, save |
| Paths used, configuration status, whether first-use setup is needed |
How it works
Recipes
They apply on top of the project's settings. On a Bambu project, everything else (supports, brims, the author's per-object settings) is kept.
Recipe | Layer | Walls | Infill | Top / bottom | Accelerations |
| 0.16 mm | project's | project's | project's | gentle: wall 3,000, top 1,500 |
| 0.20 mm | project's | project's | project's | standard: 10,000, wall 5,000, top 2,000 |
| 0.28 mm | 2 | adaptive cubic 12 % | 4 / 3 | brisk: 14,000, wall 7,000 |
| 0.20 mm | 4 | gyroid 25 % | 5 / 4 | project's |
| 0.24 mm | 2 | adaptive cubic 10 % | 4 / 3 | 12,000, wall 6,000 |
A few deliberate choices:
No lightning infill: it leaves top layers bridging over large gaps. Adaptive cubic keeps most of the weight saving without that flaw.
Little room on speeds: in PLA, the filament's max flow (15 to 22 mm³/s) already caps speeds. Recipes therefore play on accelerations, brought down to 75 % of your printer's maximum when needed (9,000 mm/s² on an A1, which tops out at 12,000).
Filament
With the skill, Claude always asks for your filament before slicing, even if the file has one,
offering your usual filament first. Presets follow your printer (Bambu PLA Basic @BBL A1 on an A1,
for example). On a 3MF project, the chosen preset replaces the project's filament in every slot,
and the author's print settings are kept.
Printer
Every slice targets your default printer. A project made for another model is converted before slicing: only the printer part changes (start and end G-code, model, nozzle). An STL without presets gets your printer, its standard process and your usual filament. The part analysis uses your printer's build volume (180 × 180 × 180 mm for an A1 mini, for example).
Output files
output/
├── <project>/
│ ├── original/<timestamp>/result.3mf
│ ├── balanced/<timestamp>/result.3mf
│ └── …
├── .cache/ slices already done (delete the folder to clear it)
└── history.jsonl one line per sliceOne
result.3mfper variant, with every plate and its G-code.Cache: an identical slice (same models, settings, presets and Bambu Studio version) comes back instantly.
Parallelism: one Bambu Studio per two cores (6 on a 12-core CPU).
Retry: if Bambu Studio hangs (rare), the slice is retried once, then dropped with a clear message.
Safety
No print is ever started:
printer_statusis read-only.Original files are never modified: results go to
output\, andedit_3mfwrites a copy (unless given the same path as output; a.backupcopy is then made).save_presetbacks up the old preset inbackups\before writing. Restart Bambu Studio so it sees a modified preset.The printer's access code gives local control of it:
config.jsonmust stay on your PC (it is excluded from git).
Privacy Policy
The connector runs entirely on your PC and collects no personal data: no telemetry, no account, no internet requests of its own.
Collected: only the 3D files you point to, your Bambu Studio presets, your defaults and, optionally, your printer's IP address, serial number and access code.
Usage and storage: files are sliced locally with your
bambu-studio.exe; results and defaults stay on your PC (plugin data folder or project folder); the access code goes to your system's secure storage with the plugin. The printer is only read over your local network.Sharing: nothing is sent to the developer or any third party. Tool results go to Claude, under Anthropic's privacy policy. On first start,
uvdownloads the Python packages ofuv.lockfrom PyPI.Retention: everything stays until you delete it; uninstalling the plugin deletes its data folder.
Contact: GitHub issues.
Full policy: PRIVACY.md.
Known limitations
Windows only for now (Windows paths,
taskkill,tasklist).Recipes and material advice are tuned on a 0.4 mm nozzle (on a P1S): they remain valid on other Bambu printers, but have not been fine-tuned there.
.stepand.objfiles are not read: open them in Bambu Studio and save them as 3MF.The overhang analysis is a geometric estimate: the slicer's warnings are the reference.
Filament color is not set: map the AMS slot when opening the file in Bambu Studio.
Troubleshooting
Problem | Fix |
| Install Bambu Studio, or set its folder in |
The tools do not show up in Claude | Plugin: check that |
| Launch Bambu Studio once, sign in to your account, then try again (close names are suggested) |
A slice hangs | Close any |
| Check the IP, the access code, LAN mode and that the PC is on the same network |
A code change is not picked up | Restart Claude: the server is loaded at startup |
Development
.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.venv\Scripts\python.exe -m pytest tests
.venv\Scripts\python.exe -m pyflakes bambu_mcp testsUnit tests (geometry, checks, cache, history) take under a second. Integration tests slice real models with Bambu Studio (about 20 s) and are skipped if it is not installed. Test models are generated on the fly: no file to provide.
bambu_mcp/
├── server.py MCP tools exposed to Claude
├── slicer.py Bambu Studio CLI calls, recipes, comparisons, cache
├── prepare.py end-to-end preparation of an STL / 3MF
├── threemf.py reading and editing 3MF projects
├── presets.py system and user presets, inheritance, writing
├── geometry.py geometric analysis and orientation
├── analysis.py settings checks
├── materials.py advice per material
├── defaults.py default printer, build plate and filament
├── printer.py printer status (MQTT, read-only)
├── history.py slice history
└── config.py paths and config.json
skills/3d-printing/SKILL.md Claude Code skill
.claude-plugin/ Claude plugin manifest and marketplace
.mcp.json how the plugin starts the connector (uv + uv.lock)After changing dependencies in pyproject.toml, run uv lock and commit uv.lock.
License
MIT: free to use, modify and share, including commercially, as long as the copyright notice is kept.
Available Tools
18 toolsanalyze_modelAnalyze geometryARead-onlyIdempotent
Analyze the geometry of an STL or 3MF: dimensions, volume, whether it fits the default printer's bed, footprint, overhangs and bridges for 6 orientations, the best orientation and support/brim advice. Read-only and fast (no slicing). Use it first on any model; STEP and OBJ files are not supported.
Inputs: path (required).
check_settingsCheck project settingsARead-onlyIdempotent
Check a 3MF project's settings without slicing: volumetric flow per line type against the filament's max flow (and the speed actually reached when capped), speeds above the machine's limits, cooling and per-material pitfalls. Read-only. Use it before slicing a project; slice_model reports the same checks on its result.
Inputs: path (required).
compare_presetsCompare two presetsARead-onlyIdempotent
Compare two presets of the same type and return only the settings whose values differ (setting, value in A, value in B), inheritance resolved. Read-only. Use it to see what a user preset changes from a Bambu preset, or how two profiles differ; use get_preset to read one preset in full. Fails if either name is unknown.
Inputs: kind (required), preset_a (required), preset_b (required). Returns: result
compare_slicesCompare setting variantsAIdempotent
Slice several setting variants in parallel in one call and compare them: time, weight (total and per plate), % difference from the original and checks for each. Results are written under output/; the original is never modified. Use it to test your own settings; use optimize for the 5 ready-made goals and slice_model for a single slice.
Inputs: models (required), variants (required), plate, machine, +4 more.
connector_infoConnector infoARead-onlyIdempotent
Return the connector's status: whether first-use setup is needed, the saved defaults, the
Bambu Studio and preset paths, the output folder, and whether the printer is configured.
Read-only. Call it first in a session: if setup_needed is true, ask the user for their printer,
build plate and filament, then call setup_defaults.
Inputs: no named parameters.
edit_3mfWrite an edited 3MF copyAIdempotent
Write a copy of a 3MF project with changed settings, without slicing. The original is left untouched unless output_path is its own path. Use it to hand the user an edited project; to measure the effect of settings, use slice_model or compare_slices instead (they never modify the original).
Inputs: path (required), settings, output_path, object_settings.
get_3mf_settingsRead 3MF project settingsARead-onlyIdempotent
Read the print settings stored in a Bambu 3MF project (project_settings.config), as Bambu strings. Read-only. Use it to see the values a project will print with; use inspect_3mf for a summary and check_settings for problems. Fails on a 3MF without Bambu settings.
Inputs: path (required), key_filter.
get_presetRead a presetARead-onlyIdempotent
Read the settings of one preset, with inheritance resolved (values as Bambu strings). Read-only. Use it to inspect a single preset; use compare_presets to see only the differences between two, and get_3mf_settings for the settings stored in a 3MF project. Fails if the name is unknown and lists close names.
Inputs: kind (required), name (required), key_filter, only_overrides.
inspect_3mfInspect a 3MF fileARead-onlyIdempotent
Summarize a 3MF file: whether it is a full Bambu project or geometry only, the printer and presets it was made with, its objects and their own settings, its plates, and slicing results if it has any. Read-only. Use it first on any 3MF; use get_3mf_settings for the full list of project settings and analyze_model for the geometry.
Inputs: path (required).
list_presetsList presetsARead-onlyIdempotent
List Bambu Studio presets of one type, with their source and parent. Read-only. Use it to find an exact preset name before get_preset, compare_presets or slicing; use material_guide instead to get the recommended filament preset for a material.
Inputs: kind (required), search, source, printer_name. Returns: result
material_guideMaterial guideARead-onlyIdempotent
Give printing advice for a material on the default printer: the filament preset to use, suitable build plates and temperatures, enclosure (lid/door), AMS compatibility, nozzle and drying notes. Read-only. Use it to pick the filament preset passed to slicing tools; use list_presets to search for a specific brand.
Inputs: filament, material.
optimizeOptimize for a goalAIdempotent
Slice the original and ready-made recipes (quality, balanced, speed, strength, light) in
parallel, with accelerations kept within the printer's limits, and return the comparison plus the
recommended goal variant and its result.3mf (under output/; the original is never modified).
Use it to answer "how should I print this"; pass the user's chosen filament preset in filaments.
Use compare_slices for custom settings.
Inputs: goal (required), models (required), plate, machine, +4 more.
prepare_printPrepare a printAIdempotent
Turn an STL (or geometry-only 3MF) into a print-ready Bambu project in one call: analysis, best orientation, material presets, build plate, supports and brim when needed, copies arranged, then slice. Returns time, weight, the decisions made, warnings and the result.3mf (under output/). Use it for raw models; for a complete Bambu project use optimize or slice_model instead.
Inputs: models (required), goal, copies, bed_type, +5 more.
printer_statusPrinter statusARead-onlyIdempotent
Read the printer's live status over the local network (MQTT): print job and progress, temperatures, fans, AMS trays and loaded filaments, HMS errors. Strictly read-only: it never sends commands. Needs the printer's host, serial and access code in config.json (see connector_info); fails if they are missing or the printer is off.
Inputs: include_raw.
save_presetSave a user presetADestructiveIdempotent
Create or update a user preset in Bambu Studio's user folder. Overwrites the existing user preset of that name; the previous file is backed up in backups/ first. Only call it once the user has agreed to the changes, after slicing to compare them (compare_slices). Bambu Studio must be restarted to show the change.
Inputs: kind (required), name (required), settings (required), parent.
setup_defaultsSet up defaultsAIdempotent
Read or save the user's default printer, build plate and filament (stored in config.json). Without arguments: returns the current values and the available choices. With arguments: validates them and saves only those given. Call it on first use (connector_info.setup_needed) or when the user changes printer, plate or usual filament.
Inputs: machine, bed_type, filament.
slice_historySlice historyARead-onlyIdempotent
List previous slices, newest first: models, presets, changed settings, time, weight, number of checks and the result.3mf path. Read-only. Use it to find an earlier result again instead of slicing anew.
Inputs: limit, search. Returns: result
slice_modelSlice a modelAIdempotent
Slice once with the real Bambu Studio engine and return print time, filament weight, time per
line type, warnings and the path of the sliced result.3mf (written under output/; originals are
never modified). An identical slice comes back from the cache.
A Bambu 3MF keeps its own settings (moved to the default printer if made for another); an STL
gets machine/process/filaments or the user's defaults. Use compare_slices to try several
settings at once, optimize for ready-made goals, prepare_print to go from a raw STL to a project.
Inputs: models (required), plate, orient, arrange, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools target distinct resources or workflow stages, and descriptions explicitly route between similar options (e.g. inspect_3mf vs get_3mf_settings vs check_settings). The main ambiguity is the slicing family: slice_model, compare_slices, optimize, and prepare_print all overlap, though their descriptions clarify when to use each.
The set is predominantly snake_case with predictable verb_noun names such as list_presets, get_3mf_settings, compare_slices, and setup_defaults. Minor deviations like optimize (bare verb) and noun-first names like material_guide, printer_status, and connector_info are still readable and not confusing.
At 18 tools, the server is on the heavy side for the domain, with several closely related slicing and inspection entry points. Each tool has a plausible role, but the surface feels broad enough that a user or agent must learn routing rules rather than intuit the set.
Coverage is strong: preset read/list/compare/save, 3MF inspect/edit/settings checks, slicing, optimization, model analysis, material guidance, printer status, history, and setup defaults. Minor gaps exist, such as no explicit delete_preset operation and no direct creation of a new 3MF except via prepare_print from STL/geometry-only input.
Maintenance
Related MCP Connectors
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.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Related MCP Servers
- FlicenseAqualityCmaintenanceIntegrates Bambu Studio and Bambu Lab 3D printers with Claude, enabling printer status checks, print control, file management, and slicing via natural language.9-
- 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
- AlicenseNot gradedqualityBmaintenanceEnables slicing 3MF projects with a local Bambu Studio installation and exploring the resulting toolpaths, layers, print times, and filament usage in an interactive 3D viewer inside ChatGPT.AGPL 3.0
- AlicenseAqualityCmaintenanceEnables Claude to model 3D-printable parts by running Python scripts in a headless FreeCAD instance and exporting STL/3MF/STEP files. It also lets Claude visually inspect renders, check mesh integrity and overhang printability, measure volume and estimated mass, and open results in a slicer before printing.10MIT