RRS OrcaSlicer MCP
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., "@RRS OrcaSlicer MCP slice benchy.3mf using my PLA profile and save the G-code"
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.
Neu in 0.5.1: 63 MCP-Werkzeuge. Einzel-Slicing mit optionalem Wiederholungsschlüssel und Prüfung der Modell-/Profilinhalte.
job_logliest Protokolle mit fortsetzbarem Byte-Cursor;job_waitwartet begrenzt auf Ergebnisse. Paket · Ablauf und Geschäftsregeln · Abnahme.
Neu in 0.5.0: 61 MCP-Werkzeuge. Gezielte Live-Transformationen mit nativer Undo-/Redo-Historie, editierbarer Text/Embossing und originale Kalibrierungsgeneratoren über Orcas sichtbare Bedienoberfläche. Der Server bleibt separat und Orca unverändert. Paket · Einrichtung, Umfang und Grenzen. Der erste Selector-Pack benötigt englische Oberfläche, Standardkürzel, Tesseract und den Desktop-Opt-in.
RRS-ORCASLICER-MCP
Separate MCP-Schnittstelle für OrcaSlicer. OrcaSlicer bleibt unverändert installiert;
der Server läuft daneben auf demselben Computer. Windows, macOS und Linux werden
auf Python-Ebene unterstützt. Der echte Slicing-Nachweis dieser Veröffentlichung
wurde mit der offiziellen Linux-Version 2.4.2 durchgeführt. Das optionale
Host-Plugin und die nativen Abläufe werden in der offiziellen Linux-Nightly geprüft;
den exakten Build und die Ergebnisse enthält docs/evidence/host-0.5.0.json im Paket.
Neu in 0.3.0: Plugin für Orcas offiziellen Python-Host
39 MCP-Werkzeuge. Das optionale rrs_orcaslicer_bridge.py verbindet den externen
Server über Orcas offizielles Python-Plugin-System mit der laufenden Anwendung:
Live-Presets lesen/ändern, Modellinformationen lesen und ungespeicherte Projekte
als neue 3MF-Kopie exportieren. Presetänderungen gehen durch Orcas native
Transaktionen und bleiben bis zum normalen Speichern ungespeichert.
Das Plugin wird separat installiert und über Plugins > Run gestartet. Der
Server bleibt eigenständig; ältere Orca-Versionen können die bisherigen CLI-/Datei-
Werkzeuge weiter verwenden. Das eingebettete Plugin braucht eine kompatible
2.5-Entwicklungsversion. Die Anzeige host_bridge_status meldet die verfügbare API.
Eine vollständige Steuerung von Bemalung, Kalibrierung oder Geräten wird dadurch
nicht behauptet.
Installation und Protokoll · Code-/Businesslogik-Prüfung für Maintainer · Funktionsabdeckung
Related MCP server: print-warden
Neu in 0.2.0
30 MCP-Werkzeuge: direkte Objekt-/Teil-/Platteneinstellungen, Profilvergleich und Vorprüfung, unabhängiger Profilexport, G-Code-Zusammenfassungen sowie Stapel-Slicing mit Wiederholungsschutz und Abbruch. Die bestehende 0.1.1-Anbindung bleibt erhalten.
Noch keine vollständige API für jede Orca-Funktion. Die tatsächliche Abdeckung,
GUI-Funktionen und noch nicht integrierten Funktionen sind in
FEATURE_COVERAGE.md und per feature_coverage ausgewiesen.
Der vorbereitete Kontakt zum OrcaSlicer-Team nennt die
passende offizielle Plugin-Diskussion. Dort wurde noch nichts gepostet.
Was lässt sich steuern?
Bereich | Unterstützung |
Kommandozeile | Alle von der installierten Version in |
Slicing | Ein oder mehrere Modelle/Projekte, Plattenauswahl, Maschinen-/Prozess-/Filamentprofile, G-Code und 3MF |
Modelloperationen | Alle verfügbaren CLI-Transformationen, z. B. Skalieren, Drehen, Anordnen, Kopien, Ausrichten und Export |
Einstellungen | Beliebige JSON-Schlüssel und Werte; neue/unbekannte Schlüssel werden erhalten |
Profile | Drucker, Filamente, Prozesse, Vererbung, Suche, gesicherte Änderungen |
3MF | Projektsettings sowie vorhandene JSON/XML-Metadaten für Objekte und Platten; Modelle, Bemalung und unbekannte Inhalte bleiben erhalten; alte Slicing-Caches werden entfernt |
Live-Host | Optionales Script-Plugin: Presets lesen/ändern, Modell abfragen, Projektkopie exportieren |
Native Abläufe (0.5.0) | Live-Verschieben/Drehen/Skalieren, Undo/Redo, editierbarer Text und neun Kalibrierungsgenerator-Familien; geprüfte Umgebung und Varianten im Paketnachweis |
Oberfläche | Optional: Starten, Fokussieren, Screenshot, Maus, Tastatur und Unicode-Texteingabe |
Aufträge | Warteschlange, Protokoll, Status, Zeitlimit, Prozessabbruch, Zustand nach Neustart |
Grenze: OrcaSlicer stellt keine vollständige externe API für sämtliche GUI-Funktionen bereit. Die typisierten nativen Abläufe und ihre Ergebnisprüfung stehen in NATIVE_WORKFLOWS.md. Der optionale allgemeine Desktopzugriff auf weitere Oberflächenfunktionen wie Live-Bemalung und manuelle Stützen hat keinen vergleichbaren automatisierten Funktionsnachweis. Die nativen Tests gelten für die aufgezeichnete Linux-X11-/Orca-Version und den englischen Selector-Pack. Drucker-Anmeldung, Netzwerktreiber und Cloudfunktionen bleiben Sache von OrcaSlicer. Erfolgreiches Slicing startet keinen physischen Druck.
Eine Garantie für jede vergangene oder zukünftige Orca-Version ist technisch nicht möglich. Die Schnittstelle erkennt CLI-Fähigkeiten zur Laufzeit, erhält unbekannte Daten und verweigert nicht angebotene Optionen. Die 966 Katalogdefinitionen stammen aus einem dokumentierten Quellstand, nicht aus einer pauschalen Versionsgarantie. Siehe Kompatibilität.
Schnellinstallation
Voraussetzungen: Python 3.11 oder neuer und eine separat installierte offizielle OrcaSlicer-Version. Releasepaket entpacken oder Repository klonen.
Windows
In PowerShell im entpackten Ordner:
.\scripts\Install-Windows.ps1 -OrcaBin 'C:\Program Files\OrcaSlicer\orca-slicer.exe' -Workspace 'C:\OrcaMCP' -DesktopDas Skript erstellt eine eigene Python-Umgebung und mcp-config.json. Ohne -Desktop
wird nur die CLI-/Dateianbindung installiert. Alternativ:
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install '.[desktop]'
.\.venv\Scripts\python.exe scripts\make_config.py --binary 'C:\Program Files\OrcaSlicer\orca-slicer.exe' --root 'C:\OrcaMCP' --desktopmacOS / Linux
bash scripts/install.sh
.venv/bin/python scripts/make_config.py \
--binary /Applications/OrcaSlicer.app/Contents/MacOS/OrcaSlicer \
--root "$HOME/OrcaMCP"Unter Linux als --binary den Pfad zur AppImage-Datei oder zum installierten
orca-slicer angeben. Für Desktopsteuerung zuerst pip install '.[desktop]'
innerhalb der Umgebung ausführen und --desktop ergänzen. Linux benötigt X11,
xdotool, ein Screenshot-Backend und eine Zwischenablage (z. B. xclip). Wayland
wird für Desktopaktionen nicht unterstützt. macOS benötigt Bedienungshilfen- und
Bildschirmaufnahmeberechtigungen; Windows einen entsperrten Benutzerdesktop.
MCP-Client verbinden
Den Inhalt von mcp-config.json in einen MCP-Client mit lokalem stdio-Support
übernehmen, z. B. Claude Desktop, Claude Code oder einen passenden lokalen Agenten.
Ein Beispiel:
{
"mcpServers": {
"rrs-orcaslicer": {
"command": "C:\\OrcaMCP\\RRS-ORCASLICER-MCP\\.venv\\Scripts\\python.exe",
"args": ["-m", "rrs_orcaslicer_mcp.server"],
"env": {
"ORCA_SLICER_BIN": "C:\\Program Files\\OrcaSlicer\\orca-slicer.exe",
"ORCA_MCP_ROOTS": "C:\\OrcaMCP",
"ORCA_MCP_STATE": "C:\\OrcaMCP\\state",
"ORCA_MCP_DESKTOP": "0"
}
}
}
}Dies ist ein lokaler Server, kein direkt aus der ChatGPT-Weboberfläche erreichbarer HTTPS-Connector. Ein solcher benötigt zusätzlich einen gesonderten, authentifizierten Gateway; dieser ist nicht Teil dieses Pakets.
Weitere Ordner mit make_config.py --root ergänzen, z. B. Orcas Benutzerprofile und
resources/profiles. Ordnerlisten in ORCA_MCP_ROOTS sind unter Windows durch ;,
unter macOS/Linux durch : getrennt. Der erste Ordner ist die Basis relativer
Dateipfade. ORCA_MCP_STATE muss pro gleichzeitigem Server verschieden sein.
Erste Verwendung
orca_capabilitiesaufrufen: ausführbare Datei, verfügbare CLI-Optionen und Desktopstatus prüfen.Mit
workspace_list,profiles_listundsettings_readModelle/Profile auswählen.Ein selbstständiges Orca-3MF verwenden oder vollständige, aufgelöste Profile bereitstellen.
slice_projectstarten und mitjob_statusbis zum Endstatus prüfen.G-Code/Statistiken mit
artifact_readprüfen. Für GUI-Aktionen vorher/nachher Screenshots auswerten.
Beispiel für slice_project:
{
"inputs": ["C:\\OrcaMCP\\teil.3mf"],
"output_directory": "C:\\OrcaMCP\\output",
"plate": 0,
"export_3mf": "teil-gesliced.3mf"
}export_3mf ist ein Dateiname innerhalb des Ausgabeordners. plate: 0 bedeutet
alle Platten. CLI-Aufträge laufen in eigenen Jobordnern; rohe cli_run-Aufrufe
benötigen absolute Eingabe-/Profilpfade und müssen Orcas Exportregeln beachten.
Bei Einstellungen die Orca-Darstellung beibehalten: viele Zahlen sind als Strings
gespeichert, Filamentwerte häufig als Listen von Strings. Vor Änderungen lesen;
bestehende JSON-Dateien benötigen den aktuellen SHA256-Wert. Eine Sicherung wird
angelegt. Bei 3MF-Änderungen werden bestehender G-Code und zugehörige Slicing-Caches
entfernt; die neue Datei muss erneut geslicet werden. Laufende Orca-Instanzen können Profile überschreiben: Orca zum Bearbeiten
aktiver Profile schliessen oder eine neue Datei speichern und importieren.
profile_resolve löst Werte auf; beim Export eines flachen Profils inherits
entfernen. Gleiche Elternnamen in mehreren Suchordnern werden als Konflikt gemeldet.
Diagnose und Entwicklung
python -m rrs_orcaslicer_mcp.server --doctor --output doctor.json
python -m pip install -e '.[test]'
python -m pytest -q
python -m ruff check src scripts tests
python scripts/package.py--doctor benötigt dieselben Umgebungsvariablen wie der Client. Im stdio-Betrieb
bleibt stdout für MCP reserviert; Diagnose wird nur im separaten Doctor-Modus ausgegeben.
Der Quellkatalog lässt sich jederzeit aus einem separaten offiziellen Checkout neu erzeugen; es werden keine Orca-Binärdateien in diesem Repository mitgeliefert:
git clone https://github.com/OrcaSlicer/OrcaSlicer.git ../OrcaSlicer
python scripts/sync_catalog.py ../OrcaSlicerBusinesslogik und Architektur · Werkzeugreferenz · Testnachweis · Arbeitsstand
Lizenz: AGPL-3.0-or-later. Unabhängiges Projekt; keine offizielle OrcaSlicer-Erweiterung. Herkunft des Katalogs und Lizenzhinweise stehen in NOTICE.
Available Tools
63 toolsartifact_readC
Read a bounded chunk of generated G-code, JSON statistics or logs as text.
Inputs: path (required), limit_bytes, offset_bytes. Returns: object
batch_cancelB
Cancel active/queued work in a batch and keep successful results unchanged.
Inputs: batch_id (required). Returns: object
batch_sliceA
Slice up to 64 inputs independently with durable, retry-safe batch identity.
Reusing a key with unchanged inputs returns existing jobs; changed contents cause a conflict. Each input has its own output folder and sliced 3MF. Interrupted/failed work is never silently repeated; use a new key to retry it.
Inputs: inputs (required), idempotency_key (required), output_directory (required), plate, +3 more. Returns: object
batch_statusB
Aggregate durable batch status and per-input job IDs after reconnecting.
Inputs: batch_id (required). Returns: object
calibration_series_createA
Create resumable temperature/flow_ratio/pressure_advance/max_volumetric_speed coupons.
Uses the supplied calibration model in a 3MF, one constant-setting project per value. Preserves other filament slots. PA is explicitly enabled for its slot. This does not generate Orca's native towers, select a winner or start a print. Use batch_slice on the completed paths. Inspect/measure coupons before applying a selected result to a profile with the existing settings/profile tools.
Inputs: kind (required), source (required), values (required), destination_directory (required), +2 more. Returns: object
cli_runA
Queue any advertised long CLI flags with ordered raw argv (no shell).
Supports all CLI actions in the installed version, not GUI-only functions. Inputs, profiles and outputs should use absolute paths. This trusted local tool runs Orca with your OS privileges; file-root checks do not sandbox CLI.
Inputs: arguments (required), timeout_seconds. Returns: object
desktop_actionB
Visual GUI interaction: click/double_click/right_click/move/drag/scroll/keys/text.
Inspect screenshots before/after. Coordinates use the full desktop screenshot. OrcaSlicer must be foreground. Dialogs and permissions may need local handling.
Inputs: action (required), x, y, keys, +2 more. Returns: object
desktop_focusA
Bring a single existing OrcaSlicer window to the foreground.
Inputs: no named parameters. Returns: object
desktop_launchA
Launch the installed GUI, optionally opening a local project; requires desktop opt-in.
Inputs: project. Returns: object
desktop_screenshotC
Inspect foreground OrcaSlicer on the optional local desktop.
Inputs: no named parameters.
feature_coverageB
Report supported feature families and explicit GUI/API gaps without claiming 100%.
Inputs: no named parameters. Returns: object
gcode_analyzeB
Summarize declared time/material/layers, selected settings and temperature commands.
Inputs: path (required). Returns: object
host_bridge_statusB
Inspect the running official-host plugin, session ID and advertised operations.
Inputs: no named parameters. Returns: object
host_model_detailA
Read volumes, types, poses, material slots and instances for a known live object ID.
Use host_model_read first. Rotations are radians and offsets millimeters. Values are copied on the GUI thread; no native handles leave the callback.
Inputs: index (required), object_id (required), limit, offset. Returns: object
host_model_readC
Read live objects, IDs, parts/instance counts and existing painting flags.
Inputs: limit, offset. Returns: object
host_plugin_exportC
Write the standalone official-host plugin to a new file for local installation.
Inputs: destination (required). Returns: object
host_preset_readC
Read serialized live preset values, including unsaved edits; redact secret keys.
Inputs: kind (required), keys, name, limit, +1 more. Returns: object
host_presets_listB
List the running host's loaded process, printer or filament presets.
Inputs: kind (required), limit, query, offset. Returns: object
host_preset_updateB
Stage/commit live settings through the official host transaction API.
Requires the current session ID and an explicit UUID hex request ID. Changes stay unsaved. Native selection/unsaved-edit dialogs are never suppressed. A timeout is indeterminate: query the receipt instead of repeating the edit.
Inputs: kind (required), changes (required), request_id (required), session_id (required), +3 more. Returns: object
host_printer_readB
Read selected printer agent/link/online/firmware if exposed. No credentials or commands.
Inputs: no named parameters. Returns: object
host_project_exportB
Export the live project with unsaved settings as a new 3MF copy.
Destination must be in ORCA_MCP_ROOTS and the plugin's export_roots. Does not change the project's saved filename/state. Existing destinations are rejected.
Inputs: request_id (required), session_id (required), destination (required), timeout_seconds. Returns: object
host_request_statusB
Read an execution receipt, including after a client timeout or host restart.
Inputs: request_id (required), session_id (required). Returns: object
host_slicing_eventsA
Read bounded native pipeline events after a sequence cursor, including dropped-event gaps.
Select RRS MCP slicing observer in the process preset slicing_pipeline_plugin first. Compare epoch on reload. Events describe stages, not progress percentage.
Inputs: after, limit. Returns: object
host_snapshotB
Read live app version, dirty states, selected presets and scene object count.
Inputs: no named parameters. Returns: object
job_cancelB
Cancel queued/running work and terminate its process tree.
Inputs: job_id (required). Returns: object
job_logA
Read saved CLI output from a byte cursor; reuse next_offset on reconnect.
Each response is bounded to 100000 bytes; saved logs are capped at 10 MiB. at_end means caught up with the observed bytes, not that slicing finished.
Inputs: job_id (required), offset, limit_bytes. Returns: object
jobs_listB
List recent persisted jobs, including interrupted work after restarts.
Inputs: limit. Returns: result
job_statusB
Read durable job state, output files and bounded log tail.
Inputs: job_id (required), log_tail_bytes. Returns: object
job_waitB
Wait up to 30 seconds for a saved job; timeout does not cancel slicing.
Returns the durable state; queued/running means call again. Restarted jobs remain interrupted and are never automatically repeated.
Inputs: job_id (required), timeout_seconds. Returns: object
mesh_inspectB
Measure an STL/PLY: bounds, volume, triangles, watertightness. Needs [geometry].
Inputs: source (required), expected_source_sha256 (required). Returns: object
mesh_operationA
Offline mesh repair/split/cut/merge/union/difference/intersection/hull/simplify/transform.
sources: [{path,sha256}]. action convex_hull for hull. cut takes origin/normal XYZ vectors and optional cap (true); simplify takes face_count; transform takes a 4x4 column-vector affine matrix. Inputs STL/PLY, outputs new STL files in a new directory with measured result/checkpoint. Requires [geometry]. STL units assumed millimeters. Reimport output into Orca; settings and facet painting do not transfer.
Inputs: action (required), sources (required), destination_directory (required), parameters. Returns: object
native_calibrationA
Invoke Orca's actual native calibration generator, not independent coupon sweeps.
kind temperature (start/end, native fixed 5 C steps), pressure_advance (start/end/step, method tower/line/pattern), max_volumetric_speed, retraction, vfa (start/end/step), cornering (start/end), flow_ratio (test pass_1/pass_2/yolo/ yolo_perfectionist), input_shaping_frequency (x_start/x_end/y_start/y_end), input_shaping_damping (freq_x/freq_y/start/end). Firmware-specific dialogs must match visible expected controls. Back up unsaved project and explicitly replace_scene=true; export generated native 3MF. Never starts a print.
Inputs: kind (required), backup (required), values (required), request_id (required), +4 more. Returns: object
native_historyA
Apply actual Orca undo/redo, 1..20 explicit native history steps, and read the result.
Operates on Orca's native history, including manual edits. A workflow may create multiple native steps. No file-level pseudo-undo or automatic retries. Requires the foreground Prepare mainframe and a fresh observed scene revision.
Inputs: direction (required), request_id (required), session_id (required), expected_revision (required), +1 more. Returns: object
native_request_statusB
Read persistent typed native GUI receipt and screenshot/backup paths without repeating input.
Inputs: request_id (required). Returns: object
native_scene_readA
Read copied live scene identities/poses/settings and an observed revision for typed GUI edits.
Revision is not a full mesh-content hash. Requires the running official bridge plugin; no desktop input occurs.
Inputs: no named parameters. Returns: object
native_textA
Use Orca's editable native text/emboss tool: join, cut (engrave) or modifier.
Requires one object/instance and foreground English Prepare UI. Saves the unsaved project to backup first. Both paths must be new .3mf files inside configured client/host export roots. Exports and verifies editable native text metadata, height and depth; this is not a faceted text STL substitute.
Inputs: mode (required), text (required), backup (required), depth_mm (required), +5 more. Returns: object
native_transformA
Edit Orca's live native gizmo and verify actual model pose; native Undo is retained.
kind move: value is relative millimeters; rotate: relative degrees; scale: target percent on the chosen x/y/z control (Orca's current uniform lock applies). Requires one object/instance, English mm UI and foreground Prepare mainframe. Opt in with ORCA_MCP_DESKTOP=1 and install [desktop] plus system Tesseract. Read native_scene_read and host_bridge_status first. Request IDs are 32 hex.
Inputs: axis (required), kind (required), value (required), request_id (required), +2 more. Returns: object
native_ui_capabilitiesB
Inspect opt-in native workflow routes and their platform/locale/scene limits.
Inputs: no named parameters. Returns: object
orca_capabilitiesC
Detect installed CLI flags, version/help text and desktop availability.
Inputs: refresh. Returns: object
printer_capabilitiesA
List explicit configured Moonraker/OctoPrint hosts. Configure ORCA_MCP_PRINTERS JSON.
Inputs: no named parameters. Returns: object
printer_commandA
Send an explicit physical printer command: start/pause/resume/cancel.
start requires an uploaded remote_name; upload never starts a print. Use a fresh 32-hex request_id only for a new authorized action. Reuse it to retrieve acknowledgement after interruption. Query actual state afterward.
Inputs: action (required), printer_id (required), request_id (required), remote_name. Returns: object
printer_request_statusC
Retrieve durable printer dispatch receipt without repeating the command.
Inputs: request_id (required). Returns: object
printer_statusB
Query actual configured printer/job state without issuing machine commands.
Inputs: printer_id (required). Returns: object
printer_uploadA
Upload checksum-bound text G-code without starting it. request_id is 32 hex digits.
The provider may replace an existing remote filename. Use a unique name. A repeated request ID returns its receipt; uncertain dispatch is never retried.
Inputs: source (required), printer_id (required), request_id (required), remote_name (required), +1 more. Returns: object
profile_exportC
Create a new flattened user profile with inherited values and no parent dependency.
Inputs: name (required), source (required), destination (required), search_directories (required), +1 more. Returns: object
profile_resolveC
Resolve inherited JSON values; reject cycles and ambiguous parent names.
Inputs: path (required), search_directories (required). Returns: object
profiles_listC
Discover printer, filament and process profiles below a configured root.
Inputs: directory (required), limit, query, offset. Returns: object
project_geometry_readC
Inspect mesh IDs, component references and build transforms in a 3MF member.
Inputs: path (required), limit, member, offset. Returns: object
project_inspectC
List 3MF members and read JSON/text metadata, including per-object XML.
Inputs: path (required), metadata_member. Returns: object
project_metadata_writeA
Replace existing JSON/XML Metadata in a new 3MF, including object/plate settings.
Read the original member first. This is an expert format-level operation; XML/JSON syntax is checked, but OrcaSlicer validates semantics when reopened.
Inputs: text (required), source (required), destination (required), metadata_member (required), +1 more. Returns: object
project_objects_readC
Read objects, part IDs, plates and instance assignments as structured settings.
Inputs: path (required). Returns: object
project_painting_readC
Read triangle IDs, indices and support/seam/material/fuzzy paint trees.
Inputs: source (required), object_id (required), limit, member, +1 more. Returns: object
project_painting_writeA
Paint explicit triangles in a NEW 3MF, preserving other channels and topology.
kind: support/seam/material/fuzzy_skin. Each change has triangle (0-based) and either state (0 none, 1 enforcer, 2 blocker; material 1..16 filament slot), or mask (validated Orca hex subdivision tree; null clears channel). Inspect member/object IDs and SHA first. Affects all uses of that mesh.
Inputs: kind (required), source (required), changes (required), object_id (required), +3 more. Returns: object
project_settings_writeC
Write project settings to a new 3MF; preserve meshes, painting and unknown members.
Inputs: source (required), changes (required), destination (required), expected_source_sha256 (required), +1 more. Returns: object
project_target_settings_writeA
Set object/part or plate print settings in a new 3MF using stored IDs.
target is object or plate. Values are Orca's serialized strings. Geometry, identity and cached G-code references are protected. Reslicing is required.
Inputs: source (required), target (required), changes (required), target_id (required), +4 more. Returns: object
project_transform_writeA
Set a build/component affine transform in a NEW 3MF; original and painting survive.
Matrix uses 3MF's 12-number row-vector order: 3x3 linear part then XYZ translation in model units. Component changes affect ALL referencing instances. Read project_geometry_read and source SHA first. Requires reslicing/reopening.
Inputs: matrix (required), source (required), destination (required), expected_source_sha256 (required), +4 more. Returns: object
settings_catalogC
Search source-derived setting names, types, labels, enums and ranges (hints).
Inputs: limit, query, offset. Returns: object
settings_compareC
Compare serialized profiles exactly; report added, removed and changed keys.
Inputs: left_path (required), right_path (required). Returns: object
settings_readB
Read any JSON profile or Orca preferences file with revision SHA256.
Inputs: path (required). Returns: object
settings_validateB
Advisory check of source-known types, ranges and enums; not engine validation.
Inputs: values (required). Returns: object
settings_writeA
Create/merge arbitrary settings, preserving unknown keys; backup existing files.
Existing files require current expected_sha256. Keep Orca's serialized value representation, commonly strings and lists of strings. Close Orca before editing live user profiles, or save a new profile and import it in the GUI.
Inputs: path (required), changes (required), remove, expected_sha256. Returns: object
slice_projectA
Slice 3MF/STL/STEP inputs using the installed engine and supplied profiles.
Plate 0 selects all plates. Use a self-contained Orca 3MF or supply complete printer/process/filament JSON; the bridge does not guess printer settings. Reusing an optional idempotency_key returns the saved job, even after a restart. Changed input/profile bytes or parameters conflict. Use a new key for an intentional retry. Queued jobs verify input/profile hashes again.
Inputs: inputs (required), output_directory (required), plate, settings, +4 more. Returns: object
workspace_listC
List local models, generated artifacts and profile folders within configured roots.
Inputs: limit, offset, directory. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 63 tools
The set contains many similarly purposed tools across domains: host_request_status, native_request_status, printer_request_status, job_status, and batch_status all retrieve status/receipts, while host_model_read, host_model_detail, project_inspect, project_objects_read, and project_geometry_read overlap in reading model/project structure. Descriptions add context, but at 63 tools an agent can easily misselect between host, native, project-file, and desktop paths.
All names use snake_case and consistent domain prefixes such as host_, native_, printer_, settings_, project_, batch_, and job_. There are minor inconsistencies in action placement and plurality, e.g. job_status vs jobs_list, host_presets_list vs host_preset_read, and noun_verb vs verb_noun forms, but the pattern remains readable.
The server exposes 63 tools, far beyond a well-scoped MCP surface. Although the OrcaSlicer domain is broad, the count includes many specialized variants, status/request tools, and overlapping read/write paths that make the set overwhelming rather than proportionate.
Coverage is broad across slicing, host bridge, native GUI operations, printer control, settings/profiles, project/mesh editing, jobs, and desktop automation. Remaining gaps include missing delete/rename operations for profiles or workspace artifacts and limited printer file management, which are mostly workaroundable.
Maintenance
Related MCP Connectors
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
MCP server for StyleKit styles, tokens, recipes, lint and repair over stdio or HTTP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for pre-print QA of Bambu Studio projects, providing tools to inspect models and 3MF files, validate risky settings, create support variants, and open files in Bambu Studio.MIT
- AlicenseNot gradedqualityBmaintenanceExposes 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.1Apache 2.0
- AlicenseAqualityCmaintenanceEnables 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.15MIT
- AlicenseBqualityBmaintenanceMCP server for BambuStudio slicer: inspect geometry, configure saved projects, and compare slices with Claude Code or Codex.292AGPL 3.0