85 lines
6.6 KiB
Markdown
85 lines
6.6 KiB
Markdown
---
|
||
name: vectorcraft-mcp
|
||
description: Vektorgrafiken über den VectorCraft-MCP-Server zeichnen, bearbeiten und als SVG, PDF, DXF, EPS, PNG exportieren (Illustrator-Klon); öffnet auch DXF, SVG, PDF, AI, EPS, PSD, Affinity (.af, .afdesign, .afpub). Verwenden, wenn VectorCraft-Werkzeuge verbunden sind oder der Nutzer VectorCraft nennt; typisch für Typenschilder und Laser-/Gravurvorlagen als DXF in mm, Hinweisschilder, Piktogramme, Skizzen und Illustrationen für Betriebsanleitungen.
|
||
---
|
||
|
||
# Vektorgrafik mit VectorCraft (MCP)
|
||
|
||
VectorCraft ist ein Open-Source-Vektorprogramm (Rust), das Illustrator-Parität anstrebt. CLI 0.17.0. Die Maß- und Schriftfallen sind am 0.13.1 bestätigt und an 0.17.0 nicht erneut durchgespielt.
|
||
|
||
## Voraussetzung
|
||
|
||
Die Werkzeuge `draw_shape`, `draw_path`, `add_text`, `run_command`, `export`, `render_preview` … müssen verbunden sein. Ihr Präfix hängt vom Client und vom Namen der Erweiterung bzw. des Servers ab (z. B. `mcp__…__VectorCraft_for_Claude__draw_shape`). Sind sie zurückgestellt, nach dem Werkzeugnamen ohne Präfix suchen und alle benötigten auf einmal laden. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
|
||
|
||
Dateizugriff: Lesen nur im Lese-Ordner, Schreiben nur im Schreib-Ordner. Die Ordner-Flags erzwingen den kopflosen Modus. Ohne sie versucht `mcp` zuerst `127.0.0.1:7979` (`vectorcraft --control 7979`) und fällt sonst auf kopflos zurück. Die Werkzeuge `inspect_ui`, `type_text`, `open_panel`, `ui_*` und `screenshot {window: true}` gehen im kopflosen Server nicht.
|
||
|
||
## Werkzeuge
|
||
|
||
| Tool | Zweck |
|
||
|---|---|
|
||
| `run_command {command, params}` | jeder Menübefehl, z. B. `file.new` |
|
||
| `list_commands {filter, brief}` | Befehle suchen |
|
||
| `draw_shape` | rectangle/ellipse (`x,y,width,height`, `radius`), polygon, star, line (`x1,y1,x2,y2`) |
|
||
| `draw_path` | `points: [[x,y],…]` oder SVG-`d`; `closed`, `fill`, `stroke`, `strokeWidth`, `join`, `cap`, `dash` |
|
||
| `add_text` | Punkttext (`x,y` = Grundlinie) oder Flächentext (`width,height`); `size`, `font`, `color`, `justify` |
|
||
| `set_paint`, `transform`, `pathfinder`, `apply_effect` | Farbe, verschieben/drehen/skalieren, Boolesche Operationen, Effekte |
|
||
| `inspect_document {depth}` / `doc_inspect` | Ebenen, Objekte, Begrenzungen |
|
||
| `render_preview` / `screenshot` | Zeichenfläche als PNG |
|
||
| `open_file` / `save_file` / `export` | lesen u. a. .vectorcraft, .drawcraft, .svg, .pdf, .ai, .eps, .dxf, .psd, .psb, .af, .afdesign, .afpub; schreiben u. a. .vectorcraft, .svg, .pdf, .ai, .dxf, .eps, .psd, .png |
|
||
| `undo` / `redo` | Verlauf |
|
||
|
||
## Arbeitsweise
|
||
|
||
1. **Neues Dokument in mm-Größe:** `run_command {command: "file.new", params: {name, width: "100 mm", height: "50 mm", units: "Millimeters"}}`. Ohne `file.new` ist das Format US-Letter (612 × 792 pt).
|
||
2. **Koordinaten sind immer Punkt**, auch wenn die Einheit auf mm steht. Umrechnen: `pt = mm × 72 / 25,4` (1 mm = 2,8346 pt). Ursprung oben links, y nach unten.
|
||
3. **Befehle nie raten:** `list_commands {filter: "…", brief: true}`.
|
||
4. **Ansehen:** `render_preview {max_side: 1000}`. Für scharfe Bilder lieber `export {format: "png", scale: 3}`.
|
||
5. **Speichern** als `.vectorcraft` unter neuem Namen, dann in das Zielformat exportieren.
|
||
|
||
## Fallen (im Test bestätigt)
|
||
|
||
- **`add_text {y}` ist die Grundlinie**, nicht die Oberkante. Die Schrift ragt um etwa 0,7 × `size` nach oben.
|
||
- **Schriften:** Fehlt eine Schrift (z. B. `Helvetica-Bold`), wird still auf „Source Sans 3“ ausgewichen; der Export meldet das in `warnings`. Unter Windows z. B. `Arial` verwenden und die Warnungen beim Export lesen. `run_command text.fontList` listet die vorhandenen Schriften.
|
||
- **DXF für Laser/Gravur:**
|
||
- `export {format: "dxf", path}` schreibt im Maßstab 1:1 in mm (`$INSUNITS` = mm), y nach oben, Ursprung unten links. Im Test hatte ein 100 × 50 mm großes Schild genau 0–100 × 0–50.
|
||
- Text wird als Kontur geschrieben, Kreise als echte CIRCLE.
|
||
- Flächen bekommen zusätzlich Schraffuren (HATCH). Für Laser- und CAD-Programme ggf. `run_command document.exportDxf {path, version: "R12"}` ohne Schraffuren, oder `preserve: "editability"`, wenn Text als Text bleiben soll.
|
||
- **SVG:** Text bleibt `<text>` (Schrift muss beim Empfänger vorhanden sein). Mit `outlineText: true` wird er zu Pfaden; das ist für die Weitergabe sicherer.
|
||
- **Lese-/Schreib-Ordner getrennt:** Eine Datei im Schreib-Ordner kann nur wieder geöffnet werden, wenn der Schreib-Ordner im Lese-Ordner liegt.
|
||
- `open_file` öffnet ein **neues** Dokument und macht es aktiv; Befehle wirken auf das aktive Dokument.
|
||
|
||
## Rezepte
|
||
|
||
1. **Typenschild (DXF für Laser/Gravur, PDF zur Freigabe):**
|
||
1. `file.new` in Schildgröße.
|
||
2. Kontur mit `draw_shape rectangle {radius}`, Bohrungen als `ellipse`, eine Trennlinie.
|
||
3. Texte zeilenweise mit `add_text` (Hersteller, Typ, Serien-Nr., Baujahr, Spannung/Frequenz, Strom, Schutzart, Gewicht).
|
||
4. `render_preview` ansehen.
|
||
5. Speichern, dann `export` als PDF und DXF.
|
||
|
||
Pflichtangaben nach Maschinenrichtlinie/Maschinenverordnung und das CE-Zeichen in Originalproportionen gibt der Nutzer vor; nicht selbst ergänzen.
|
||
2. **Hinweis-/Warnschild:** Dreieck mit `draw_path {closed, join: "round"}`, Symbol aus einfachen Formen, Text darunter mit `justify: "center"`. Export als SVG (für WordCraft-Dokumente) und PNG `scale: 3`.
|
||
3. **Grafik für die Betriebsanleitung:** DXF/PDF vom Konstrukteur mit `open_file` öffnen, Beschriftungen, Pfeile und Positionsnummern ergänzen, als SVG/PNG exportieren.
|
||
|
||
## Abschlussprüfung
|
||
|
||
- `render_preview` angesehen: Texte innerhalb der Kontur, nichts verdeckt.
|
||
- Export-`warnings` gelesen (Schriftersatz, nicht unterstützte Effekte).
|
||
- Bei DXF: Maße im Ergebnis plausibel (Breite × Höhe in mm), dem Nutzer Version und Einheit nennen.
|
||
- Pfade der gespeicherten Dateien dem Nutzer genannt.
|
||
|
||
## Datenschutz
|
||
|
||
Ampel:
|
||
- 🟢 Allgemeine und technische Inhalte ohne Kundenbezug.
|
||
- 🟡 Projekt- und Geschäftsinfos: nur nach Abwägung oder anonymisiert.
|
||
- 🔴 Personenbezogene Daten und NDA-Inhalte gehören nicht in die Cloud-KI.
|
||
|
||
Kundenzeichnungen (DXF/PDF) mit Kundenname oder NDA-Vermerk sind 🔴: nur mit Zustimmung des Nutzers öffnen.
|
||
|
||
## Grenzen
|
||
|
||
- **Keine zertifizierten Sicherheitszeichen.** Selbst gezeichnete Warnschilder sind Entwürfe. Für die Maschine die offiziellen ISO-7010-Zeichen verwenden und das dem Nutzer sagen.
|
||
- Logos und Marken Dritter nicht nachzeichnen. Eigenes Firmenlogo nur aus einer Datei, die der Nutzer liefert.
|
||
- DWG steht weder bei den lesbaren noch bei den schreibbaren Formaten der CLI 0.17.0. DXF bleibt das Austauschformat für Laser und CAD. Ob binäres DXF geöffnet wird, sagt die Hilfe nicht.
|