creality-print-mcp
Supports Bambu Studio presets through the shared OrcaSlicer/Bambu Studio preset format, allowing AI assistants to list and inspect effective preset settings, audit print profiles for common failure causes, and safely edit preset parameters with backups and restore support.
Provides tools for reading, auditing, and editing Creality Print presets (process, filament, and machine profiles), resolving inherited vendor settings, making backed-up parameter changes, and restoring backups. Also supports inspecting, scaling, and rotating 3D model files such as STL, OBJ, and 3MF.
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., "@creality-print-mcp Why are my supports fusing to the part?"
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.
creality-print-mcp
An MCP server that lets AI assistants (Claude, Gemini/Antigravity, Cursor…) read, audit and edit your Creality Print presets and inspect, scale and rotate 3D models.
Creality Print is a fork of OrcaSlicer, which is a fork of Bambu Studio, and all three use the same preset format. OrcaSlicer and Bambu Studio work too.
"Why are my supports fusing to the part?" → the assistant audits your process preset, shows that
support_top_z_distanceis inherited from the vendor preset and is too small for your layer height, and fixes it with a backup.
Features
Tool | What it does |
| Lists your process, filament and machine presets, each with the preset it inherits from |
| Returns a preset's effective settings, following the full |
| Flags common causes of failed prints: crossing infill hit by the nozzle, supports fusing to or scarring the part, wall bulges, rough supported surfaces. Says whether each value is yours or inherited |
| Changes one setting, with an automatic backup. Keeps list fields as lists, refuses unknown keys (typos) and identity keys |
| Undo any edit |
| Size (X/Y/Z mm), volume, watertightness and face count of |
| Uniform scaling by percent, factor or target height, into a new file |
| Rotation around X/Y/Z to improve bed contact and reduce supports, into a new file |
Why inheritance matters
Your saved presets only store what you changed. Everything else comes from the vendor preset through inherits. A tool that reads only the user file sees about 10 of the roughly 270 settings, and has to guess the rest. This server resolves the chain the same way the slicer does, including vendor-scoped lookup when several vendors share a base preset name.
Related MCP server: PrusaMCP
Requirements
Python 3.10+ and uv (recommended)
Creality Print 6/7, OrcaSlicer or Bambu Studio installed and opened at least once
Windows, macOS or Linux. The default data folders are auto-detected; development and real-data testing so far was on Windows + Creality Print 7.3
Installation
Claude Code
claude mcp add --scope user creality-print -- uvx --from git+https://github.com/MadCrow69/creality-print-mcp creality-print-mcpWindows PowerShell: PowerShell swallows the bare
--before passing the arguments toclaude, which then fails withunknown option. Run it throughcmdinstead:cmd --% /c claude mcp add --scope user creality-print -- uvx --from git+https://github.com/MadCrow69/creality-print-mcp creality-print-mcp
Claude Desktop, Antigravity, Cursor and other JSON-configured clients
{
"mcpServers": {
"creality-print": {
"command": "uvx",
"args": ["--from", "git+https://github.com/MadCrow69/creality-print-mcp", "creality-print-mcp"]
}
}
}OrcaSlicer or Bambu Studio
Add an environment variable to the entry above:
"env": { "SLICER": "orca" }Configuration
Variable | Default | Purpose |
|
|
|
| auto | Folder that contains |
|
| Where preset backups go |
Auto-detected data folders:
Slicer | Windows | macOS | Linux |
Creality Print |
|
|
|
OrcaSlicer |
|
|
|
Bambu Studio |
|
|
|
Safety
Every preset edit is preceded by a timestamped backup and written atomically.
Model tools always write a new file and refuse to overwrite the source.
Preset names are validated, so no path traversal outside the presets folder.
Close the slicer before editing presets (or restart it afterwards). An open slicer may overwrite the file when it saves its own state.
Cloud-synced presets: the server does not touch the
.infosync metadata. If cloud sync brings back an older version, userestore_backupor re-apply the change.
Development
git clone https://github.com/MadCrow69/creality-print-mcp
cd creality-print-mcp
uv sync
uv run pytest
uv run ruff check .Tests run against synthetic preset trees and never touch your real slicer data.
Roadmap
Slicing from the CLI (G-code + time and filament estimates). Creality Print 7 does not expose the OrcaSlicer CLI; OrcaSlicer does.
More audit rules (first layer, retraction, cooling per filament)
Auto-orientation suggestions for minimal supports
Publish to PyPI and the MCP Registry
Contributions are welcome. Open an issue first for larger changes.
License
Not affiliated with or endorsed by Creality, the OrcaSlicer project or Bambu Lab. Product names are trademarks of their respective owners.
Available Tools
9 toolsaudit_profileARead-only
Audit a process preset's EFFECTIVE values (inheritance resolved) for common causes of failures: nozzle hitting crossing infill, supports fusing to or scarring the part, wall bulges, rough supported surfaces.
Inputs: name (required). Returns: object
get_model_dimensionsARead-only
Load a 3D model (.stl, .obj, .3mf) and return its size in mm (X, Y, Z), volume, watertightness and face count.
Inputs: file_path (required). Returns: object
get_profileARead-only
Get a preset's settings. With resolve_inheritance=true (default) returns the EFFECTIVE values, merging the 'inherits' chain up to the vendor preset; with false returns only what the user overrode.
Inputs: name (required), profile_type, resolve_inheritance. Returns: object
list_backupsARead-only
List backups of a preset taken by set_profile_parameter / restore_backup, newest first.
Inputs: name (required), profile_type. Returns: object
list_profilesARead-only
List the user's slicer presets (process, filament and machine), each with the preset it inherits from.
Inputs: no named parameters. Returns: object
restore_backupADestructiveIdempotent
Restore a preset from a backup file name returned by list_backups. The current state is backed up first.
Inputs: name (required), backup_file (required), profile_type. Returns: object
rotate_modelAIdempotent
Rotate a 3D model into a new file, in degrees around X, then Y, then Z, to improve bed contact and reduce overhangs/supports.
Inputs: file_path (required), output_path (required), x_deg, y_deg, +1 more. Returns: object
scale_modelAIdempotent
Scale a 3D model uniformly into a new file. Pass exactly one of: percent (80 = 80%), factor (0.8 = 80%) or target_height_mm (desired Z height).
Inputs: file_path (required), output_path (required), factor, percent, +1 more. Returns: object
set_profile_parameterADestructiveIdempotent
Set one setting in a user preset. A backup is taken first (see list_backups / restore_backup). List-shaped fields (e.g. outer_wall_speed) stay lists. Keys that exist neither in the preset nor in its parents are refused as probable typos unless force=true. Identity keys (name, inherits...) are refused.
Inputs: key (required), name (required), value (required), force, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource+action: profile reads (get/list/audit), a single targeted write (set_profile_parameter), backup management (list/restore), and model operations (dimensions/scale/rotate). The only near-pair, get_profile vs audit_profile, is clearly separated by audit being a failure-mode analysis over effective values. No plausible misselection paths.
Every name follows a strict verb_noun snake_case pattern (get_profile, set_profile_parameter, list_backups, restore_backup, scale_model, rotate_model). Nouns group by domain (profile/backup/model), which reinforces the structure rather than breaking it.
Nine tools is well within the sweet spot and every tool earns its place: four profile tools, two backup tools, three model tools. No filler or redundant convenience wrappers.
The surface covers read/audit/edit of presets, full backup+restore lifecycle, and model inspect/scale/rotate, with no dead ends in the edit path. Gaps are moderate rather than severe: there is no create_profile, delete_profile, or rename, and no model translation/export, so new presets must be born in the slicer before the agent can tune them.
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.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to interact with OrcaSlicer to manage profiles, adjust printing settings, and perform slicing operations. It allows users to search settings, slice STL/3MF files, and analyze G-code metadata through natural language assistants.7AGPL 3.0
- FlicenseAqualityDmaintenanceAn intelligent 3D printing assistant that enables users to analyze meshes, generate optimal print profiles, and automate PrusaSlicer operations through an MCP client. It provides a comprehensive suite of tools for geometric analysis, printability checks, filament recommendations, and post-print diagnostics.1710-
- AlicenseAqualityBmaintenanceEnables Claude Code sessions to read and edit OrcaSlicer presets, clone profiles, inspect saved plates, and search the OrcaSlicer wiki, all without OrcaSlicer running.14AGPL 3.0
- AlicenseAqualityBmaintenanceEnables Claude to analyze STL/3MF models, slice them with the real Bambu Studio engine, compare print recipes by time and weight, and manage presets for Bambu Lab printers. It produces ready-to-print .3mf project files with material and build-plate settings applied, all locally on the user's PC.183MIT