Skip to main content
Glama
creator5-slicer-mcp

creator5-slicer-mcp

by rsutcliffe

creator5-slicer-mcp

An MCP server that lets Claude, or any MCP client, slice 3D models for the Flashforge Creator 5 with OrcaSlicer, choosing sensible quality, strength and filament settings for each job.

Say what the part is for and what filament is loaded. The server measures the model, picks the Creator 5 presets, adjusts walls, infill, shells, supports and brim, runs the slicer, and returns the G-code with a time and filament estimate and the reasoning behind each choice.

It is a thin layer over the slicer's own command line. It is not a fork of OrcaSlicer, so there is no C++ to build and slicer updates need no merging.

Status: early. Confirmed with Flash Studio 1.7 on macOS: choosing settings, slicing, and opening the result as a project that Flash Studio slices and sends to the printer. A finished print from these settings has not yet been assessed. send_to_printer over the LAN is untested; print from Flash Studio instead. See docs/HANDOVER.md.

What you need

  • macOS, Windows or Linux

  • Python 3.10 or newer

  • Flashforge's Flash Studio (formerly Orca-Flashforge), or an OrcaSlicer build whose Flashforge presets are plain JSON files. OrcaSlicer 2.5 packs its presets into .opc files, which this server cannot read; with both installed, Flash Studio is used

  • A Flashforge Creator 5 or Creator 5 Pro

Related MCP server: PrusaMCP

Install

With uv there is nothing to install by hand. Add this to your MCP client's configuration. For Claude Desktop that is claude_desktop_config.json:

{
  "mcpServers": {
    "creator5-slicer": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rsutcliffe/creator5-slicer-mcp", "creator5-slicer-mcp"],
      "env": {
        "C5_PRINTER_IP": "192.168.1.50",
        "C5_PRINTER_SERIAL": "your-serial-number",
        "C5_PRINTER_CHECK_CODE": "your-check-code"
      }
    }
  }
}

For Claude Code:

claude mcp add creator5-slicer -- uvx --from git+https://github.com/rsutcliffe/creator5-slicer-mcp creator5-slicer-mcp

Or install it yourself and point the client at the creator5-slicer-mcp command:

pipx install git+https://github.com/rsutcliffe/creator5-slicer-mcp

The three C5_PRINTER_* values are only needed for sending files to the printer. Leave the env block out to slice only.

Install from a local clone

Use this route if you want to edit the settings tables. None of these commands need quotation marks.

git clone https://github.com/rsutcliffe/creator5-slicer-mcp
cd creator5-slicer-mcp
./scripts/setup.sh

setup.sh does everything in one go and is safe to run again to update: it pulls the latest code, installs it into .venv, slices a test cube with your real slicer, and only if that passes registers the server with Claude Desktop and Claude Code. The full output is saved to setup_report.txt.

The individual steps, if you prefer to run them by hand:

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/python scripts/smoke_test.py
.venv/bin/python scripts/install_claude_desktop.py

smoke_test.py slices a 20 mm cube with your real slicer and prints the result. If it fails, the message names the log file to look at.

install_claude_desktop.py adds the server to Claude Desktop's configuration. It keeps your existing settings, saves a backup first, and is safe to run again. Quit and reopen Claude Desktop afterwards.

Configuration

Variable

Purpose

Default

ORCA_SLICER_PATH

Slicer executable

found automatically: the first of OrcaSlicer, Flash Studio or Orca-Flashforge with readable presets

ORCA_PROFILES_DIR

Folder containing Flashforge/ and OrcaFilamentLibrary/

the slicer's bundled profiles folder

C5_OUTPUT_DIR

Where jobs are written

~/Creator5Prints

C5_PRINTER_IP

Printer address on your network

none

C5_PRINTER_SERIAL

Printer serial number

none

C5_PRINTER_CHECK_CODE

LAN check code shown on the printer

none

Tools

Tool

What it does

check_setup

Confirms the slicer, the Creator 5 presets and the printer details are in place

list_filaments

Lists the filament types understood and the presets installed

analyse_model

Measures an STL: size, volume, bed contact, overhangs, fit on the 256 mm bed

recommend_settings

Returns the chosen presets and settings with reasons, without slicing

slice_model

Analyses, chooses settings, slices, and returns G-code with time and filament estimates

open_in_slicer

Opens the result in the slicer window to inspect and print from there

printer_status

Reads the printer's state over the local network (experimental)

send_to_printer

Uploads a sliced file; starts the print only when asked (experimental)

The main inputs

  • filament: plain words, such as black PLA, PETG, silk PLA, TPU 95A, ASA

  • quality: draft, standard or fine

  • strength: decorative, standard, functional or structural

  • nozzle: 0.25, 0.4, 0.6 or 0.8

  • supports, brim: auto, on or off

  • nozzle_temp, bed_temp, max_speed: figures from the spool's label, for filament from other makers

Anything else in OrcaSlicer is reachable through process_overrides and filament_overrides.

docs/SETTINGS.md lists every value the server sets and the reasoning.

Example

Slice ~/Models/controller_holder.stl in black PLA. It is a wall bracket that carries a game controller, so make it strong. Two copies.

Claude calls slice_model with filament="black PLA", strength="functional", copies=2, and reports back something like:

Preset      0.20mm Standard @FF C5, Flashforge PLA Basic @FF C5
Walls       4        Infill  25% gyroid
Top/bottom  6 / 5 layers
Supports    off (no significant overhangs found)
Output      ~/Creator5Prints/20261115_141500_controller_holder/plate_1.gcode

From the terminal

The same engine without an MCP client. No quotation marks are needed.

.venv/bin/python -m creator5_mcp.cli MODEL.stl --filament ender-pla --strength functional --copies 2 --usb

--open shows the layer preview, --usb copies the G-code to the USB stick that is plugged in, --send uploads it to the printer and --print uploads and starts. Save the printer's network details once with --save-printer IP SERIAL CHECKCODE.

Printing the result

slice_model writes a project file (project_3mf) and open_in_slicer opens it in Flash Studio with the model and every setting loaded. Press Slice, then Print. This is the normal route.

The slicer's G-code preview is view-only, so do not open the .gcode. Two other routes exist but are not needed:

  1. USB stick: copy the .gcode across (--usb does this) and start it from the printer's screen. Always works.

  2. Network: send_to_printer, or --send / --print, uploads using the printer's LAN mode. Experimental. It only uploads unless told to start.

Limits in this version

  • Single-material jobs on toolhead 1. Multi-colour and multi-material plates are not yet handled.

  • Shape analysis reads STL only. 3MF, STEP and OBJ still slice, with supports off unless you ask for them.

  • The recommended values are reasoned starting points, not measured optima. See docs/SETTINGS.md.

  • The LAN upload follows OrcaSlicer's Flashforge print host and has not been confirmed on hardware.

Development

pip install -e ".[dev]"
pytest
# also check every filament type against real OrcaSlicer presets:
ORCA_TEST_PROFILES_DIR=/path/to/OrcaSlicer/resources/profiles pytest

Licence and credits

MIT. See LICENSE.

This project runs OrcaSlicer as a separate program and reads the preset files installed with it; it contains no OrcaSlicer code. OrcaSlicer is developed by the OrcaSlicer contributors under AGPL-3.0. Flashforge and Creator 5 are trademarks of their owner. This project is independent and is not endorsed by either.

Available Tools

8 tools
analyse_modelA

Measure an STL: size, volume, bed contact, overhangs and whether it fits the 256 mm bed.

Args: model_path: Absolute path to the model file on this computer.

Inputs: model_path (required).

check_setupB

Report whether the slicer, its Creator 5 presets and the printer connection are ready.

Inputs: no named parameters.

list_filamentsA

List the filament types this server understands and the Creator 5 presets installed.

Args: nozzle: Nozzle diameter in mm: 0.25, 0.4, 0.6 or 0.8. pro: True for the Creator 5 Pro.

Inputs: pro, nozzle.

open_in_slicerA

Open a project in the slicer's window, ready to slice and print.

Pass the project_3mf path returned by slice_model. The slicer shows the model with all the chosen settings applied, and its own Slice and Print buttons work as usual. A .gcode file opens as a view-only preview that cannot be printed.

Args: path: Absolute path to the .3mf project (preferred), or a .gcode or model file.

Inputs: path (required).

printer_statusB

Read the Creator 5's current state over the local network (experimental).

Inputs: no named parameters.

recommend_settingsA

Choose presets and settings for a print without slicing, with the reasoning for each choice.

Args: filament: Filament as the user describes it, e.g. "black PLA", "PETG", "TPU 95A", "silk PLA". model_path: Optional absolute path to the STL, so supports and brim respond to its shape. quality: draft, standard or fine. Sets layer height and outer wall care. strength: decorative, standard, functional or structural. Sets walls, infill and shells. nozzle: Nozzle diameter in mm: 0.25, 0.4, 0.6 or 0.8. supports: auto, on or off. brim: auto, on or off. layer_height: Exact layer height in mm, or 0 to let quality decide. precise_fit: True for parts that must mate with other parts. smooth_top: True to iron flat top surfaces. pro: True for the Creator 5 Pro. nozzle_temp: Nozzle temperature in C from the spool's label, or 0 to use the preset. bed_temp: Bed temperature in C from the spool's label, or 0 to use the preset. max_speed: Fastest print speed in mm/s the spool's label recommends, or 0 for no extra limit.

Inputs: filament (required), pro, brim, nozzle, +10 more.

send_to_printerA

Upload a sliced file to the Creator 5 over the local network (experimental).

By default the file is only uploaded. Set start_print=True only after the user has confirmed the bed is clear and the right filament is loaded in toolhead 1.

Args: gcode_path: Absolute path to the .gcode or .3mf produced by slice_model. start_print: Start printing straight after upload. level_bed: Run bed levelling before the print starts.

Inputs: gcode_path (required), level_bed, start_print.

slice_modelA

Slice a model for the Creator 5 with settings chosen for the filament and purpose.

Returns a project file (project_3mf) to open in the slicer and print from, the G-code path, print time, filament use, the settings applied with reasons, and any warnings to pass on to the user.

Args: model_path: Absolute path to an STL, 3MF, STEP or OBJ file on this computer. filament: Filament as the user describes it, e.g. "black PLA", "PETG", "TPU 95A". quality: draft, standard or fine. strength: decorative, standard, functional or structural. nozzle: Nozzle diameter in mm: 0.25, 0.4, 0.6 or 0.8. supports: auto, on or off. brim: auto, on or off. layer_height: Exact layer height in mm, or 0 to let quality decide. precise_fit: True for parts that must mate with other parts. smooth_top: True to iron flat top surfaces. copies: Number of copies to arrange on the plate. auto_orient: Let the slicer rotate the part. Leave False when the model is already oriented for strength. process_overrides: Extra OrcaSlicer process settings applied last, e.g. {"wall_loops": 5}. filament_overrides: Extra OrcaSlicer filament settings, e.g. {"nozzle_temperature": 215}. job_name: Name for the output folder and files. pro: True for the Creator 5 Pro. nozzle_temp: Nozzle temperature in C from the spool's label, or 0 to use the preset. bed_temp: Bed temperature in C from the spool's label, or 0 to use the preset. max_speed: Fastest print speed in mm/s the spool's label recommends, or 0 for no extra limit.

Inputs: filament (required), model_path (required), pro, brim, +15 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 8 tools

    Disambiguation4/5

    The tools split into setup/inspection (check_setup, list_filaments, printer_status), planning (analyse_model, recommend_settings) and execution (slice_model, open_in_slicer, send_to_printer), so most purposes are distinct. There is some overlap around readiness and presets between check_setup, list_filaments and printer_status, and recommend_settings versus slice_model share many arguments, but the descriptions clarify the intended boundaries.

    Naming Consistency4/5

    Most names follow a verb_noun pattern: check_setup, list_filaments, analyse_model, recommend_settings and slice_model. The deviations are printer_status (a noun phrase) and open_in_slicer/send_to_printer (verb_to_noun), but the overall convention is still predictable and readable.

    Tool Count5/5

    Eight tools is well-scoped for a slicer/printer workflow, with each tool mapping to a clear stage: setup check, filament listing, model analysis, recommendation, slicing, opening, status and sending. There are no obvious filler tools.

    Completeness4/5

    The surface covers the main lifecycle from setup verification and model analysis through slicing, opening in the slicer and sending to the printer. Minor gaps remain around print-job control such as pause/cancel/progress, and the experimental status/send tools may force agents back to the slicer UI or printer controls for job management.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables interaction with 3D printer management systems through an MCP server, supporting STL file manipulation, slicing, and control of printers like OctoPrint, Klipper, Duet, and more.
      30
      5,162 npm
      266
      GPL 2.0
    • 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
      Not graded
      quality
      B
      maintenance
      Exposes MCP tools that slice models with headless OrcaSlicer, stage gcode on Moonraker-based Klipper printers, gate job starts behind explicit operator authorization, and report status, telemetry-derived events, snapshots, and alerts. It also manages spools and lets AI agents query job estimates, blockers, and start-precondition checks.
      1
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to inspect FreeCAD documents and export named solids to STL, find and derive OrcaSlicer presets, preview and run slices with recorded manifests, and then read G-code metadata, query a Moonraker printer, upload G-code, and start an uploaded print as a separate confirmed step.
      15
      MIT