89 lines
4.1 KiB
Markdown
89 lines
4.1 KiB
Markdown
# vectorcraft-mcp
|
||
|
||
[Alle Skills](../../README.md)
|
||
|
||
## Zweck
|
||
|
||
Zeichnet Vektorgrafiken über den MCP-Server von VectorCraft und exportiert sie als SVG, PDF oder DXF. CLI 0.17.0 (Typenschilder und DXF für Laser am 0.13.1 geprüft). Öffnet auch PSD und Affinity. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
|
||
|
||
## Voraussetzungen
|
||
|
||
- **VectorCraft** über den ArtCraft-Launcher (`C:\Program Files\VectorCraft\vectorcraft-cli.exe`, im MSI enthalten, nicht auf PATH)
|
||
- Claude Desktop **oder** Cursor (siehe unten)
|
||
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP
|
||
|
||
**Cursor:** siehe [Wurzel-README](../../README.md) und [docs/CURSOR.md](../../docs/CURSOR.md).
|
||
|
||
## Installation (Claude Desktop)
|
||
|
||
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
|
||
|
||
1. `vectorcraft-mcp-v0.2.0.mcpb` und `vectorcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.mcpb) laden.
|
||
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
|
||
3. **Lese-Ordner weit:** `Dokumente`. **Schreib-Ordner eng und darin:** `Dokumente\Claude`. VectorCraft lehnt es ab, eine selbst geschriebene Datei wieder zu öffnen, wenn der Schreib-Ordner außerhalb des Lese-Ordners liegt.
|
||
4. Unter Einstellungen → Erweiterungen prüfen, dass **VectorCraft for Claude** eingeschaltet ist.
|
||
5. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
|
||
6. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.
|
||
|
||
**Umsteigen von der manuellen Config:** Eintrag `vectorcraft` unter `mcpServers` vor der Installation entfernen.
|
||
|
||
## Ordner und Start
|
||
|
||
Ohne Lese- und Schreib-Ordner versucht der Server zuerst, eine laufende App auf `127.0.0.1:7979` zu erreichen. Mit beiden Ordnern läuft er ohne Fenster. Deshalb nie ohne die Ordner-Argumente starten. Die Cursor-Übersetzung übernimmt dieselben Argumente.
|
||
|
||
| | Standard |
|
||
|---|---|
|
||
| Lesen | `${HOME}/Documents` |
|
||
| Schreiben | `${HOME}/Documents/Claude` |
|
||
|
||
## Freigaben
|
||
|
||
In Claude bei `open_file`, `save_file` und `export` auf **„Immer fragen“** lassen, wenn du Pfade mitkontrollieren willst.
|
||
|
||
## Enthaltene Software
|
||
|
||
Die Erweiterung steuert [VectorCraft](https://github.com/storytold/vectorcraft) (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`. Das Icon ist die App-Kachel aus `assets/app-icon/` (512×512, ebenfalls MIT oder Apache-2.0).
|
||
|
||
## Test
|
||
|
||
Neuen Chat öffnen und ein Typenschild 100×50 mm als DXF exportieren lassen. Im CAD prüfen, ob die Maße 100×50 mm sind. Präfix `…VectorCraft_for_Claude…`.
|
||
|
||
Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\VectorCraft\vectorcraft-cli.exe`? Neu starten, neuer Chat.
|
||
|
||
## Stolpersteine
|
||
|
||
- „path rejected“ oder die gespeicherte Datei lässt sich nicht wieder öffnen: Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → VectorCraft for Claude.
|
||
- Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.
|
||
|
||
## Deinstallation/Update
|
||
|
||
Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue `.mcpb` und Skill-ZIP, ersetzen lassen, neu starten.
|
||
|
||
## Alternative: manuell (für Entwickler)
|
||
|
||
Statt der Erweiterung in `claude_desktop_config.json` eintragen. Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md).
|
||
|
||
- Claude-Installer: `%APPDATA%\Claude\claude_desktop_config.json`
|
||
- Microsoft-Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"vectorcraft": {
|
||
"command": "C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe",
|
||
"args": [
|
||
"mcp",
|
||
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
|
||
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Die Ordner-Argumente nicht weglassen, sonst spricht der Server zuerst `127.0.0.1:7979` an.
|
||
|
||
## Änderungen
|
||
|
||
[CHANGELOG.md](CHANGELOG.md)
|