orca-profiles-mcp
orca-profiles-mcp
Ein MCP-Server, der OrcaSlicer-Profile liest und bearbeitet. Er expandiert die gesamte inherits-Kette und zeigt, welches Kettenglied jeden Wert setzt.
Was es tut
Ein OrcaSlicer-Profil speichert nur seine Abweichungen vom Elternprofil. Die Datei zu öffnen genügt nicht, um die Geschwindigkeit der äußeren Wand zu erfahren: Der Wert kann vom Elternprofil stammen, vom Elternprofil des Elternprofils oder von den eingebauten Standardwerten der Engine. Dieser Server verfolgt die Kette bis zu ihrer Wurzel, berechnet die effektiven Werte und behält ihre Herkunft.
Er behandelt die Teile von Orca, die naive Leser scheitern lassen:
Eltern werden nach Namen, herstellerübergreifend aufgelöst — ein Sovol-Filament erbt von der OrcaFilamentLibrary;
Ein fehlendes
Generic …-Elternprofil fällt aufGeneric <material> @Systemzurück, und umbenannte Profile werden über ihrerenamed_from-Liste gefunden;Vektoren, die an Extrudervarianten gebunden sind, werden elementweise zusammengeführt, einschließlich des
nil-Markers, der bedeutet: „hier den Wert des Elternprofils behalten“;Ein Kind darf mehr Extruder deklarieren als sein Elternprofil — ein Toolchanger auf der Grundlage eines Maschinenprofils mit einem einzelnen Extruder — und beide Extruder behalten ihre Werte;
Schlüssel, die nicht zum Profiltyp gehören, werden verworfen, weil Orca sie ebenfalls verwirft; sie werden gemeldet, statt stillschweigend angewendet zu werden.
Related MCP server: local-code-mcp
Einrichtung
cd ~/job/orca-profiles-mcp
uv syncBei Claude Code registrieren:
claude mcp add orca-profiles -- uv --directory ~/job/orca-profiles-mcp run orca-profiles-mcpWerkzeuge
Werkzeug | Zweck |
| erkannte Wurzeln, Orca-Version, Hersteller, ausgewählte Voreinstellungen |
| Suche nach Typ, Name, Hersteller, Quelle |
| Profil im Modus |
| Vererbungskette bis zur Wurzel |
| woher ein bestimmter Wert stammt |
| welche Profile von diesem erben |
| zwei Profile vergleichen |
| mit dem OrcaSlicer-Repository vergleichen |
| kaputte |
| Expansion gegen die von Orca selbst geschriebenen Deltas prüfen |
meldet redundante Schlüssel und unerklärte Vektorlängen getrennt | |
| Werte mit Neuberechnung der Deltas setzen |
| ein Benutzerprofil erstellen |
| umbenennen und löschen |
| Schlüssel verwerfen, die mit denen des Elternprofils identisch sind |
Werte werden exakt so zurückgegeben, wie die Dateien sie speichern: "0.20" bleibt "0.20", und "100%" bleibt ein Prozentsatz. Die Engine normalisiert beides beim Slicen; dieser Server tut das nicht, sodass das, was du liest, das ist, was das Profil angibt, und das, was zurückgeschrieben wird, unverändert bleibt.
Profile schreiben
Deine eigenen Profile können frei bearbeitet werden. Das Anfassen eines System- oder gebündelten Profils erfordert force=true: Diese Dateien gehören zu einer Herstellerbibliothek, das nächste Profilupdate stellt sie wieder her, und jeder Nachkomme erbt die Änderung.
Schreibvorgänge laufen über eine temporäre Datei und eine atomare Umbenennung, sodass ein unterbrochener Schreibvorgang ein Profil nicht abschneiden kann, und zuerst wird eine Sicherungskopie neben der Datei erstellt (backup=false deaktiviert sie). Werte werden geprüft, bevor etwas geschrieben wird — ein Schlüssel, der zu einem anderen Profiltyp gehört, ein Vektor, wo die Engine einen Skalar erwartet, oder eine Zahl, wo das Format eine Zeichenkette verlangt, wird abgelehnt, statt gespeichert und von Orca stillschweigend verworfen zu werden. Einstellungen, die dein fixierter Snapshot nicht erkennt, werden unangetastet durchgereicht, sodass ein von einem neueren Orca geschriebenes Profil sie nicht verliert.
OrcaSlicer liest Profile beim Start und schreibt sie beim Beenden neu. Änderungen, die vorgenommen werden, während die Anwendung läuft, werden überschrieben — schließe Orca zuerst.
Wie die Korrektheit geprüft wird
Orcas CLI kann die Vererbung nicht überprüfen. --export-settings gibt die Engine-Standardwerte plus die in den übergebenen Dateien vorhandenen Schlüssel zurück und geht niemals inherits durch; das Auswählen von Voreinstellungen über OrcaSlicer.conf aktiviert sie nicht; das Übergeben einer gesamten Kette als Dateiliste wird als doppelte Konfigurationsdatei abgelehnt. Alle drei wurden gegen 2.4.2 ausprobiert.
Was Orca zurücklässt, ist ein Beleg seiner eigenen Expansion: Wenn es ein Benutzerprofil speichert, speichert es das minimale Delta gegenüber dem vollständig expandierten Elternprofil. Jedes Profil, das Orca geschrieben hat, ist also eine aufgezeichnete Antwort. check_deltas berechnet diese Deltas neu und vergleicht — eine Abweichung bedeutet, dass der Resolver ein Elternprofil anders expandiert als die Engine.
Das ist es, was tests/test_smoke.py gegen die installierte Bibliothek prüft, und so wurde der Vektorfehler des Toolchangers gefunden.
Schlüssel, die gespeichert werden, obwohl sie bereits mit dem Elternprofil übereinstimmen, werden getrennt gemeldet: Sie sind harmlose Überbleibsel von vor einer Änderung des Elternprofils, keine Resolver-Fehler.
Engine-Snapshot aktualisieren
Engine-Standardwerte, die Variantenschlüsselsätze und die Pro-Typ-Schlüssellisten werden aus der installierten Orca in src/orca_profiles_mcp/data/engine-snapshot.json übernommen, fixiert auf ihren Versions-Tag. Nach dem Upgrade von OrcaSlicer:
uv run python scripts/build_snapshot.py
uv run pytestTests
uv run pytestVier Ebenen:
Unit-Tests über eine Miniatur-Fixture-Bibliothek, einer pro Grenzfall — herstellerübergreifende Vererbung, der
Generic-Fallback,renamed_from, Zyklen, fehlende Elternprofile, Vektoren mit Schrittweite 1 und 2,nil-Elemente;Schreib-Roundtrips: lesen → unverändert schreiben → die Datei ist byte-identisch;
End-to-End-Tests, die den gepackten Einstiegspunkt als Unterprozess starten und ihn über MCP stdio steuern, abdeckend Werkzeugregistrierung, einen vollständigen Erstellen/Bearbeiten/Prüfen/Löschen-Zyklus und Fehlerweitergabe;
Prüfungen gegen die installierte Bibliothek, einschließlich der oben beschriebenen Delta-Verifizierung.
Tests, die die echte Bibliothek verwenden, überspringen sich selbst, wenn kein Orca-Datenverzeichnis vorhanden ist; alles andere läuft gegen Fixtures.
Dokumente
Design:
docs/specs/2026-08-17-orca-profiles-mcp-design.md— enthält, was das Lesen der OrcaSlicer-Quellen über das Profilformat ergeben hat und was die CLI-Experimente ausgeschlossen habenImplementierungsplan:
docs/plans/2026-08-17-orca-profiles-mcp.md
Lizenz
AGPL-3.0, passend zu OrcaSlicer selbst. Dieses Projekt enthält keinen OrcaSlicer-Code, aber seine Vererbungslogik ist eine zeilenweise Portierung von Preset.cpp und PrintConfig.cpp, und der Engine-Snapshot enthält Standardwerte und Schlüssellisten, die aus dieser Quelle extrahiert wurden.
Nicht verbunden mit dem OrcaSlicer-Projekt und nicht von ihm unterstützt.
Available Tools
15 toolscheck_deltasB
Verify inheritance expansion against the deltas Orca itself wrote: for every profile, the delta is recomputed and compared with the file. A mismatch means the resolver expands the parent differently than the engine did; redundant keys are reported separately and are harmless
Inputs: scope.
compare_with_upstreamC
Compare a profile against its version in the OrcaSlicer repository
Inputs: name (required), type (required), ref.
create_profileC
Create a user profile inheriting from the given one
Inputs: name (required), type (required), values (required), inherits (required).
delete_profileB
Delete a profile; deleting outside your own profiles needs force=True, and cloud-synced ones keep a flagged .info
Inputs: name (required), type (required), force.
diff_profilesB
Compare two profiles by effective values (mode=resolved) or by their stored deltas (mode=raw)
Inputs: a (required), b (required), type (required), mode.
explain_keyB
Where a key's value came from: originating link, overridden values, engine default
Inputs: key (required), name (required), type (required).
find_childrenC
Profiles inheriting from this one. Check before editing shared profiles
Inputs: name (required), type (required).
get_chainC
The inheritance chain to its root, with how each link was resolved
Inputs: name (required), type (required).
get_profileC
A profile with inheritance expanded. mode: raw — file contents, resolved — effective values, traced — values with provenance. Engine defaults are excluded unless include_defaults is set
Inputs: name (required), type (required), keys, mode, +3 more.
get_setupB
Discovered Orca profile roots, application version, vendors, selected presets
Inputs: no named parameters.
list_profilesC
Search profiles by type, name, vendor and source
Inputs: type, limit, query, source, +3 more.
normalize_profileC
Drop keys whose values are identical to the parent's
Inputs: name (required), type (required), force, backup.
rename_profileC
Rename a user profile
Inputs: name (required), type (required), new_name (required).
set_valuesA
Set profile values. The delta against the parent is recomputed automatically and the paired .info is updated. Editing a system or bundled profile affects every descendant and needs force=True
Inputs: name (required), type (required), values (required), force, +1 more.
validateC
Integrity check: broken inherits, cycles, unknown keys, redundant deltas, name collisions
Inputs: scope.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools have clearly distinct purposes: get_profile expands inheritance, get_chain shows the chain, explain_key traces a single key's origin. However, validate and check_deltas both verify integrity and could be confused; diff_profiles and compare_with_upstream both compare but to different targets. Descriptions are detailed enough to resolve ambiguity.
All tool names follow a consistent snake_case imperative verb-noun pattern (get_setup, list_profiles, set_values, create_profile). Even compound names like compare_with_upstream and check_deltas fit the pattern. No mixed conventions or vague verbs.
15 tools is well-scoped for a profile management server, covering discovery, inspection, mutation, validation, and comparison. Each tool addresses a distinct need without unnecessary duplication.
The tool surface provides full lifecycle coverage: create, read (multiple views), update, delete, rename, plus validation, diffing, and impact analysis (find_children). Missing operations like import/export are not core to the domain, and the set appears complete for effective profile management.
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceAn MCP server for interactively reading, validating, previewing, and saving Renovate configurations with LLM assistance.1,006 npm14MIT
- FlicenseNot gradedqualityDmaintenanceProfile-driven MCP server for safely inspecting and changing local Git repositories via a Streamable HTTP endpoint with deny-by-default security.1-
- 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
- AlicenseBqualityBmaintenanceMCP server for BambuStudio slicer: inspect geometry, configure saved projects, and compare slices with Claude Code or Codex.292AGPL 3.0