71 lines
4.2 KiB
Markdown
71 lines
4.2 KiB
Markdown
---
|
|
name: cadcraft-mcp
|
|
description: "2D/3D-Zeichnungen (DXF, DWG) mit dem CADCraft-MCP-Server öffnen, zeichnen, abfragen und als DXF, DWG, SVG, PNG oder PDF ausgeben. Verwenden, wenn CADCraft-Werkzeuge verbunden sind oder der Nutzer CADCraft nennt; typisch für Grundrisse, Laschen in 2D, DXF/DWG von der Konstruktion. Nicht für parametrische Volumenkörper (SolidCraft) und nicht für Laser-DXF aus Illustrationen (VectorCraft)."
|
|
---
|
|
|
|
# Zeichnungen mit CADCraft (MCP)
|
|
|
|
CADCraft ist ein 2D/3D-CAD im AutoCAD-Stil (Rust). CLI 0.13.0. Koordinaten sind Zeichnungseinheiten, y nach oben. Der Server nennt sich selbst 2D/3D; welche 3D-Befehle es gibt, steht in `list_commands`, nicht hier.
|
|
|
|
## Voraussetzung
|
|
|
|
Die Werkzeuge `command_line`, `execute`, `list_commands`, `inspect_drawing`, `render` … müssen verbunden sein. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
|
|
|
|
`cadcraft-cli mcp` ist der kopflose Server auf stdin/stdout. `mcp --connect HOST:PORT` hängt an eine laufende App; `--lazy` und `--launch` sind zusätzliche Flags dieser Verbindung (nicht einzeln geprüft). Die Hilfe nennt keine Lese-/Schreib-Ordner.
|
|
|
|
## Werkzeuge
|
|
|
|
| Tool | Zweck |
|
|
|---|---|
|
|
| `command_line {text}` | eine Zeile wie an der AutoCAD-Eingabe (`line 0,0 10,0 10,5 c`, `circle 5,2.5 1`). Leerzeichen wirkt als Enter |
|
|
| `script {text}` | mehrzeiliges Skript, Leerzeile = Enter |
|
|
| `execute {command, params}` | ein Befehl ohne Dialog. IDs nur aus `list_commands` |
|
|
| `list_commands {filter}` | IDs, Aliase, Parameter. Immer mit Filter |
|
|
| `inspect_drawing` | Zählungen, Grenzen, Layer, Blöcke, Layouts |
|
|
| `query_entities` | nach Typ, Layer, Auswahl oder Fenster |
|
|
| `find_text` | TEXT, MTEXT, Attribute, Führungslinien |
|
|
| `render` | PNG, standardmäßig auf die Grenzen angepasst, oder `window` |
|
|
| `new_drawing {metric?}` | neu. Ohne `metric` imperial |
|
|
| `open {path}` / `save {path}` | DXF und DWG. Endung `.svg`, `.png` oder `.pdf` exportiert, die Zeichnung bleibt offen |
|
|
| `cancel` | Escape |
|
|
|
|
## Arbeitsweise
|
|
|
|
1. **Maßsystem zuerst.** Für Millimeter `new_drawing {metric: true}` oder in der CLI `run --metric`. Ein leeres `new_drawing` ist imperial.
|
|
2. **Befehle nie raten.** `list_commands {filter}` oder die AutoCAD-Zeile, wenn der Alias bekannt ist (`L`, `C`, `PLINE`, `RECTANG`, `OFFSET`, `ZOOM`).
|
|
3. **Prüfen:** `inspect_drawing`, bei Text `find_text`, Bild mit `render`.
|
|
4. **Speichern** unter neuem Namen. DXF/DWG über die Endung. Für ein Bild `--window` bzw. `render.window` setzen, sonst wird die ganze Zeichnung eingepasst.
|
|
|
|
Die CLI kann dasselbe ohne MCP: `info`, `convert` nach DXF/DWG/SVG/PNG/PDF, `run` mit `--cmd` (Wert `{last}` ist der letzte Handle), `sample bracket` oder `sample floorplan`, `commands FILTER`.
|
|
|
|
## Fallen
|
|
|
|
- **Imperial ist der Standard** von `new_drawing`. Eine Lasche in mm ohne `metric: true` wird in Zoll interpretiert.
|
|
- **y zeigt nach oben**, anders als in FigCraft und VectorCraft.
|
|
- **`save` auf `.png`/`.svg`/`.pdf` exportiert** und lässt die Zeichnung unbenannt, wenn sie neu ist. Danach zusätzlich als DXF speichern, wenn die Zeichnung bleiben soll.
|
|
- **`{last}`** gibt es in der CLI-Kette `--cmd`, nicht als belegtes Feld von `execute`.
|
|
|
|
## Rezepte
|
|
|
|
1. **Lasche in mm:** `new_drawing {metric: true}`, Kontur über `command_line` oder `execute`, Bohrungen, `inspect_drawing`, `render`, `save` als `.dxf` und bei Bedarf `.pdf`.
|
|
2. **Fremde DWG nur ansehen:** `open`, `inspect_drawing`, `find_text`, `render`. Nichts ändern, solange der Nutzer nur lesen will. Kundenzeichnungen mit NDA-Vermerk nur mit Zustimmung.
|
|
|
|
## Abschlussprüfung
|
|
|
|
- `inspect_drawing`: Grenzen und Einheiten zum Auftrag passend.
|
|
- `render` angesehen.
|
|
- Pfad der gespeicherten Datei genannt, Format (DXF oder DWG) dazu.
|
|
|
|
## Datenschutz
|
|
|
|
Ampel:
|
|
|
|
- Grün: allgemeine und technische Inhalte ohne Kundenbezug.
|
|
- Gelb: Projekt- und Geschäftsinfos, nur nach Abwägung oder anonymisiert.
|
|
- Rot: personenbezogene Daten und NDA-Inhalte gehören nicht in die Cloud-KI.
|
|
|
|
## Grenzen
|
|
|
|
- Kein Ersatz für SolidCraft (Volumenkörper, STEP) und kein Ersatz für VectorCraft (Laser-DXF aus Schriften und Piktogrammen).
|
|
- Die Hilfe listet keine Ordnersperre. Nur Dateien öffnen und speichern, die der Nutzer genannt hat.
|