Skip to main content
Glama
creality-print-mcp

creality-print-mcp

by MadCrow69

creality-print-mcp

Português

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_distance is inherited from the vendor preset and is too small for your layer height, and fixes it with a backup.

Features

Tool

What it does

list_profiles

Lists your process, filament and machine presets, each with the preset it inherits from

get_profile

Returns a preset's effective settings, following the full inherits chain to the vendor preset (or only your overrides)

audit_profile

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

set_profile_parameter

Changes one setting, with an automatic backup. Keeps list fields as lists, refuses unknown keys (typos) and identity keys

list_backups / restore_backup

Undo any edit

get_model_dimensions

Size (X/Y/Z mm), volume, watertightness and face count of .stl, .obj, .3mf

scale_model

Uniform scaling by percent, factor or target height, into a new file

rotate_model

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-mcp

Windows PowerShell: PowerShell swallows the bare -- before passing the arguments to claude, which then fails with unknown option. Run it through cmd instead: 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

SLICER

creality

creality, orca or bambu

SLICER_CONFIG_DIR

auto

Folder that contains user/ and system/. Use it for portable installs or to pin a Creality Print version (e.g. …\Creality Print\7.3)

CREALITY_PRINT_MCP_BACKUP_DIR

~/.creality-print-mcp/backups/<slicer>

Where preset backups go

Auto-detected data folders:

Slicer

Windows

macOS

Linux

Creality Print

%APPDATA%\Creality\Creality Print\<newest version>

~/Library/Application Support/Creality/Creality Print/<version>

~/.config/Creality/Creality Print/<version>

OrcaSlicer

%APPDATA%\OrcaSlicer

~/Library/Application Support/OrcaSlicer

~/.config/OrcaSlicer

Bambu Studio

%APPDATA%\BambuStudio

~/Library/Application Support/BambuStudio

~/.config/BambuStudio

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 .info sync metadata. If cloud sync brings back an older version, use restore_backup or 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

MIT

Not affiliated with or endorsed by Creality, the OrcaSlicer project or Bambu Lab. Product names are trademarks of their respective owners.

Available Tools

9 tools
audit_profileA
Read-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_dimensionsA
Read-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_profileA
Read-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_backupsA
Read-only

List backups of a preset taken by set_profile_parameter / restore_backup, newest first.

Inputs: name (required), profile_type. Returns: object

list_profilesA
Read-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_backupA
DestructiveIdempotent

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_modelA
Idempotent

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_modelA
Idempotent

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_parameterA
DestructiveIdempotent

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

    A4/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An 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.
      17
      10
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude Code sessions to read and edit OrcaSlicer presets, clone profiles, inspect saved plates, and search the OrcaSlicer wiki, all without OrcaSlicer running.
      14
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      18
      3
      MIT