↓Zum Hauptinhalt springen
  1. Projekte und Blogs/

Von OpenSCAD-Einwegskripten zum agentischen FreeCAD-Workflow

·1767 Wörter·
3d-Druck Freecad Cad Ki Agentic Programming Mcp Openscad Fdm
Oliver Hihn
Autor
Oliver Hihn
Getrieben von Neugier, angetrieben von Code. Ich entwerfe und baue individuelle Technik mit Leidenschaft und Zweck.
Inhaltsverzeichnis

🖨️ Von Skripten zur Session
#

Lange sah mein KI-gestützter 3D-Druck-Workflow so aus: Teil in einem Prompt beschreiben, ein OpenSCAD-Skript zurückbekommen, rendern, Vorschau prüfen, Anpassung erbitten, nächstes Skript bekommen. Das hat funktioniert – einige meiner gedruckten Teile sind genau so entstanden – aber jeder Durchlauf war im Grunde ein Einweg-Vorgang: Der Agent hat blind Code geschrieben, ich habe gerendert, und alles, was er über das Teil “gelernt” hatte, war verflogen, sobald der Chat weiterzog.

Inzwischen verwende ich ein anderes Setup: Statt OpenSCAD-Text zu generieren, steuert ein Agent eine echte FreeCAD-Session direkt über einen MCP-Server. Er sieht das Modell, bearbeitet es, prüft es und speichert es – genau so, wie man selbst am Rechner sitzen würde, nur dass er sich nebenbei wesentlich mehr Kontext über Drucker, Toleranzen und vorhandene Hardware merken kann, als ich Lust hätte, mir das jedes Mal neu zu merken.

In diesem Artikel geht es um dieses zweite Setup: wie man dafür einen Projektordner strukturiert, und wie eine stabile Basiskonfiguration aussieht.


🧩 Warum sich der Wechsel gelohnt hat
#

Ein paar handfeste Unterschiede zwischen “KI schreibt OpenSCAD” und “KI bedient FreeCAD via MCP”:

  • Eine richtige Session statt einer Text-Pipeline. Der Agent kann das Dokument öffnen, aus jedem Winkel betrachten, eine Bemaßung ändern und das Ergebnis unmittelbar sehen – statt für jede Änderung ein komplettes Skript neu zu generieren und von Null zu rendern.
  • Ein parametrisches Modell übersteht die Konversation. Am Ende steht ein echtes .FCStd-Dokument mit beschrifteten Bauteilen und einer Maßtabelle, kein Code-Berg, der nur im Zusammenhang mit dem Chat Sinn ergibt, der ihn erzeugt hat. Man kann es danach von Hand öffnen, und es ergibt immer noch Sinn.
  • Zustand kann über Sessions hinweg erhalten bleiben. Ein paar simple Markdown-Dateien – Drucker-Profil, gelernte Toleranzen, vorhandene Hardware, Lektionen aus früheren Drucken – geben dem Agenten ein Gedächtnis, das OpenSCAD-Skripte nie hatten. War ein Teil zu knapp? Das wandert in eine Datei zurück, und das nächste Teil profitiert automatisch davon.
  • Verifikation erfolgt, bevor überhaupt etwas geslict wird. Zu prüfen, ob eine Form ein valider Körper ist, ob sich zwei Teile nicht überlappen, oder ob eine Schraube wirklich ihre Mutter erreicht, ist eine Zeile Python in der laufenden Session – kein Bauchgefühl beim Blick auf ein gerendertes Vorschaubild.

Dabei geht es nicht darum, dass FreeCAD der “bessere” CAD-Kern wäre als OpenSCAD. Es geht darum, dem Agenten einen beständigen, einsehbaren Arbeitsbereich zu geben statt einer reinen Prompt-rein-Skript-raus-Schleife.


📎 Ein konkretes Beispiel
#

Ein Fall von neulich: Ein höhenverstellbarer Schreibtisch steht an einer Wand, und statt einfach nur dagegen zu lehnen, sollte er an einer wandmontierten Schiene auf und ab gleiten können. Der Plan: ein 20x20-mm-V-Slot-Alu-Profil an die Wand schrauben, dazu ein Rollschlitten, der bereits auf dem Profil läuft und eine gedruckte Klemme trägt, die unter die Tischplatte greift.

Bevor ein gedrucktes Teil entworfen wurde, kamen die beiden Dinge, die schon physisch existierten, als einfache Referenzgeometrie ins FreeCAD-Dokument: das Alu-Profil und die Montageplatte des Schlittens, beide in ihren echten Maßen modelliert, dazu die Tischplatte als halbtransparente Referenzebene in ihrer gemessenen Dicke.

Referenzobjekte in FreeCAD: Alu-Profil, Rollschlitten und Tischplatte
Der Ausgangspunkt: das gekaufte V-Slot-Profil, der Rollschlitten und die Tischplatte, als Referenzgeometrie modelliert, bevor ein gedrucktes Teil existiert.

Alles Weitere wurde darum herum gebaut: zwei Wandhalter oben und unten am Profil, und eine gedruckte Klemme, die an den vorhandenen Montagelöchern des Schlittens verschraubt wird und die Tischkante mit einer Backe greift, die über eine Schraube und eine eingelassene Mutter angezogen wird, ohne das Holz zu beschädigen.

Röntgenansicht des Klemmmechanismus mit Zylinderkopfschraube und eingelassener Mutter
Der Klemmmechanismus halbtransparent: zwei Zylinderkopfschrauben mit Innensechskant ziehen die Backe gegen die im Klemmkörper eingelassenen Sechskantmuttern.
Fertige Tischstabilisator-Baugruppe in FreeCAD, um die Referenzobjekte herum konstruiert
Die fertige Baugruppe: Wandhalter, gedruckte Klemme und Schlitten, alles anhand der Referenzobjekte bemaßt statt geschätzter Maße.

Weil Schlitten und Profil echte Geometrie im Dokument waren und keine Zahlen in einem Prompt, ließ sich der Entwurf genauso direkt prüfen wie bauen: Passt das Lochbild der Klemme zu den tatsächlichen Löchern im Schlitten, kommt die Backe beim Verschieben des Schlittens am Profil vorbei, bleibt an der Stelle, wo eine Schraube durchgeht, noch genug Wandstärke im gedruckten Teil übrig. All das ließ sich an Formen prüfen, die direkt in der Session lagen, nicht an einer schriftlichen Spezifikation.

Nahaufnahme der gedruckten Klemme auf dem Rollschlitten
Nahaufnahme: Die gedruckte Klemme verbindet die Montagelöcher des Schlittens mit der Tischkante und läuft dabei auf dem V-Slot-Profil.

🗂️ Das Setup
#

Das Setup selbst ist angenehm simpel:

  1. Einen Root-Ordner für die Projekte festlegen, z. B. ~/3d-prints/, mit einem Unterordner pro entworfenem Teil.
  2. Eine AGENTS.md-Datei in diesem Root-Ordner erstellen. AGENTS.md ist eine einfache Markdown-Konvention, die die meisten agentischen Coding-Tools ohnehin ohne Zusatzkonfiguration einlesen, egal welches man gerade nutzt, statt einer Datei, die an ein bestimmtes Produkt gebunden ist. Das ist hier entscheidend, weil es um ein dauerhaftes, werkzeugunabhängiges Projekt-Setup geht.
  3. Prüfen, dass ein FreeCAD-MCP-Server läuft und erreichbar ist. MCP (Model Context Protocol) ist der Standard, über den ein Agent in eine Anwendung eingreifen kann – hier: eine laufende FreeCAD-Instanz – statt nur Text zu generieren. Es gibt mehrere Open-Source-MCP-Server für FreeCAD; einen auswählen, starten und in der Tool-Konfiguration des eigenen Agenten eintragen. Ich selbst nutze neka-nat/freecad-mcp, dessen README die Installation von FreeCAD-Addon und Server beschreibt.
  4. Den Agenten in diesem Root-Ordner ausführen. Die meisten agentischen Coding-Tools lesen AGENTS.md aus dem aktuellen Verzeichnis selbsttätig beim Start ein – das heißt, Drucker-Profil, Toleranzen und Workflow-Regeln stehen schon im Kontext, bevor man ein einziges Wort geschrieben hat.

Von da an ist jedes neue Teil schlicht ein neuer Unterordner, und jede Session startet bereits mit dem Wissen, wie man arbeitet.


📝 Was in die AGENTS.md gehört
#

Die Datei wie ein Onboarding-Dokument für einen neuen Kollegen betrachten: Alles, was der Agent sonst jedes Mal neu herleiten oder erfragen müsste, gehört hier hin – und nichts, was reiner Projekt-Einzelzustand ist. Eine vernünftige Aufteilung:

  • AGENTS.md selbst umfasst die Workflow-Regeln – wie modelliert, geprüft und exportiert wird.
  • Ein kleiner profile/-Ordner daneben enthält das gelernte Wissen – Drucker-Eigenschaften, aktuelle Toleranzen, vorhandene Hardware und Lektionen aus früheren Drucken – damit die Regeln in AGENTS.md konstant bleiben, während das Wissen darunter stetig wächst.

Hier ein verschlanktes, aber vollständiges Beispiel, verallgemeinert aus einem funktionierenden Setup:

# AGENTS.md: FDM-3D-Druck in FreeCAD via MCP

Dieser Ordner ist für Teile, die zum 3D-Druck (FDM) bestimmt sind. Jedes Teil
bekommt seinen eigenen Unterordner. Bevor irgendetwas entworfen wird, zuerst
das Profil unten lesen – es enthält, was über diesen Drucker bereits bekannt
ist, und gilt als Quelle der Wahrheit, nicht generische Standardwerte aus dem
Internet.

## 1. Zuerst das Profil laden

- `profile/printer.md`: Drucker, Düsengröße, Slicer-/Prozess-Standardwerte,
  verwendete Filamente.
- `profile/tolerances.md`: aktuelle Spiele und Passungen, jeweils mit Status
  (bestätigt / in Nutzung / ungetestet) und kurzer Historie, wie der Wert
  entstanden ist.
- `profile/hardware.md`: vorhandene Schrauben, Muttern und Einpressteile.
  Zuerst mit dem arbeiten, was im Bestand ist, bevor nach einer Besorgung
  gefragt wird.
- `profile/lessons.md`: Design- und Prozess-Lektionen aus früheren Teilen.

## 2. In FreeCAD über den MCP-Server modellieren

- Vor allem anderen prüfen, ob der MCP-Server erreichbar ist. Falls nicht,
  nachfragen, ob er gestartet werden soll; nicht stattdessen auf ein
  eigenständiges Skript ausweichen.
- Ein FreeCAD-Dokument pro Teil, gespeichert als
  `<unterordner>/<teilname>.FCStd`. Nach jeder sinnvollen Änderung speichern,
  nicht erst am Ende.
- Jede Bemaßung, die sich vernünftigerweise ändern könnte, in ein
  `Params`-Tabellenblatt eintragen (Name, Wert mit Einheit, kurze
  Beschreibung) und die Geometrie per Ausdruck daran binden. Ein Spiel oder
  ein Lochabstand sollte an einer einzigen Stelle änderbar sein.
- Objekte nach dem benennen, was sie sind (`bracket_body`, `screw_boss_M3`,
  `clip_arm_left`), nicht nach Erstellungsreihenfolge.
- Vorhandene Teile wiederverwenden, indem ihre `.FCStd`-Datei geöffnet und
  die benötigten Formen kopiert werden, statt jedes Mal mit einem leeren
  Dokument zu starten.

## 3. Für den Druck entwerfen, nicht nur für die Geometrie

- Die Druckausrichtung ist Teil des Entwurfs, nicht ein nachträglicher
  Schritt. Sie entscheidet, welche Flächen Supports brauchen und ob Lasten
  entlang der Schichtlinien oder quer dazu verlaufen (Schichten trennen sich
  unter Zug leichter).
- Lieber ein Teil in einfachere, über Hardware verbundene Stücke aufteilen,
  statt ein komplexes Teil mit viel Supportbedarf zu bauen, außer es gibt
  einen konkreten Grund dagegen (Festigkeit, Vorgabe eines einteiligen
  Designs).
- Nur dann ein anderes Filament als das Standard-PLA verwenden, wenn das
  Teil es tatsächlich braucht: funktionale Passungen und Schnapp-/
  Pressmechanismen, Hitzeeinwirkung, Außeneinsatz oder große flache Flächen,
  die zum Verzug neigen. Die Annahme benennen, falls nicht nachgefragt wird.

## 4. Vor dem Export verifizieren

Das per Code gegen die tatsächliche Geometrie prüfen, nicht per Augenschein
auf einem Screenshot:

- jeder Körper ist valide und ein einzelner Solid (außer es sollen bewusst
  mehrere sein);
- Teile, die getrennt bleiben sollen, überlappen sich nicht, und
  Print-in-Place-Teile haben genau das Spiel, das das Profil vorgibt;
- bewegliche Teile durchlaufen ihren vollen Bewegungsbereich ohne Kollision;
- Schraubenverbindungen: Kopfauflage, Grifflänge, Mutterneingriff, kein
  ungewollter Überstand;
- das Teil passt in seiner Druckausrichtung auf das Druckbett.

## 5. Export

- STL, eine Datei pro gedrucktem Teil, bereits in Druckausrichtung.
  Print-in-Place-Baugruppen kommen als eine STL mit bereits platzierten
  Einzelteilen.
- Wird ein bereits gedrucktes Teil überarbeitet, die vorherigen Dateien in
  einen nach der Änderung benannten Unterordner verschieben (z. B.
  `v2-engeres-snap/`), statt sie zu überschreiben.
- Druckeinstellungen nur dort nennen, wo sie von den Profil-Standardwerten
  abweichen: Ausrichtung, Supports (oder warum keine nötig sind),
  Wand-/Fülldichte-Anpassungen für belastete Bereiche, und jede verwendete
  Passung mit ihrem Status aus dem Profil.

## 6. Druckergebnisse ins Profil zurückspielen

Wenn ein gedrucktes Teil zurückgemeldet wird ("zu locker", "an der Ecke
abgebrochen", "passt perfekt"):

1. Herausfinden, welchem Wert in `profile/tolerances.md` das entspricht.
2. Das Ergebnis mit Datum, Teil, Material und Ausgang in der Historie dieser
   Datei festhalten.
3. Den aktuellen Wert entsprechend anpassen und den Status aktualisieren:
   eine gute Passung reicht für "bestätigt", aber dabei vermerken, in
   welchem Material das bestätigt wurde.
4. Alles, was keine Zahl ist (ein Designansatz, der funktioniert hat oder
   nicht) kommt stattdessen in `profile/lessons.md`.

Das Profil kurz und aktuell halten: Oben in jeder Datei steht der aktuelle
Stand, darunter die Historie als Beleg dafür.

Den eigenen Drucker, die eigenen Materialien und die eigene Hardware einsetzen, sobald die Struktur steht: der Sinn der Datei liegt im Workflow, den sie festhält, nicht in den genauen Zahlen darin.


🧠 Fazit
#

Die wirkliche Veränderung ist nicht “FreeCAD statt OpenSCAD”. Sie besteht darin, dem Agenten ein Gedächtnis zu geben, statt ihn in einer Schleife Text ausspucken und wieder vergessen zu lassen. Der MCP-Server macht das technisch möglich. AGENTS.md plus ein kleiner Profil-Ordner sorgen dafür, dass man die Session morgen an einem ganz anderen Teil einfach weiterführen kann, ohne dem eigenen Drucker alles neu zu erklären.

Wer noch in der “beschreiben, Skript zurückbekommen”-Phase steckt: Das ist ein durchaus guter Einstieg, und man bekommt trotzdem gedruckte Teile. Aber sobald das zweite Teil von dem profitieren soll, was beim ersten gelernt wurde, braucht man eine Session, die sich erinnert. Keinen Prompt, der es nicht tut.


Hast du selbst ein Agenten+CAD-Setup, oder Fragen zum MCP-Teil davon? Gerne Erfahrungen austauschen.