Compare commits

...
71 changed files with 1943 additions and 182 deletions

No files matched your search

+8 -5
View File
@@ -36,20 +36,23 @@ skills/<name>/
--- ---
``` ```
`name` muss dem Ordnernamen entsprechen. `description` ist Pflicht, höchstens 1024 Zeichen, ohne spitze Klammern. Keine clientspezifischen Zusatzfelder. Dieselbe `description` erscheint in der Tabelle der Wurzel-README. `name` muss dem Ordnernamen entsprechen. `description` ist Pflicht, höchstens 1024 Zeichen, ohne spitze Klammern. Keine clientspezifischen Zusatzfelder. Dieselbe `description` erscheint in der Wurzel-README: der Text vor „Verwenden“ als Kurztext, der Rest kursiv darunter.
- **Kodierung:** UTF-8 ohne BOM, Zeilenenden LF (regelt `.gitattributes`). - **Kodierung:** UTF-8 ohne BOM, Zeilenenden LF (regelt `.gitattributes`).
- **CHANGELOG.md:** Einträge als `## x.y.z (YYYY-MM-DD)`, neuester oben. - **CHANGELOG.md:** Einträge als `## x.y.z (YYYY-MM-DD)`, neuester oben.
## Cursor ## Cursor
Jedes Skill mit `extension/` bekommt beim Build **automatisch ein eigenes Cursor-Plugin** (`dist/<name>-cursor-v<ver>.zip`) und eine Tabellenzeile inkl. 1-Klick-Deeplink. 1:1 zur Claude-Seite: eine `.mcpb` ↔ ein Cursor-Plugin. **Keine Sammel-Plugins.** Build: `scripts/build-cursor` (von `package-all` aufgerufen). Nur `cursor/plugin-template/` liegt im Git; Ausgaben unter `dist/cursor/`. Jedes Skill mit `extension/` bekommt beim Build **automatisch ein eigenes Cursor-Plugin** (`dist/<name>-cursor-v<ver>.zip`) und einen Eintrag in der Wurzel-README inkl. 1-Klick-Deeplink. 1:1 zur Claude-Seite: eine `.mcpb` ↔ ein Cursor-Plugin. **Keine Sammel-Plugins.** Build: `scripts/build-cursor` (von `package-all` aufgerufen). Nur `cursor/plugin-template/` liegt im Git; Ausgaben unter `dist/cursor/`.
## Besonderheiten einzelner Server ## Besonderheiten einzelner Server
- **PdfCraft** startet mit `--compact`. Ohne die Option sind es 171 Werkzeuge mit etwa 176 KB Beschreibung. Cursor begrenzt die aktiven Werkzeuge (siehe [docs/CURSOR.md](docs/CURSOR.md)); dieselbe Option steht deshalb auch im Plugin. - **PdfCraft** startet mit `--compact`. Ohne die Option sind es 171 Werkzeuge mit etwa 176 KB Beschreibung. Cursor begrenzt die aktiven Werkzeuge (siehe [docs/CURSOR.md](docs/CURSOR.md)); dieselbe Option steht deshalb auch im Plugin.
- **FigCraft:** kein `--attach`. Mit Lese- und Schreib-Ordner ist die Anbindung an eine laufende App nicht erlaubt. - **FigCraft:** `mcp --attach PORT` hängt an der laufenden App (`figcraft --control PORT`) und lehnt die Ordner-Flags ab. Die Erweiterung setzt die Ordner und damit kein `--attach`.
- **VectorCraft:** ohne Ordner-Argumente versucht der Server zuerst `127.0.0.1:7979`. Mit Lese- und Schreib-Ordner läuft er ohne Fenster. Die Cursor-Übersetzung muss diese Argumente übernehmen. - **VectorCraft:** ohne Ordner-Argumente versucht der Server zuerst `127.0.0.1:7979` und fällt sonst auf kopflos zurück. Mit Lese- und Schreib-Ordner läuft er kopflos. Die Cursor-Übersetzung muss diese Argumente übernehmen.
- **SolidCraft:** eigener Installer, nicht der ArtCraft-Launcher. Zwei `--allow-path` (Lese- und Schreib-Ordner), der Server läuft ohne Fenster. Kein `--connect`, kein `--allow-any-path`. - **SolidCraft:** eigener Installer, nicht der ArtCraft-Launcher. Zwei `--allow-path`, kein `--allow-any-path`. Die Erweiterung startet ohne `--connect` (kopflos). `--connect 127.0.0.1:PORT` steuert die App (`solidcraft --control PORT`); ohne lauschende App scheitern die Entwurfswerkzeuge. `solvecraft-cli.exe` ist nur ein Alias.
- **CADCraft:** `mcp` kopflos. Optional `mcp --connect HOST:PORT` (`--lazy`, `--launch`). Keine Ordner-Flags.
- **EffectCraft:** `mcp --empty` mit Lese- und Schreib-Ordner. `--autosave` und `--bridge PORT` schließen sich aus.
- **FilmCraft:** `mcp` kopflos, keine Ordner-Flags. An die App: `--bridge 127.0.0.1:PORT` vor dem Unterbefehl `mcp`.
- **Schreib-Ordner im Lese-Ordner** (Standard: Dokumente und Dokumente/Claude). PdfCraft und VectorCraft öffnen eigene Ergebnisse sonst nicht wieder. Bei FigCraft ist die Lage egal; der Standard bleibt derselbe. - **Schreib-Ordner im Lese-Ordner** (Standard: Dokumente und Dokumente/Claude). PdfCraft und VectorCraft öffnen eigene Ergebnisse sonst nicht wieder. Bei FigCraft ist die Lage egal; der Standard bleibt derselbe.
## Neuer Skill ## Neuer Skill
+104 -19
View File
@@ -1,37 +1,122 @@
# claude-skills # claude-skills
Sammlung von Skills für Claude und Cursor. Jeder Skill ist ein abgeschlossener Ordner: `SKILL.md` für den Agenten (clientneutral), `README.md` für Menschen. Fertige Pakete liegen unter [Releases](https://git.gundel.dev/dg/claude-skills/releases). Sammlung von Skills für Claude und Cursor. Jeder Skill ist ein abgeschlossener Ordner: `SKILL.md` für den Agenten (clientneutral), `README.md` für Menschen.
**Für Kollegen (Claude Desktop):** [docs/INSTALLATION.md](docs/INSTALLATION.md). <table>
**Cursor:** Kurz unten, Details in [docs/CURSOR.md](docs/CURSOR.md). <tr>
<td align="center" width="33%"><a href="docs/INSTALLATION.md"><strong>Claude Desktop</strong></a><br><small>Skill hochladen</small></td>
<td align="center" width="33%"><a href="docs/CURSOR.md"><strong>Cursor</strong></a><br><small>Plugin oder 1-Klick</small></td>
<td align="center" width="33%"><a href="https://git.gundel.dev/dg/claude-skills/releases"><strong>Releases</strong></a><br><small>ZIP, Erweiterung, Plugin</small></td>
</tr>
</table>
## Skills ## Skills
<!-- skills:start --> <!-- skills:start -->
| Skill | Kurzbeschreibung | Version | Doku | Download | Erweiterung (.mcpb) | Cursor-Plugin | Cursor 1-Klick | ### [cadcraft-mcp](skills/cadcraft-mcp/) · `v0.1.0`
|---|---|---|---|---|---|---|---|
| [figcraft-mcp](skills/figcraft-mcp/) | Bedienoberflächen und Screens über den FigCraft-MCP-Server entwerfen, bearbeiten, ansehen und als PNG, PDF, SVG oder .fig exportieren (Figma-Klon, frühe Alpha). Verwenden, wenn FigCraft-Werkzeuge verbunden sind oder der Nutzer FigCraft nennt; typisch für HMI-Masken von Maschinensteuerungen, App-/Web-Entwürfe, Klick-Prototypen und Komponenten. | 0.1.0 | [README](skills/figcraft-mcp/README.md) | [figcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.zip) | [figcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.mcpb) | [figcraft-mcp-cursor-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-cursor-v0.1.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=figcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9GaWdDcmFmdC9maWdjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19) | > 2D/3D-Zeichnungen (DXF, DWG) mit dem CADCraft-MCP-Server öffnen, zeichnen, abfragen und als DXF, DWG, SVG, PNG oder PDF ausgeben.
| [gridcraft-mcp](skills/gridcraft-mcp/) | Excel-Arbeitsmappen (.xlsx, .csv) mit dem GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen und prüfen. Verwenden, wenn GridCraft-Werkzeuge verbunden sind oder der Nutzer GridCraft nennt; typisch für Kalkulationen, Stücklisten (BOM), Listen, Diagramme, PDF-Export. Nicht für eingebaute xlsx-Hilfen ohne GridCraft-Server. | 0.3.0 | [README](skills/gridcraft-mcp/README.md) | [gridcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.zip) | [gridcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.mcpb) | [gridcraft-mcp-cursor-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-cursor-v0.3.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=gridcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9HcmlkQ3JhZnQvZ3JpZGNyYWZ0LWNsaS5leGUiLCJhcmdzIjpbIm1jcCJdfQ) |
| [pdfcraft-mcp](skills/pdfcraft-mcp/) | PDFs über den PdfCraft-MCP-Server öffnen, auslesen, schwärzen, bereinigen, zusammenführen, aufteilen, mit Kopf-/Fußzeile, Seitenzahlen, Wasserzeichen und Lesezeichen versehen und nach Word exportieren. Verwenden, wenn PdfCraft-Werkzeuge verbunden sind oder der Nutzer PdfCraft nennt; typisch für Schwärzen vor der Weitergabe, Dokumentationspakete (Betriebsanleitung, Datenblätter, Konformitätserklärung), Angebote und Zeichnungen auslesen. | 0.1.0 | [README](skills/pdfcraft-mcp/README.md) | [pdfcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.zip) | [pdfcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.mcpb) | [pdfcraft-mcp-cursor-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-cursor-v0.1.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=pdfcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9QZGZDcmFmdC9wZGZjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWNvbXBhY3QiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19) | *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).*
| [solidcraft-mcp](skills/solidcraft-mcp/) | parametrische 3D-Teile über den SolidCraft-MCP-Server bauen, ändern, messen und als .solidcraft, STEP, STL oder 3MF ausgeben. Verwenden, wenn SolidCraft-Werkzeuge verbunden sind oder der Nutzer SolidCraft nennt; typisch für Laschen, Platten, Gehäuse, Bohrbilder. Nicht für 2D-DXF (VectorCraft) und nicht für native SOLIDWORKS-Dateien. | 0.1.0 | [README](skills/solidcraft-mcp/README.md) | [solidcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-v0.1.0.zip) | [solidcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-v0.1.0.mcpb) | [solidcraft-mcp-cursor-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-cursor-v0.1.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=solidcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9Tb2xpZENyYWZ0L3NvbGlkY3JhZnQtY2xpLmV4ZSIsImFyZ3MiOlsibWNwIiwiLS1hbGxvdy1wYXRoIiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hbGxvdy1wYXRoIiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzL0NsYXVkZSJdfQ) |
| [vectorcraft-mcp](skills/vectorcraft-mcp/) | 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. 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. | 0.1.0 | [README](skills/vectorcraft-mcp/README.md) | [vectorcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.zip) | [vectorcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.mcpb) | [vectorcraft-mcp-cursor-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-cursor-v0.1.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=vectorcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9WZWN0b3JDcmFmdC92ZWN0b3JjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19) | [Doku](skills/cadcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.zip "cadcraft-mcp-v0.1.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.mcpb "cadcraft-mcp-v0.1.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-cursor-v0.1.0.zip "cadcraft-mcp-cursor-v0.1.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cadcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9DQURDcmFmdC9jYWRjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiXX0)
| [wordcraft-mcp](skills/wordcraft-mcp/) | Word-Dokumente (.docx, .odt, .md, PDF) mit dem WordCraft-MCP-Server erstellen, bearbeiten und prüfen (inkl. Nachverfolgung). Verwenden, wenn WordCraft-Werkzeuge verbunden sind oder der Nutzer WordCraft nennt; typisch für Angebote, Briefe, Betriebsanleitungen, Arbeitsanweisungen, 8D-Reports, Vorlagen. Nicht für eingebaute docx-Hilfen ohne WordCraft-Server. | 0.3.0 | [README](skills/wordcraft-mcp/README.md) | [wordcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.zip) | [wordcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) | [wordcraft-mcp-cursor-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-cursor-v0.3.0.zip) | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=wordcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9Xb3JkQ3JhZnQvd29yZGNyYWZ0LWNsaS5leGUiLCJhcmdzIjpbIm1jcCIsIi0tYXV0aG9yIiwiQ2xhdWRlIiwiLS1hdXRvbWF0aW9uLXJlYWQtcm9vdCIsIiR7dXNlckhvbWV9L0RvY3VtZW50cyIsIi0tYXV0b21hdGlvbi13cml0ZS1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzL0NsYXVkZSJdfQ) |
---
### [effectcraft-mcp](skills/effectcraft-mcp/) · `v0.1.0`
> Motion-Graphics und Compositings (.ecproj) mit dem EffectCraft-MCP-Server aufbauen, keyframen und rendern.
*Verwenden, wenn EffectCraft-Werkzeuge verbunden sind oder der Nutzer EffectCraft nennt; typisch für Titel, Bauchbinden, einfache Animationen, Standbilder und Filmexporte. Nicht für den Schnitt einer Timeline aus Clips (FilmCraft).*
[Doku](skills/effectcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.zip "effectcraft-mcp-v0.1.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.mcpb "effectcraft-mcp-v0.1.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-cursor-v0.1.0.zip "effectcraft-mcp-cursor-v0.1.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=effectcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9FZmZlY3RDcmFmdC9lZmZlY3RjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWVtcHR5IiwiLS1hdXRvbWF0aW9uLXJlYWQtcm9vdCIsIiR7dXNlckhvbWV9L0RvY3VtZW50cyIsIi0tYXV0b21hdGlvbi13cml0ZS1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzL0NsYXVkZSJdfQ)
---
### [figcraft-mcp](skills/figcraft-mcp/) · `v0.2.0`
> Bedienoberflächen und Screens über den FigCraft-MCP-Server entwerfen, bearbeiten, ansehen und als PNG, PDF, SVG oder .fig exportieren (Figma-Klon, frühe Alpha).
*Verwenden, wenn FigCraft-Werkzeuge verbunden sind oder der Nutzer FigCraft nennt; typisch für HMI-Masken von Maschinensteuerungen, App-/Web-Entwürfe, Klick-Prototypen und Komponenten.*
[Doku](skills/figcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.zip "figcraft-mcp-v0.2.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.mcpb "figcraft-mcp-v0.2.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-cursor-v0.2.0.zip "figcraft-mcp-cursor-v0.2.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=figcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9GaWdDcmFmdC9maWdjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19)
---
### [filmcraft-mcp](skills/filmcraft-mcp/) · `v0.1.0`
> Schnitte (.fcproj) mit dem FilmCraft-MCP-Server importieren, schneiden und exportieren.
*Verwenden, wenn FilmCraft-Werkzeuge verbunden sind oder der Nutzer FilmCraft nennt; typisch für Rohschnitt, Titel auf der Timeline, Export nach h264, ProRes, DNxHR oder als Bildsequenz. Nicht für Compositing und Keyframes (EffectCraft).*
[Doku](skills/filmcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.zip "filmcraft-mcp-v0.1.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.mcpb "filmcraft-mcp-v0.1.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-cursor-v0.1.0.zip "filmcraft-mcp-cursor-v0.1.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=filmcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9GaWxtQ3JhZnQvZmlsbWNyYWZ0LWNsaS5leGUiLCJhcmdzIjpbIm1jcCJdfQ)
---
### [gridcraft-mcp](skills/gridcraft-mcp/) · `v0.4.0`
> Excel-Arbeitsmappen (.xlsx, .xlsm, .xls, .xlsb, .ods, .csv) mit dem GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen und prüfen, einschließlich Pivot-Tabellen.
*Verwenden, wenn GridCraft-Werkzeuge verbunden sind oder der Nutzer GridCraft nennt; typisch für Kalkulationen, Stücklisten (BOM), Listen, Diagramme, Pivot, PDF-Export. Nicht für eingebaute xlsx-Hilfen ohne GridCraft-Server.*
[Doku](skills/gridcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.zip "gridcraft-mcp-v0.4.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.mcpb "gridcraft-mcp-v0.4.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-cursor-v0.4.0.zip "gridcraft-mcp-cursor-v0.4.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=gridcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9HcmlkQ3JhZnQvZ3JpZGNyYWZ0LWNsaS5leGUiLCJhcmdzIjpbIm1jcCJdfQ)
---
### [pdfcraft-mcp](skills/pdfcraft-mcp/) · `v0.2.0`
> PDFs über den PdfCraft-MCP-Server öffnen, auslesen, schwärzen, bereinigen, zusammenführen, aufteilen, mit Kopf-/Fußzeile, Seitenzahlen, Wasserzeichen und Lesezeichen versehen und nach Word exportieren.
*Verwenden, wenn PdfCraft-Werkzeuge verbunden sind oder der Nutzer PdfCraft nennt; typisch für Schwärzen vor der Weitergabe, Dokumentationspakete (Betriebsanleitung, Datenblätter, Konformitätserklärung), Angebote und Zeichnungen auslesen.*
[Doku](skills/pdfcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.zip "pdfcraft-mcp-v0.2.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.mcpb "pdfcraft-mcp-v0.2.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-cursor-v0.2.0.zip "pdfcraft-mcp-cursor-v0.2.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=pdfcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9QZGZDcmFmdC9wZGZjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWNvbXBhY3QiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19)
---
### [solidcraft-mcp](skills/solidcraft-mcp/) · `v0.3.0`
> Parametrische 3D-Teile über den SolidCraft-MCP-Server bauen, ändern, messen und als .solidcraft, STEP, STL, OBJ oder 3MF ausgeben.
*Verwenden, wenn SolidCraft-Werkzeuge verbunden sind oder der Nutzer SolidCraft nennt; typisch für Laschen, Platten, Gehäuse, Bohrbilder, Baugruppen. Nicht für Laser-DXF (VectorCraft), nicht für DXF/DWG-Zeichnungen (CADCraft) und nicht für native SOLIDWORKS-Dateien.*
[Doku](skills/solidcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.zip "solidcraft-mcp-v0.3.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.mcpb "solidcraft-mcp-v0.3.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-cursor-v0.3.0.zip "solidcraft-mcp-cursor-v0.3.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=solidcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9Tb2xpZENyYWZ0L3NvbGlkY3JhZnQtY2xpLmV4ZSIsImFyZ3MiOlsibWNwIiwiLS1hbGxvdy1wYXRoIiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hbGxvdy1wYXRoIiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzL0NsYXVkZSJdfQ)
---
### [vectorcraft-mcp](skills/vectorcraft-mcp/) · `v0.2.0`
> 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.*
[Doku](skills/vectorcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.zip "vectorcraft-mcp-v0.2.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.mcpb "vectorcraft-mcp-v0.2.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-cursor-v0.2.0.zip "vectorcraft-mcp-cursor-v0.2.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=vectorcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9WZWN0b3JDcmFmdC92ZWN0b3JjcmFmdC1jbGkuZXhlIiwiYXJncyI6WyJtY3AiLCItLWF1dG9tYXRpb24tcmVhZC1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzIiwiLS1hdXRvbWF0aW9uLXdyaXRlLXJvb3QiLCIke3VzZXJIb21lfS9Eb2N1bWVudHMvQ2xhdWRlIl19)
---
### [wordcraft-mcp](skills/wordcraft-mcp/) · `v0.4.0`
> Word-Dokumente (.docx, .odt, .md, PDF) mit dem WordCraft-MCP-Server erstellen, bearbeiten und prüfen (inkl. Nachverfolgung).
*Verwenden, wenn WordCraft-Werkzeuge verbunden sind oder der Nutzer WordCraft nennt; typisch für Angebote, Briefe, Betriebsanleitungen, Arbeitsanweisungen, 8D-Reports, Vorlagen. Nicht für eingebaute docx-Hilfen ohne WordCraft-Server.*
[Doku](skills/wordcraft-mcp/README.md) · [Skill-ZIP](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.zip "wordcraft-mcp-v0.4.0.zip") · [Erweiterung](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.mcpb "wordcraft-mcp-v0.4.0.mcpb") · [Cursor-Plugin](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-cursor-v0.4.0.zip "wordcraft-mcp-cursor-v0.4.0.zip") · [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=wordcraft&config=eyJjb21tYW5kIjoiQzovUHJvZ3JhbSBGaWxlcy9Xb3JkQ3JhZnQvd29yZGNyYWZ0LWNsaS5leGUiLCJhcmdzIjpbIm1jcCIsIi0tYXV0aG9yIiwiQ2xhdWRlIiwiLS1hdXRvbWF0aW9uLXJlYWQtcm9vdCIsIiR7dXNlckhvbWV9L0RvY3VtZW50cyIsIi0tYXV0b21hdGlvbi13cml0ZS1yb290IiwiJHt1c2VySG9tZX0vRG9jdW1lbnRzL0NsYXVkZSJdfQ)
<!-- skills:end --> <!-- skills:end -->
## Skill installieren (Claude) ## Skill installieren (Claude)
1. In der Tabelle das ZIP des Skills laden. 1. Beim Skill **Skill-ZIP** laden.
2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen. 2. In Claude **„+“ → „Skill erstellen“ → „Skill hochladen“** wählen und das ZIP hochladen.
3. Zusätzlich die `.mcpb`-Erweiterung installieren und einschalten (siehe [INSTALLATION.md](docs/INSTALLATION.md)). 3. Die **Erweiterung** (.mcpb) installieren und einschalten ([INSTALLATION.md](docs/INSTALLATION.md)).
## In Cursor installieren ## In Cursor installieren
1. Voraussetzung: ArtCraft-Launcher mit der jeweiligen App ([Abschnitt 1](docs/INSTALLATION.md#1-artcraft-launcher-und-apps-installieren)). SolidCraft hat einen eigenen Installer ([Abschnitt 1b](docs/INSTALLATION.md#1b-solidcraft-installieren)). Voraussetzung: ArtCraft-Launcher mit der jeweiligen App ([Abschnitt 1](docs/INSTALLATION.md#1-artcraft-launcher-und-apps-installieren)). SolidCraft hat einen eigenen Installer ([Abschnitt 1b](docs/INSTALLATION.md#1b-solidcraft-installieren)).
2. Cursor-Plugin-ZIP aus der Tabelle laden → nach `~/.cursor/plugins/local/<skill>` entpacken → **Developer: Reload Window**. Jedes Werkzeug einzeln, wie in Claude.
3. Alternativ: „Add to Cursor“ (1-Klick) für den MCP-Server und den Skill-Ordner nach `~/.cursor/skills/` kopieren. 1. **Cursor-Plugin** laden, nach `~/.cursor/plugins/local/<skill>` entpacken (Windows: `%USERPROFILE%\.cursor\plugins\local\<skill>`), dann **Developer: Reload Window**. Jedes Werkzeug einzeln, wie in Claude.
4. WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft: Lese-/Schreib-Ordner prüfen (Standard: Lese = Dokumente, Schreib = Dokumente\Claude, Schreib-Ordner darin). PdfCraft startet mit `--compact`. VectorCraft nie ohne die Ordner-Argumente starten. SolidCraft mit zwei `--allow-path`, ohne `--connect`. 2. Alternativ: **Add to Cursor** für den MCP-Server, und den Skill-Ordner nach `~/.cursor/skills/` kopieren.
5. Test: im Agent „Sind die WordCraft-Werkzeuge verfügbar?“ – und je App einen kleinen Auftrag aus dem Skill. 3. WordCraft, PdfCraft, FigCraft, VectorCraft, EffectCraft und SolidCraft: Lese- und Schreib-Ordner prüfen. Standard: Lese = Dokumente, Schreib = Dokumente\Claude. Der Schreib-Ordner liegt im Lese-Ordner. PdfCraft startet mit `--compact`. VectorCraft nie ohne die Ordner-Argumente starten. EffectCraft mit `--empty` und beiden Ordnern. SolidCraft in der Erweiterung mit zwei `--allow-path` und ohne `--connect`. CADCraft und FilmCraft starten nur mit `mcp`.
6. Auch Cursor sendet Inhalte an Cloud-Modelle → Datenschutz-Ampel in den Skills beachten. 4. Test: im Agent „Sind die WordCraft-Werkzeuge verfügbar?“ – und je App einen kleinen Auftrag aus dem Skill.
5. Auch Cursor sendet Inhalte an Cloud-Modelle. Die Datenschutz-Ampel in den Skills beachten.
Mehr: [docs/CURSOR.md](docs/CURSOR.md). Mehr: [docs/CURSOR.md](docs/CURSOR.md).
+5 -5
View File
@@ -11,18 +11,18 @@ Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine
## Plugin installieren (empfohlen) ## Plugin installieren (empfohlen)
1. `<skill>-cursor-vX.Y.Z.zip` aus dem Release laden (Spalte „Cursor-Plugin“ in der README-Tabelle). 1. `<skill>-cursor-vX.Y.Z.zip` aus dem Release laden (Link **Cursor-Plugin** beim Skill in der [README](../README.md)).
2. Nach `~/.cursor/plugins/local/<skill>` entpacken (Windows: `%USERPROFILE%\.cursor\plugins\local\<skill>`). Der Ordner muss `.cursor-plugin/plugin.json`, `skills/` und ggf. `mcp.json` enthalten. 2. Nach `~/.cursor/plugins/local/<skill>` entpacken (Windows: `%USERPROFILE%\.cursor\plugins\local\<skill>`). Der Ordner muss `.cursor-plugin/plugin.json`, `skills/` und ggf. `mcp.json` enthalten.
3. **Developer: Reload Window**. 3. **Developer: Reload Window**.
4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind. 4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind.
WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`. Der Schreib-Ordner muss im Lese-Ordner liegen (PdfCraft und VectorCraft lehnen sonst das erneute Öffnen ab; bei FigCraft ist die Lage egal, der Standard bleibt). SolidCraft übergibt beide Ordner als `--allow-path`; beide müssen gesetzt sein. WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft: Lese-/Schreib-Ordner in den Plugin-Variablen (Configure) oder in `mcp.json` prüfen. Standard: Lese = `${userHome}/Documents`, Schreib = `${userHome}/Documents/Claude`. Der Schreib-Ordner muss im Lese-Ordner liegen (PdfCraft und VectorCraft lehnen sonst das erneute Öffnen ab; bei FigCraft ist die Lage egal, der Standard bleibt). SolidCraft übergibt beide Ordner als `--allow-path`; beide müssen gesetzt sein.
PdfCraft startet mit `--compact` (17 Kernwerkzeuge plus `tool_search`/`tool_call`). VectorCraft immer mit beiden Ordner-Argumenten starten, sonst versucht der Server zuerst `127.0.0.1:7979`. FigCraft ohne `--attach`. SolidCraft immer mit beiden `--allow-path` und ohne `--connect` (kein Port 7979). PdfCraft startet mit `--compact` (17 Kernwerkzeuge plus `tool_search`/`tool_call`). VectorCraft immer mit beiden Ordner-Argumenten starten, sonst versucht der Server zuerst `127.0.0.1:7979`. FigCraft: `--attach` lehnt die Ordner-Flags ab, das Plugin setzt sie und bleibt kopflos. SolidCraft in der Erweiterung: zwei `--allow-path`, ohne `--connect`. `--connect 127.0.0.1:7878` in einer eigenen `mcp.json` spricht die App an (`solidcraft --control 7878`); lauscht sie nicht, antworten die Entwurfswerkzeuge mit `no SolidCraft app is listening`, `skill_reference` bleibt. CADCraft und FilmCraft: nur `mcp`, keine Ordner-Flags. EffectCraft: `mcp --empty` mit beiden Ordnern.
## Alternativ: nur MCP + Skill ## Alternativ: nur MCP + Skill
1. Spalte „Cursor 1-Klick“ / „Add to Cursor“ für den MCP-Server. 1. Link **Add to Cursor** beim Skill für den MCP-Server.
2. Skill-Ordner aus `dist/cursor/skills/<skill>/` (oder dem Plugin-ZIP unter `skills/<skill>/`) nach `~/.cursor/skills/<skill>/` kopieren. 2. Skill-Ordner aus `dist/cursor/skills/<skill>/` (oder dem Plugin-ZIP unter `skills/<skill>/`) nach `~/.cursor/skills/<skill>/` kopieren.
Manuelle `~/.cursor/mcp.json` (Ausschnitt WordCraft): Manuelle `~/.cursor/mcp.json` (Ausschnitt WordCraft):
@@ -108,7 +108,7 @@ VectorCraft (Ordner-Argumente nicht weglassen):
} }
``` ```
SolidCraft (zwei `--allow-path`, kein `--connect`): SolidCraft (Erweiterung: zwei `--allow-path`, kein `--connect`. Eine eigene `mcp.json` darf `--connect 127.0.0.1:7878` zusätzlich setzen, wenn die App mit `solidcraft --control 7878` läuft):
```json ```json
{ {
@@ -146,7 +146,7 @@ Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. die andere App. Pd
| Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? | | Keine Werkzeuge | Plugin unter `plugins/local/<skill>`? Reload? CLI unter `C:\Program Files\…`? |
| path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). Er muss im Lese-Ordner liegen. | | path rejected | Schreib-Ordner prüfen (`WRITE_ROOT` / mcp.json). Er muss im Lese-Ordner liegen. |
| VectorCraft spricht Port 7979 an | Ordner-Argumente fehlen. Plugin-`mcp.json` prüfen. | | VectorCraft spricht Port 7979 an | Ordner-Argumente fehlen. Plugin-`mcp.json` prüfen. |
| SolidCraft erreicht die Datei nicht | Beide `--allow-path` in der Plugin-`mcp.json`. Kein `--connect` und kein Port 7979. | | SolidCraft: `no SolidCraft app is listening` | Die `mcp.json` hat `--connect`, die App lauscht nicht. `solidcraft --control 7878` starten, oder `--connect` weglassen (kopflos, wie die Erweiterung). |
| Zu viele Werkzeuge / PdfCraft wirkt abgeschnitten | `--compact` muss in den Args stehen. | | Zu viele Werkzeuge / PdfCraft wirkt abgeschnitten | `--compact` muss in den Args stehen. |
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft`, `gridcraft`, `pdfcraft`, `figcraft`, `vectorcraft`, `solidcraft`) registriert. | | Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft`, `gridcraft`, `pdfcraft`, `figcraft`, `vectorcraft`, `solidcraft`) registriert. |
+21 -15
View File
@@ -1,6 +1,6 @@
# Claude-Werkzeuge einrichten # Claude-Werkzeuge einrichten
Mit dieser Anleitung kann Claude auf deinem Rechner Word-Dokumente, Excel-Tabellen, PDFs, Oberflächen-Entwürfe, Vektorgrafiken und parametrische 3D-Teile bearbeiten. Dauer: etwa 10 Minuten je Werkzeug. Du brauchst keine Programmierkenntnisse. Mit dieser Anleitung kann Claude auf deinem Rechner Word-Dokumente, Excel-Tabellen, PDFs, Oberflächen-Entwürfe, Vektorgrafiken, DXF/DWG, Compositings, Schnitte und parametrische 3D-Teile bearbeiten. Dauer: etwa 10 Minuten je Werkzeug. Du brauchst keine Programmierkenntnisse.
Für jedes Werkzeug installierst du zwei Dinge: Für jedes Werkzeug installierst du zwei Dinge:
@@ -32,8 +32,11 @@ Installiere den [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die
| PdfCraft | Schwärzen, Doku-Pakete | `C:\Program Files\PdfCraft\pdfcraft-cli.exe` | | PdfCraft | Schwärzen, Doku-Pakete | `C:\Program Files\PdfCraft\pdfcraft-cli.exe` |
| FigCraft | HMI-/Oberflächen-Entwürfe | `C:\Program Files\FigCraft\figcraft-cli.exe` | | FigCraft | HMI-/Oberflächen-Entwürfe | `C:\Program Files\FigCraft\figcraft-cli.exe` |
| VectorCraft | Typenschilder, Schilder, DXF für Laser | `C:\Program Files\VectorCraft\vectorcraft-cli.exe` | | VectorCraft | Typenschilder, Schilder, DXF für Laser | `C:\Program Files\VectorCraft\vectorcraft-cli.exe` |
| CADCraft | DXF/DWG-Zeichnungen | `C:\Program Files\CADCraft\cadcraft-cli.exe` |
| EffectCraft | Compositing, .ecproj | `C:\Program Files\EffectCraft\effectcraft-cli.exe` |
| FilmCraft | Schnitt, .fcproj | `C:\Program Files\FilmCraft\filmcraft-cli.exe` |
FigCraft steht im Launcher seit Version **0.4.1**. Ältere Kataloge mit zwölf Apps führen es nicht. Fehlt die Kachel, den Launcher aktualisieren. Installer: [GitHub Releases](https://github.com/storytold/craft-launcher/releases). FigCraft steht im Launcher seit Version **0.4.1**. Ältere Kataloge mit zwölf Apps führen es nicht. Fehlt die Kachel, den Launcher aktualisieren. Installer: [GitHub Releases](https://github.com/storytold/craft-launcher/releases). CADCraft, EffectCraft und FilmCraft sind am 26.10.2026 unter `C:\Program Files` installiert (Publisher Learning Machines LLC). Ob der Launcher dafür eine Kachel hat, ist nicht geprüft.
## 1b. SolidCraft installieren ## 1b. SolidCraft installieren
@@ -43,20 +46,23 @@ SolidCraft wird getrennt vom ArtCraft-Launcher installiert. Installer: [GitHub R
|---|---|---| |---|---|---|
| SolidCraft | parametrische 3D-Teile, STEP, STL, 3MF | `C:\Program Files\SolidCraft\solidcraft-cli.exe` | | SolidCraft | parametrische 3D-Teile, STEP, STL, 3MF | `C:\Program Files\SolidCraft\solidcraft-cli.exe` |
Die CLI ist **nicht** auf PATH. Die Erweiterung enthält sie nicht. Der MCP-Server läuft ohne Fenster und bekommt zwei Argumente `--allow-path` (Lese-Ordner und Schreib-Ordner). Kein `--connect`, kein `--allow-any-path`. Skill-Version: **0.1.0**. Die CLI ist **nicht** auf PATH. Die Erweiterung enthält sie nicht. Die Erweiterung startet kopflos mit zwei `--allow-path` (Lese-Ordner und Schreib-Ordner), ohne `--connect` und ohne `--allow-any-path`. `--connect 127.0.0.1:PORT` ist ein anderer Start und braucht `solidcraft --control PORT`. `solvecraft-cli.exe` ist nur ein Alias. Skill-Version: **0.3.0**.
--- ---
## 2. Dateien herunterladen ## 2. Dateien herunterladen
Lade die passende Version herunter (WordCraft und GridCraft **0.3.0**, PdfCraft, FigCraft, VectorCraft und SolidCraft **0.1.0**): Lade die passende Version herunter (WordCraft und GridCraft **0.4.0**, PdfCraft, FigCraft und VectorCraft **0.2.0**, SolidCraft **0.3.0**, CADCraft, EffectCraft und FilmCraft **0.1.0**):
- [wordcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) und [wordcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.zip) - [wordcraft-mcp-v0.4.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.mcpb) und [wordcraft-mcp-v0.4.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.zip)
- [gridcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.mcpb) und [gridcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.zip) - [gridcraft-mcp-v0.4.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.mcpb) und [gridcraft-mcp-v0.4.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.zip)
- [pdfcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.mcpb) und [pdfcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.zip) - [pdfcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.mcpb) und [pdfcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.zip)
- [figcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.mcpb) und [figcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.zip) - [figcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.mcpb) und [figcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.zip)
- [vectorcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.mcpb) und [vectorcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.zip) - [vectorcraft-mcp-v0.2.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.mcpb) und [vectorcraft-mcp-v0.2.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.2.0/vectorcraft-mcp-v0.2.0.zip)
- [solidcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-v0.1.0.mcpb) und [solidcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-v0.1.0.zip) - [solidcraft-mcp-v0.3.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.mcpb) und [solidcraft-mcp-v0.3.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.zip)
- [cadcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.mcpb) und [cadcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.zip)
- [effectcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.mcpb) und [effectcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.zip)
- [filmcraft-mcp-v0.1.0.mcpb](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.mcpb) und [filmcraft-mcp-v0.1.0.zip](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.zip)
Die ZIP-Dateien **nicht entpacken**. Die ZIP-Dateien **nicht entpacken**.
@@ -70,10 +76,10 @@ Für jede `.mcpb`-Datei:
2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen. 2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen.
*Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen. *Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen.
3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen. 3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen.
4. **WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft** fragen nach zwei Ordnern. GridCraft nicht. 4. **WordCraft, PdfCraft, FigCraft, VectorCraft, EffectCraft und SolidCraft** fragen nach zwei Ordnern. GridCraft, CADCraft und FilmCraft nicht.
- **Lese-Ordner (weit):** `Dokumente`. - **Lese-Ordner (weit):** `Dokumente`.
- **Schreib-Ordner (eng, und bei PdfCraft und VectorCraft darin):** `Dokumente\Claude`. PdfCraft und VectorCraft öffnen eigene Ergebnisse sonst nicht wieder. Bei FigCraft ist die Lage egal; denselben Standard verwenden. - **Schreib-Ordner (eng, und bei PdfCraft und VectorCraft darin):** `Dokumente\Claude`. PdfCraft und VectorCraft öffnen eigene Ergebnisse sonst nicht wieder. Bei FigCraft ist die Lage egal; denselben Standard verwenden.
- **SolidCraft:** beide Ordner ausfüllen. Jeder wird als `--allow-path` übergeben. Fehlt ein Ordner, kann der Agent dort nicht speichern. Der Server startet ohne Fenster und ohne `--connect`. - **SolidCraft:** beide Ordner ausfüllen. Jeder wird als `--allow-path` übergeben. Die Erweiterung startet ohne `--connect`.
5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen. 5. Installieren. Die Erweiterung erscheint unter Einstellungen → Erweiterungen.
**Danach unter Einstellungen → Erweiterungen prüfen, dass die Erweiterungen eingeschaltet sind.** Frisch installierte Erweiterungen können ausgeschaltet sein. **Danach unter Einstellungen → Erweiterungen prüfen, dass die Erweiterungen eingeschaltet sind.** Frisch installierte Erweiterungen können ausgeschaltet sein.
@@ -90,7 +96,7 @@ Für jede `.zip`-Datei:
1. In Claude auf **„+“** → **„Skill erstellen“** → **„Skill hochladen“**. 1. In Claude auf **„+“** → **„Skill erstellen“** → **„Skill hochladen“**.
2. Die ZIP-Datei auswählen und bestätigen. 2. Die ZIP-Datei auswählen und bestätigen.
Die Skills heißen danach `wordcraft-mcp`, `gridcraft-mcp`, `pdfcraft-mcp`, `figcraft-mcp`, `vectorcraft-mcp` und `solidcraft-mcp`. Die Skills heißen danach `wordcraft-mcp`, `gridcraft-mcp`, `pdfcraft-mcp`, `figcraft-mcp`, `vectorcraft-mcp`, `solidcraft-mcp`, `cadcraft-mcp`, `effectcraft-mcp` und `filmcraft-mcp`.
--- ---
@@ -137,7 +143,7 @@ Lass bei WordCraft `open_document` / `save_document`, bei GridCraft `open_workbo
| Claude sagt, die Werkzeuge fehlen | Einstellungen → Erweiterungen: ist die Erweiterung eingeschaltet? Einschalten, dann neuen Chat öffnen. | | Claude sagt, die Werkzeuge fehlen | Einstellungen → Erweiterungen: ist die Erweiterung eingeschaltet? Einschalten, dann neuen Chat öffnen. |
| Werkzeuge fehlen, Erweiterung ist eingeschaltet | Prüfen, ob `C:\Program Files\<App>\<app>-cli.exe` existiert; sonst über den ArtCraft-Launcher installieren. | | Werkzeuge fehlen, Erweiterung ist eingeschaltet | Prüfen, ob `C:\Program Files\<App>\<app>-cli.exe` existiert; sonst über den ArtCraft-Launcher installieren. |
| SolidCraft: Werkzeuge fehlen, Erweiterung ist eingeschaltet | `C:\Program Files\SolidCraft\solidcraft-cli.exe` prüfen. Sonst den eigenen Installer (MSI oder `winget install bherbruck.SolidCraft`). | | SolidCraft: Werkzeuge fehlen, Erweiterung ist eingeschaltet | `C:\Program Files\SolidCraft\solidcraft-cli.exe` prüfen. Sonst den eigenen Installer (MSI oder `winget install bherbruck.SolidCraft`). |
| SolidCraft speichert die Datei nicht | Beide Ordner im Dialog gesetzt? Die Args sind zwei `--allow-path`, kein `--connect`. | | SolidCraft speichert die Datei nicht | Beide Ordner im Dialog gesetzt? Die Erweiterung übergibt zwei `--allow-path`. Steht in der Config `--connect`, muss die App mit `solidcraft --control` auf demselben Port lauschen. |
| Speichern scheitert („path rejected“) | Ziel lag außerhalb des Schreib-Ordners, oder (PdfCraft, VectorCraft) der Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → die App → Einstellungen. | | Speichern scheitert („path rejected“) | Ziel lag außerhalb des Schreib-Ordners, oder (PdfCraft, VectorCraft) der Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → die App → Einstellungen. |
| FigCraft fehlt im Launcher | Launcher auf 0.4.1 oder neuer aktualisieren. | | FigCraft fehlt im Launcher | Launcher auf 0.4.1 oder neuer aktualisieren. |
| Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ | | Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ |
@@ -146,7 +152,7 @@ Lass bei WordCraft `open_document` / `save_document`, bei GridCraft `open_workbo
## Aktualisieren ## Aktualisieren
Neue Version laden, `.mcpb` erneut installieren und die neue Skill-ZIP hochladen. Fragt Claude, ob die bestehende Version ersetzt werden soll: ja. Danach Claude neu starten. Neue Version laden, `.mcpb` erneut installieren und die neue Skill-ZIP hochladen. Fragt Claude, ob die bestehende Version ersetzt werden soll: ja. Danach Claude neu starten. Claude holt diese Skills nicht von selbst aus dem Repo; es gibt keinen Sync.
## Entfernen ## Entfernen
+18
View File
@@ -52,6 +52,24 @@ $defaults = @{
RepoSlug = 'tangency-labs/solidcraft' RepoSlug = 'tangency-labs/solidcraft'
Source = 'SolidCraft-Installer' Source = 'SolidCraft-Installer'
} }
'cadcraft-mcp' = @{
ExeName = 'cadcraft-cli.exe'
Default = 'C:\Program Files\CADCraft\cadcraft-cli.exe'
Repo = 'https://github.com/storytold/cadcraft'
RepoSlug = 'storytold/cadcraft'
}
'effectcraft-mcp' = @{
ExeName = 'effectcraft-cli.exe'
Default = 'C:\Program Files\EffectCraft\effectcraft-cli.exe'
Repo = 'https://github.com/storytold/effectcraft'
RepoSlug = 'storytold/effectcraft'
}
'filmcraft-mcp' = @{
ExeName = 'filmcraft-cli.exe'
Default = 'C:\Program Files\FilmCraft\filmcraft-cli.exe'
Repo = 'https://github.com/storytold/filmcraft'
RepoSlug = 'storytold/filmcraft'
}
} }
if (-not $defaults.ContainsKey($Name)) { if (-not $defaults.ContainsKey($Name)) {
+18
View File
@@ -57,6 +57,24 @@ case "$name" in
repo_slug='tangency-labs/solidcraft' repo_slug='tangency-labs/solidcraft'
source_name='SolidCraft-Installer' source_name='SolidCraft-Installer'
;; ;;
cadcraft-mcp)
exe_name=cadcraft-cli.exe
default='C:/Program Files/CADCraft/cadcraft-cli.exe'
repo='https://github.com/storytold/cadcraft'
repo_slug='storytold/cadcraft'
;;
effectcraft-mcp)
exe_name=effectcraft-cli.exe
default='C:/Program Files/EffectCraft/effectcraft-cli.exe'
repo='https://github.com/storytold/effectcraft'
repo_slug='storytold/effectcraft'
;;
filmcraft-mcp)
exe_name=filmcraft-cli.exe
default='C:/Program Files/FilmCraft/filmcraft-cli.exe'
repo='https://github.com/storytold/filmcraft'
repo_slug='storytold/filmcraft'
;;
*) *)
echo "Kein CLI-Mapping fuer Skill '$name'." >&2 echo "Kein CLI-Mapping fuer Skill '$name'." >&2
exit 1 exit 1
+49 -15
View File
@@ -1,5 +1,5 @@
# Erzeugt die Skill-Tabelle in README.md zwischen <!-- skills:start --> und <!-- skills:end --> # Erzeugt die Skill-Uebersicht in README.md zwischen <!-- skills:start --> und <!-- skills:end -->
# neu. Mit -Check wird nur geprueft, ob die Tabelle aktuell ist (Exit-Code 1, wenn nicht). # neu. Mit -Check wird nur geprueft, ob sie aktuell ist (Exit-Code 1, wenn nicht).
# Aufruf: scripts\update-index.ps1 [-Check] # Aufruf: scripts\update-index.ps1 [-Check]
param([switch]$Check) param([switch]$Check)
. (Join-Path $PSScriptRoot 'lib.ps1') . (Join-Path $PSScriptRoot 'lib.ps1')
@@ -16,6 +16,19 @@ if ($start -lt 0 -or $end -lt $start) {
exit 1 exit 1
} }
function ConvertTo-MdText([string]$s) {
if ([string]::IsNullOrEmpty($s)) { return '' }
$map = [ordered]@{
'\' = '\\'
'*' = '\*'
'_' = '\_'
'`' = '\`'
'[' = '\['
}
foreach ($k in @($map.Keys)) { $s = $s.Replace($k, $map[$k]) }
return $s
}
$ServerKeys = @{ $ServerKeys = @{
'wordcraft-mcp' = 'wordcraft' 'wordcraft-mcp' = 'wordcraft'
'gridcraft-mcp' = 'gridcraft' 'gridcraft-mcp' = 'gridcraft'
@@ -31,10 +44,9 @@ function Get-McpServerKey([string]$SkillName) {
return $SkillName return $SkillName
} }
$table = @( # Mittelpunkt als Zeichencode: Windows PowerShell 5.1 liest .ps1 ohne BOM als ANSI.
'| Skill | Kurzbeschreibung | Version | Doku | Download | Erweiterung (.mcpb) | Cursor-Plugin | Cursor 1-Klick |', $dot = [char]0x00B7
'|---|---|---|---|---|---|---|---|' $table = @()
)
foreach ($n in (Get-SkillNames)) { foreach ($n in (Get-SkillNames)) {
$dir = Join-Path $SkillsDir $n $dir = Join-Path $SkillsDir $n
$desc = '' $desc = ''
@@ -46,17 +58,30 @@ foreach ($n in (Get-SkillNames)) {
if ($d) { $desc = $d } if ($d) { $desc = $d }
} }
} }
$desc = $desc.Replace('|', '\|') $lead = $desc.Trim()
$note = ''
$cut = $lead.IndexOf(' Verwenden')
if ($cut -gt 0) {
$note = $lead.Substring($cut + 1).Trim()
$lead = $lead.Substring(0, $cut).Trim()
}
if ($lead.Length -gt 0 -and [char]::IsLower($lead[0])) {
$lead = $lead.Substring(0, 1).ToUpperInvariant() + $lead.Substring(1)
}
$ver = Get-SkillVersion $dir $ver = Get-SkillVersion $dir
$tagEnc = [Uri]::EscapeDataString("$n/v$ver") $tagEnc = [Uri]::EscapeDataString("$n/v$ver")
$zipLink = "[{0}-v{1}.zip]({2}/releases/download/{3}/{0}-v{1}.zip)" -f $n, $ver, $RepoWeb, $tagEnc $base = "$RepoWeb/releases/download/$tagEnc"
$mcpb = '' $zipName = "$n-v$ver.zip"
$cursorZip = '' $links = @(
$deeplink = '' "[Doku](skills/$n/README.md)",
"[Skill-ZIP]($base/$zipName `"$zipName`")"
)
$extPath = Join-Path $dir 'extension\manifest.json' $extPath = Join-Path $dir 'extension\manifest.json'
if (Test-Path $extPath) { if (Test-Path $extPath) {
$mcpb = "[{0}-v{1}.mcpb]({2}/releases/download/{3}/{0}-v{1}.mcpb)" -f $n, $ver, $RepoWeb, $tagEnc $mcpbName = "$n-v$ver.mcpb"
$cursorZip = "[{0}-cursor-v{1}.zip]({2}/releases/download/{3}/{0}-cursor-v{1}.zip)" -f $n, $ver, $RepoWeb, $tagEnc $cursorName = "$n-cursor-v$ver.zip"
$links += "[Erweiterung]($base/$mcpbName `"$mcpbName`")"
$links += "[Cursor-Plugin]($base/$cursorName `"$cursorName`")"
$man = (Read-Text $extPath) | ConvertFrom-Json $man = (Read-Text $extPath) | ConvertFrom-Json
$serverKey = Get-McpServerKey $n $serverKey = Get-McpServerKey $n
$cmd = [string]$man.server.mcp_config.command $cmd = [string]$man.server.mcp_config.command
@@ -70,9 +95,18 @@ foreach ($n in (Get-SkillNames)) {
} }
$transport = @{ command = $cmd; args = @($argsList) } $transport = @{ command = $cmd; args = @($argsList) }
$link = New-CursorDeeplink -ServerName $serverKey -Config $transport $link = New-CursorDeeplink -ServerName $serverKey -Config $transport
$deeplink = "[Add to Cursor]($link)" $links += "[Add to Cursor]($link)"
} }
$table += ('| [{0}](skills/{0}/) | {1} | {2} | [README](skills/{0}/README.md) | {3} | {4} | {5} | {6} |' -f $n, $desc, $ver, $zipLink, $mcpb, $cursorZip, $deeplink) if ($table.Count -gt 0) { $table += ''; $table += '---'; $table += '' }
$table += "### [$n](skills/$n/) $dot ``v$ver``"
$table += ''
$table += '> ' + (ConvertTo-MdText $lead)
$table += ''
if ($note) {
$table += '*' + (ConvertTo-MdText $note) + '*'
$table += ''
}
$table += ($links -join " $dot ")
} }
$newLines = @() $newLines = @()
+41 -16
View File
@@ -1,6 +1,6 @@
#!/usr/bin/env bash #!/usr/bin/env bash
# Erzeugt die Skill-Tabelle in README.md zwischen <!-- skills:start --> und <!-- skills:end --> # Erzeugt die Skill-Übersicht in README.md zwischen <!-- skills:start --> und <!-- skills:end -->
# neu. Mit --check wird nur geprüft, ob die Tabelle aktuell ist (Exit-Code 1, wenn nicht). # neu. Mit --check wird nur geprüft, ob sie aktuell ist (Exit-Code 1, wenn nicht).
# Aufruf: scripts/update-index.sh [--check] # Aufruf: scripts/update-index.sh [--check]
set -euo pipefail set -euo pipefail
source "$(dirname "$0")/lib.sh" source "$(dirname "$0")/lib.sh"
@@ -18,24 +18,16 @@ fi
table="$(mktemp)" table="$(mktemp)"
trap 'rm -f "$table"' EXIT trap 'rm -f "$table"' EXIT
{ {
echo '| Skill | Kurzbeschreibung | Version | Doku | Download | Erweiterung (.mcpb) | Cursor-Plugin | Cursor 1-Klick |' first=1
echo '|---|---|---|---|---|---|---|---|'
while IFS= read -r name; do while IFS= read -r name; do
[[ -z "$name" ]] && continue [[ -z "$name" ]] && continue
desc=""
ver="$(skill_version "$SKILLS_DIR/$name")" ver="$(skill_version "$SKILLS_DIR/$name")"
desc=""
if fm="$(frontmatter "$SKILLS_DIR/$name/SKILL.md" 2>/dev/null)"; then if fm="$(frontmatter "$SKILLS_DIR/$name/SKILL.md" 2>/dev/null)"; then
desc="$(fm_value "$fm" description || true)" desc="$(fm_value "$fm" description || true)"
fi fi
desc="${desc//|/\\|}"
tag_enc="$(python3 -c 'import urllib.parse,sys; print(urllib.parse.quote(sys.argv[1], safe=""))' "$name/v$ver")"
zip_link="[${name}-v${ver}.zip](${REPO_WEB}/releases/download/${tag_enc}/${name}-v${ver}.zip)"
mcpb=""
cursor_zip=""
deeplink="" deeplink=""
if [[ -f "$SKILLS_DIR/$name/extension/manifest.json" ]]; then if [[ -f "$SKILLS_DIR/$name/extension/manifest.json" ]]; then
mcpb="[${name}-v${ver}.mcpb](${REPO_WEB}/releases/download/${tag_enc}/${name}-v${ver}.mcpb)"
cursor_zip="[${name}-cursor-v${ver}.zip](${REPO_WEB}/releases/download/${tag_enc}/${name}-cursor-v${ver}.zip)"
deeplink="$(python3 - "$SKILLS_DIR/$name/extension/manifest.json" "$name" <<'PY' deeplink="$(python3 - "$SKILLS_DIR/$name/extension/manifest.json" "$name" <<'PY'
import json, base64, sys, urllib.parse, re import json, base64, sys, urllib.parse, re
man = json.load(open(sys.argv[1], encoding="utf-8")) man = json.load(open(sys.argv[1], encoding="utf-8"))
@@ -61,13 +53,46 @@ if len(cmd) >= 3 and cmd[1] == ":" and "\\" in cmd:
cmd = cmd.replace("\\", "/") cmd = cmd.replace("\\", "/")
transport = {"command": cmd, "args": args} transport = {"command": cmd, "args": args}
b64 = base64.urlsafe_b64encode(json.dumps(transport, separators=(",", ":")).encode()).decode().rstrip("=") b64 = base64.urlsafe_b64encode(json.dumps(transport, separators=(",", ":")).encode()).decode().rstrip("=")
link = f"cursor://anysphere.cursor-deeplink/mcp/install?name={urllib.parse.quote(sk)}&config={b64}" print(f"cursor://anysphere.cursor-deeplink/mcp/install?name={urllib.parse.quote(sk)}&config={b64}")
print(f"[Add to Cursor]({link})")
PY PY
)" )"
fi fi
printf '| [%s](skills/%s/) | %s | %s | [README](skills/%s/README.md) | %s | %s | %s | %s |\n' \ if [[ $first -eq 0 ]]; then
"$name" "$name" "$desc" "$ver" "$name" "$zip_link" "$mcpb" "$cursor_zip" "$deeplink" printf '\n---\n\n'
fi
first=0
python3 -c 'import sys, urllib.parse
name, ver, desc, repo, link = sys.argv[1:]
def md(s):
out = []
trans = {"\\": "\\\\", "*": "\\*", "_": "\\_", "`": "\\`", "[": "\\["}
for ch in s:
out.append(trans.get(ch, ch))
return "".join(out)
lead, note = desc.strip(), ""
cut = lead.find(" Verwenden")
if cut > 0:
note = lead[cut + 1:].strip()
lead = lead[:cut].strip()
if lead[:1].islower():
lead = lead[0].upper() + lead[1:]
tag = urllib.parse.quote(f"{name}/v{ver}", safe="")
base = f"{repo}/releases/download/{tag}"
parts = [
f"[Doku](skills/{name}/README.md)",
f"[Skill-ZIP]({base}/{name}-v{ver}.zip \"{name}-v{ver}.zip\")",
]
if link:
parts.append(f"[Erweiterung]({base}/{name}-v{ver}.mcpb \"{name}-v{ver}.mcpb\")")
parts.append(f"[Cursor-Plugin]({base}/{name}-cursor-v{ver}.zip \"{name}-cursor-v{ver}.zip\")")
parts.append(f"[Add to Cursor]({link})")
lines = [f"### [{name}](skills/{name}/) · `v{ver}`", "", "> " + md(lead), ""]
if note:
lines += ["*" + md(note) + "*", ""]
lines.append(" · ".join(parts))
sys.stdout.write("\n".join(lines))
' "$name" "$ver" "$desc" "$REPO_WEB" "$deeplink"
printf '\n'
done < <(skill_names) done < <(skill_names)
} > "$table" } > "$table"
+7
View File
@@ -0,0 +1,7 @@
# Changelog – cadcraft-mcp
## 0.1.0 (2026-10-26)
- Erste Version: Skill und Claude-Desktop-Erweiterung für CADCraft 0.13.0 (`C:\Program Files\CADCraft\cadcraft-cli.exe`, nicht auf PATH).
- MCP kopflos mit `mcp`. `--connect HOST:PORT` optional, mit `--lazy` und `--launch`. Keine Ordner-Flags in der Hilfe.
- `new_drawing` ist ohne `metric` imperial. Laser-DXF bleibt bei VectorCraft, Volumenkörper bei SolidCraft.
+64
View File
@@ -0,0 +1,64 @@
# cadcraft-mcp
[Alle Skills](../../README.md)
## Zweck
Öffnet, zeichnet und exportiert DXF/DWG über den MCP-Server von CADCraft. CLI 0.13.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen
- **CADCraft 0.13.0** (`C:\Program Files\CADCraft\cadcraft-cli.exe`, nicht auf PATH). Publisher Learning Machines LLC. Ob die App über den ArtCraft-Launcher oder einen eigenen Installer kommt, steht so nicht in der Registry.
- 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. `cadcraft-mcp-v0.1.0.mcpb` und `cadcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/cadcraft-mcp%2Fv0.1.0/cadcraft-mcp-v0.1.0.mcpb) laden.
2. Die `.mcpb` doppelklicken. CADCraft fragt nicht nach Ordnern.
3. Unter Einstellungen → Erweiterungen prüfen, dass **CADCraft for Claude** eingeschaltet ist.
4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
5. Claude komplett beenden und neu starten. **Neuen** Chat öffnen.
## Ordner und Start
`cadcraft-cli mcp` ist kopflos. `mcp --connect HOST:PORT` (optional `--lazy`, `--launch`) hängt an eine laufende App. Die Hilfe nennt keine Lese-/Schreib-Ordner.
## Test
Neuen Chat öffnen und fragen, ob die CADCraft-Werkzeuge da sind. Präfix `…CADCraft_for_Claude…`. Ein metrisches `new_drawing` und ein `render` reichen als Probe.
## Stolpersteine
- Ein neues Dokument ohne `metric: true` ist imperial.
- 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": {
"cadcraft": {
"command": "C:\\Program Files\\CADCraft\\cadcraft-cli.exe",
"args": ["mcp"]
}
}
}
```
## Änderungen
[CHANGELOG.md](CHANGELOG.md)
+70
View File
@@ -0,0 +1,70 @@
---
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.
@@ -0,0 +1,2 @@
server/*.exe
**/*.exe
@@ -0,0 +1,177 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 ArtCraft Team and the CADCraft contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
@@ -0,0 +1,24 @@
CADCraft
Copyright (c) 2026 ArtCraft Team and the CADCraft contributors.
Licensed under the MIT License or the Apache License, Version 2.0, at your option
(LICENSE-MIT, LICENSE-APACHE).
The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team. They are
not open source and are not covered by the license above; their terms are in
docs/brand/LICENSE-brand.txt.
Third-party material
Software dependencies are listed in Cargo.lock. One is under a weak-copyleft licence: the acadrust
crate (DWG reading and writing, https://github.com/hakanaktt/acadrust) is licensed under the
Mozilla Public License 2.0 and is used unmodified as a separate library (crates/dwg). Its source
is available from crates.io and the repository above.
None: every bundled asset is original to CADCraft (icons, drafting font, hatch patterns and
linetypes are drawn or defined in code). The per-file list is in ATTRIBUTION.md. Builds made with
the optional craft-fonts input (CRAFT_FONTS_DIR) embed the fonts listed in its ATTRIBUTION.md,
each under the SIL Open Font License 1.1.
CADCraft is an independent project and is not affiliated with, sponsored by or endorsed by
Autodesk, Inc. AutoCAD and DWG are trademarks of Autodesk, Inc.
@@ -0,0 +1,81 @@
{
"manifest_version": "0.3",
"name": "cadcraft-mcp",
"display_name": "CADCraft for Claude",
"version": "0.1.0",
"description": "DXF- und DWG-Zeichnungen öffnen, zeichnen und exportieren. CLI 0.13.0. Benötigt CADCraft unter C:\\Program Files\\CADCraft\\.",
"author": {
"name": "Dominic Gundel"
},
"repository": {
"type": "git",
"url": "https://git.gundel.dev/dg/claude-skills.git"
},
"homepage": "https://git.gundel.dev/dg/claude-skills",
"license": "MIT",
"compatibility": {
"platforms": [
"win32"
]
},
"server": {
"type": "binary",
"entry_point": "server/README.txt",
"mcp_config": {
"command": "C:\\Program Files\\CADCraft\\cadcraft-cli.exe",
"args": [
"mcp"
]
}
},
"tools": [
{
"name": "command_line",
"description": "One AutoCAD-style command line. Spaces act as Enter."
},
{
"name": "script",
"description": "A multi-line script. A blank line is Enter."
},
{
"name": "execute",
"description": "Run one command by id with JSON params. No dialogs."
},
{
"name": "list_commands",
"description": "Command ids, aliases and parameter docs. Filter with filter."
},
{
"name": "inspect_drawing",
"description": "Counts, extents, layers, styles, blocks, layouts and undo."
},
{
"name": "query_entities",
"description": "Entities by type, layer, selection or window."
},
{
"name": "find_text",
"description": "TEXT, MTEXT, attributes and multileaders."
},
{
"name": "render",
"description": "PNG of the drawing, fitted to the extents or to window."
},
{
"name": "new_drawing",
"description": "New drawing. Imperial unless metric is true."
},
{
"name": "open",
"description": "Open a DXF or DWG file."
},
{
"name": "save",
"description": "Save DXF or DWG. A .svg, .png or .pdf path exports instead."
},
{
"name": "cancel",
"description": "Escape: cancel the running command or clear the selection."
}
]
}
@@ -0,0 +1,3 @@
Diese Erweiterung enthaelt keine CLI.
Erwarteter Pfad: C:\Program Files\CADCraft\cadcraft-cli.exe
Der Installer (ArtCraft-Launcher oder eigener) ist hier nicht geprueft.
@@ -0,0 +1 @@
{"version":"0.13.0","repository":"https://github.com/storytold/cadcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"cadcraft-cli.exe","path":"C:\\Program Files\\CADCraft\\cadcraft-cli.exe","tag":"v0.13.0","sha256":"d8c5c967a860e831fe2af5134c270a1fdcd45b3206183999abf13a90f46df723"}
+7
View File
@@ -0,0 +1,7 @@
# Changelog – effectcraft-mcp
## 0.1.0 (2026-10-26)
- Erste Version: Skill und Claude-Desktop-Erweiterung für EffectCraft 0.17.0 (`C:\Program Files\EffectCraft\effectcraft-cli.exe`, nicht auf PATH).
- Start: `mcp --empty` plus Lese- und Schreib-Ordner (dieser Aufruf kommt hoch). `--autosave` und `--bridge PORT` schließen sich aus. Die Hilfe lehnt Skripte ab, sobald die Ordner-Flags gesetzt sind.
- Projektdatei `.ecproj`. Exportformate der CLI genannt, nicht durch einen Render auf dieser Maschine geprüft.
+64
View File
@@ -0,0 +1,64 @@
# effectcraft-mcp
[Alle Skills](../../README.md)
## Zweck
Baut Motion-Graphics in `.ecproj` über den MCP-Server von EffectCraft und rendert Standbilder oder Filme. CLI 0.17.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen
- **EffectCraft 0.17.0** (`C:\Program Files\EffectCraft\effectcraft-cli.exe`, nicht auf PATH). Publisher Learning Machines LLC.
- Claude Desktop **oder** Cursor
- 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. `effectcraft-mcp-v0.1.0.mcpb` und `effectcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/effectcraft-mcp%2Fv0.1.0/effectcraft-mcp-v0.1.0.mcpb) laden.
2. Die `.mcpb` doppelklicken. **Lese-Ordner** `Dokumente`, **Schreib-Ordner** `Dokumente\Claude`.
3. **EffectCraft for Claude** einschalten, Skill-ZIP hochladen, Claude neu starten, neuen Chat öffnen.
## Ordner und Start
Die Erweiterung startet `mcp --empty` mit Lese- und Schreib-Ordner. Dieser Aufruf ist geprüft. `--autosave` und `--bridge PORT` schließen sich aus; die Erweiterung setzt sie nicht. Die Hilfe sagt, mit den Ordner-Flags werden Skripte abgelehnt.
## Test
Neuen Chat öffnen, eine kleine Komposition mit einem Text anlegen und `render_preview` ansehen lassen. Präfix `…EffectCraft_for_Claude…`.
## Stolpersteine
- Speichern scheitert außerhalb des Schreib-Ordners.
- 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)
```json
{
"mcpServers": {
"effectcraft": {
"command": "C:\\Program Files\\EffectCraft\\effectcraft-cli.exe",
"args": [
"mcp",
"--empty",
"--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
"--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
]
}
}
}
```
Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md). Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`.
## Änderungen
[CHANGELOG.md](CHANGELOG.md)
+78
View File
@@ -0,0 +1,78 @@
---
name: effectcraft-mcp
description: "Motion-Graphics und Compositings (.ecproj) mit dem EffectCraft-MCP-Server aufbauen, keyframen und rendern. Verwenden, wenn EffectCraft-Werkzeuge verbunden sind oder der Nutzer EffectCraft nennt; typisch für Titel, Bauchbinden, einfache Animationen, Standbilder und Filmexporte. Nicht für den Schnitt einer Timeline aus Clips (FilmCraft)."
---
# Compositing mit EffectCraft (MCP)
EffectCraft ist ein Compositor im Stil von After Effects (Rust). CLI 0.17.0. Zeiten sind Sekunden. Projektdatei `.ecproj`.
## Voraussetzung
Die Werkzeuge `list_commands`, `execute_command`, `get_project`, `set_property`, `render_preview` … müssen verbunden sein. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
Start, wie die CLI es verlangt:
- Kopflos: `effectcraft-cli mcp`, dazu `--empty`, `--demo` oder `--project F.ecproj`. `--empty` zusammen mit beiden Ordner-Flags ist geprüft (Server kommt hoch).
- `--autosave` oder `--bridge PORT`, nicht beides. `--bridge PORT` hängt an der App. Die globale Option heißt ebenfalls `--bridge PORT`.
- `--automation-read-root` und `--automation-write-root` (je mehrfach). Lesen im Lese- oder Schreib-Ordner, Schreiben nur im Schreib-Ordner. Die Hilfe sagt an dieser Stelle, Skripte werden abgelehnt. `run_script` mit gesetzten Ordnern ist nicht extra probiert.
## Werkzeuge
| Tool | Zweck |
|---|---|
| `list_commands {filter}` / `describe_command` | Befehls-IDs. Nie raten. `command_list` ist derselbe Katalog |
| `execute_command {command, params}` | ein Befehl. `command_run` nimmt stattdessen `{id, params}` |
| `batch {steps}` | mehrere Befehle, ein Undo. `"$1.layer"` meint das Feld `layer` aus Schritt 1 |
| `command_batch` | mehrere Befehle, je ein eigenes Undo |
| `get_project` / `get_comp` / `get_layer` / `get_property` | nachlesen. Pfade wie `transform/position`, `effects/#1/blurriness` |
| `set_property` / `add_keyframe` / `add_effect` | Wert, Keys, Effekt (`Gaussian Blur` oder eine ID aus `list_effects`) |
| `render_frame` / `render_preview` | PNG der Komposition |
| `open_project` / `save_project` | `.ecproj`, `demo` oder `new` |
| `undo` / `redo` / `history` | Verlauf, `history.goto` springt auch auf einen Zweig |
| `run_script {code}` | JavaScript im After-Effects-Objektmodell |
| `list_effects` / `list_fonts` / `get_state` | Kataloge und wo der Abspielkopf steht |
| `doc_inspect` | Projekt plus aktive Komposition |
| `script_ui` | Fenster, die ein Skript geöffnet hat |
## Arbeitsweise
1. **Leer starten oder die genannte `.ecproj` öffnen.** Nicht raten, welches Projekt offen ist: `get_project`.
2. **Komposition, dann Ebenen, dann Keys.** Beispiel aus der Werkzeugbeschreibung: `comp.new`, `layer.newText` oder `layer.newSolid`, `set_property` / `add_keyframe`, `effect.apply`.
3. **`render_preview` nach jedem größeren Schritt.**
4. **Speichern** als `.ecproj` unter neuem Namen. Eine Filmdatei ist ein eigener Schritt.
CLI-Export (`render`), Formate: h264, hevc, av1, prores, webm, png, jpeg, tiff, exr, gif, wav, aiff. Ein Standbild: `render-frame`. Ob jedes Format auf diesem Rechner einen Encoder hat, ist nicht geprüft.
## Fallen
- **Zwei Lauf-Werkzeuge.** `execute_command` will `command`. `command_run` will `id`. Dieselbe ID, anderes Feld.
- **`batch` rollt zurück, `command_batch` nicht als eine Gruppe.** Für einen Titel, der ganz oder gar nicht entstehen soll, `batch`.
- **Zeiten sind Sekunden**, nicht Frames, solange der Befehl nicht `frame` sagt.
- **Schrift:** `list_fonts`, dann `layer.setText`. Eine fehlende Familie nicht raten.
- **Ordner und Skripte.** Die Hilfe lehnt Skripte ab, sobald die Ordner-Flags gesetzt sind. Dann `execute_command` statt `run_script`.
## Rezept
**Titel, 1920×1080, 5 s, 30 fps:** `comp.new`, `layer.newText`, Deckkraft bei 0 s und 1 s per `add_keyframe` auf `transform/opacity`, `render_preview` bei 0 und bei 1, `save_project` unter neuem Namen. Eine MP4 nur, wenn der Nutzer eine Filmdatei will, und nur in den Schreib-Ordner.
## Abschlussprüfung
- `render_preview` zur genannten Zeit angesehen.
- `get_project`: Name, Größe, Dauer passen.
- Pfad der `.ecproj` genannt. Eine exportierte Filmdatei nur, wenn sie wirklich geschrieben wurde.
## 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.
In Titeln Beispieltext statt echter Kundennamen.
## Grenzen
- Kein Schnittplatz. Clips aneinanderhängen ist FilmCraft.
- Encoder für h264, hevc, av1 und prores sind in der Hilfe genannt, auf dieser Maschine nicht durch einen Export geprüft.
@@ -0,0 +1,2 @@
server/*.exe
**/*.exe
@@ -0,0 +1,177 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 ArtCraft Team and the EffectCraft contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
@@ -0,0 +1,22 @@
EffectCraft
Copyright (c) 2026 ArtCraft Team and the EffectCraft contributors.
Licensed under the MIT License or the Apache License, Version 2.0, at your option
(LICENSE-MIT, LICENSE-APACHE).
The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team. They are
not open source and are not covered by the license above; their terms are in
docs/brand/LICENSE-brand.txt.
Third-party material
This product bundles third-party material under its own licenses, listed below. The per-file
list (author, source, license) is in ATTRIBUTION.md.
Inter (assets/fonts/Inter-*.ttf) — SIL Open Font License 1.1. See assets/fonts/OFL-Inter.txt.
Noto Serif (assets/fonts/NotoSerif-Regular.ttf) — SIL Open Font License 1.1. See assets/fonts/OFL-NotoSerif.txt.
JetBrains Mono (assets/fonts/JetBrainsMono-Regular.ttf) — SIL Open Font License 1.1. See assets/fonts/OFL-JetBrainsMono.txt.
The optional PDF document reader uses craft-pdf and Hayro-syntax 0.7.2, MIT OR Apache-2.0.
The shared patched syntax source is centralized in storytold/craft-libs, transferred from
PdfCraft revision 9ed3abe4907a127d36b12fbfeee71d7e26248da1. This parser-only use embeds no
Hayro fonts, CMaps or image codecs; EffectCraft keeps its existing fonts and drawing filters.
@@ -0,0 +1,158 @@
{
"manifest_version": "0.3",
"name": "effectcraft-mcp",
"display_name": "EffectCraft for Claude",
"version": "0.1.0",
"description": "Motion-Graphics in .ecproj aufbauen und rendern. CLI 0.17.0. Benötigt EffectCraft unter C:\\Program Files\\EffectCraft\\.",
"author": {
"name": "Dominic Gundel"
},
"repository": {
"type": "git",
"url": "https://git.gundel.dev/dg/claude-skills.git"
},
"homepage": "https://git.gundel.dev/dg/claude-skills",
"license": "MIT",
"compatibility": {
"platforms": [
"win32"
]
},
"server": {
"type": "binary",
"entry_point": "server/README.txt",
"mcp_config": {
"command": "C:\\Program Files\\EffectCraft\\effectcraft-cli.exe",
"args": [
"mcp",
"--empty",
"--automation-read-root",
"${user_config.read_root}",
"--automation-write-root",
"${user_config.write_root}"
]
}
},
"tools": [
{
"name": "list_commands",
"description": "Engine commands. Filter with filter. command_list is the same catalog."
},
{
"name": "describe_command",
"description": "One command, including its parameter schema."
},
{
"name": "execute_command",
"description": "Run one command by the command field."
},
{
"name": "command_run",
"description": "Run one command by the id field."
},
{
"name": "batch",
"description": "Several commands as one undo step. $1.layer reads step 1."
},
{
"name": "command_batch",
"description": "Several commands, each its own undo step."
},
{
"name": "get_project",
"description": "Project overview: items, active comp, time, selection."
},
{
"name": "get_comp",
"description": "One composition and its layers."
},
{
"name": "get_layer",
"description": "A layer's property tree. Paths feed set_property."
},
{
"name": "get_property",
"description": "One property: value, keys, expression."
},
{
"name": "set_property",
"description": "Set a value or a key. expression sets an expression."
},
{
"name": "add_keyframe",
"description": "Add keys. interpolation: linear, bezier, hold, easyEase."
},
{
"name": "add_effect",
"description": "Apply an effect and optional parameter values."
},
{
"name": "list_effects",
"description": "Effect registry. Filter by id, name or category."
},
{
"name": "list_fonts",
"description": "Font families available to text layers."
},
{
"name": "get_state",
"description": "Editor state and what this build can do."
},
{
"name": "render_frame",
"description": "PNG of a comp frame."
},
{
"name": "render_preview",
"description": "PNG of a comp frame, for checking the work."
},
{
"name": "open_project",
"description": "Open an .ecproj, the demo, or a new empty project."
},
{
"name": "save_project",
"description": "Save the .ecproj, or Save As when path is set."
},
{
"name": "undo",
"description": "Undo the last edits."
},
{
"name": "redo",
"description": "Redo undone edits."
},
{
"name": "history",
"description": "Branching undo history. goto jumps to a state."
},
{
"name": "run_script",
"description": "After-Effects-style JavaScript. Refused when folder roots are set (CLI help)."
},
{
"name": "script_ui",
"description": "Drive ScriptUI windows a script opened."
},
{
"name": "doc_inspect",
"description": "Project overview and the active composition."
}
],
"user_config": {
"read_root": {
"type": "directory",
"title": "Lese-Ordner",
"description": "Hier darf der Agent Dateien lesen. Weit fassen (z. B. Dokumente).",
"required": true,
"default": "${HOME}/Documents"
},
"write_root": {
"type": "directory",
"title": "Schreib-Ordner",
"description": "Nur hier darf der Agent speichern. Eng fassen, z. B. Dokumente\\Claude.",
"required": true,
"default": "${HOME}/Documents/Claude"
}
}
}
@@ -0,0 +1,3 @@
Diese Erweiterung enthaelt keine CLI.
Erwarteter Pfad: C:\Program Files\EffectCraft\effectcraft-cli.exe
Der Installer (ArtCraft-Launcher oder eigener) ist hier nicht geprueft.
@@ -0,0 +1 @@
{"version":"0.17.0","repository":"https://github.com/storytold/effectcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"effectcraft-cli.exe","path":"C:\\Program Files\\EffectCraft\\effectcraft-cli.exe","tag":"v0.17.0","sha256":"c7fde6fda4d6fd133d1db7a7a03a402a57d758fa8780c4949c058bf07a7d8702"}
+5
View File
@@ -1,5 +1,10 @@
# Changelog – figcraft-mcp # Changelog – figcraft-mcp
## 0.2.0 (2026-10-26)
- CLI 0.11.2. PDF-Export mit Beschnitt, Schnittmarken und CMYK (`file.export`). CLI `convert` und `plugin publish`.
- `mcp --attach PORT` hängt an der App und lehnt die Ordner-Flags ab. Mit Ordnern bleibt der Server kopflos.
## 0.1.0 (2026-10-19) ## 0.1.0 (2026-10-19)
- Erste Version: Skill und Claude-Desktop-Erweiterung für FigCraft 0.7.0 aus dem ArtCraft-Launcher (`C:\Program Files\FigCraft\figcraft-cli.exe`, nicht auf PATH). - Erste Version: Skill und Claude-Desktop-Erweiterung für FigCraft 0.7.0 aus dem ArtCraft-Launcher (`C:\Program Files\FigCraft\figcraft-cli.exe`, nicht auf PATH).
+4 -4
View File
@@ -4,7 +4,7 @@
## Zweck ## Zweck
Entwirft Bedienoberflächen (HMI-Masken, App-Screens) über den MCP-Server von FigCraft und exportiert sie als PNG, PDF oder SVG. Frühe Alpha, getestet mit 0.7.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). Entwirft Bedienoberflächen (HMI-Masken, App-Screens) über den MCP-Server von FigCraft und exportiert sie als PNG, PDF oder SVG, PDF auch mit Beschnitt und CMYK. Frühe Alpha, CLI 0.11.2. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen ## Voraussetzungen
@@ -18,7 +18,7 @@ Entwirft Bedienoberflächen (HMI-Masken, App-Screens) über den MCP-Server von F
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `figcraft-mcp-v0.1.0.mcpb` und `figcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.1.0/figcraft-mcp-v0.1.0.mcpb) laden. 1. `figcraft-mcp-v0.2.0.mcpb` und `figcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/figcraft-mcp%2Fv0.2.0/figcraft-mcp-v0.2.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. **Lese-Ordner:** `Dokumente`. **Schreib-Ordner:** `Dokumente\Claude`. Bei FigCraft ist es unerheblich, ob der Schreib-Ordner im Lese-Ordner liegt; der Standard bleibt derselbe wie bei PdfCraft und VectorCraft. 3. **Lese-Ordner:** `Dokumente`. **Schreib-Ordner:** `Dokumente\Claude`. Bei FigCraft ist es unerheblich, ob der Schreib-Ordner im Lese-Ordner liegt; der Standard bleibt derselbe wie bei PdfCraft und VectorCraft.
4. Unter Einstellungen → Erweiterungen prüfen, dass **FigCraft for Claude** eingeschaltet ist. 4. Unter Einstellungen → Erweiterungen prüfen, dass **FigCraft for Claude** eingeschaltet ist.
@@ -29,7 +29,7 @@ Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
## Ordner und Start ## Ordner und Start
Der Server bekommt Lese- und Schreib-Ordner und läuft ohne Fenster. **Kein `--attach`:** mit Ordnergrenzen ist die Anbindung an eine laufende App nicht erlaubt. Der Server der Erweiterung bekommt Lese- und Schreib-Ordner und läuft ohne Fenster. `mcp --attach PORT` gibt es und hängt an `figcraft --control PORT`, lehnt die Ordner-Flags aber ab. Die Erweiterung setzt `--attach` deshalb nicht.
## Freigaben ## Freigaben
@@ -76,7 +76,7 @@ Statt der Erweiterung in `claude_desktop_config.json` eintragen. Stolpersteine:
} }
``` ```
`--attach` nicht setzen. `--attach` nicht zusammen mit den Ordner-Flags setzen; die CLI lehnt das ab.
## Änderungen ## Änderungen
+3 -3
View File
@@ -5,13 +5,13 @@ description: Bedienoberflächen und Screens über den FigCraft-MCP-Server entwer
# Oberflächen mit FigCraft (MCP) # Oberflächen mit FigCraft (MCP)
FigCraft ist ein Open-Source-Designwerkzeug (Rust), das Figma-Parität anstrebt. Es ist noch eine frühe Alpha. Getestet mit Version 0.7.0. FigCraft ist ein Open-Source-Designwerkzeug (Rust), das Figma-Parität anstrebt. Es ist noch eine frühe Alpha. CLI 0.11.2. Die Export-Falle (ohne `ids`) ist am 0.7.0 bestätigt und an 0.11.2 nicht erneut durchgespielt.
## Voraussetzung ## Voraussetzung
Die Werkzeuge `create_node`, `set_properties`, `batch`, `screenshot`, `export` … müssen verbunden sein. Ihr Präfix hängt vom Client und vom Namen der Erweiterung bzw. des Servers ab (z. B. `mcp__…__FigCraft_for_Claude__create_node`). 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). Die Werkzeuge `create_node`, `set_properties`, `batch`, `screenshot`, `export` … müssen verbunden sein. Ihr Präfix hängt vom Client und vom Namen der Erweiterung bzw. des Servers ab (z. B. `mcp__…__FigCraft_for_Claude__create_node`). 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).
Der Server arbeitet ohne Fenster (headless). Lesen darf er im Lese- und Schreib-Ordner, schreiben nur im Schreib-Ordner. Die erlaubten Ordner stehen in den Server-Anweisungen beim Start. Der Server mit Lese- und Schreib-Ordner arbeitet ohne Fenster. `mcp --attach PORT` hängt an einer laufenden App (`figcraft --control PORT`) und lehnt die Ordner-Flags ab. Lesen darf er im Lese- und Schreib-Ordner, schreiben nur im Schreib-Ordner.
## Werkzeuge ## Werkzeuge
@@ -56,7 +56,7 @@ Der Server arbeitet ohne Fenster (headless). Lesen darf er im Lese- und Schreib-
Farben nach der gängigen Bedeutung: Rot für Halt/Störung, Gelb für Warnung, Grün für Betrieb. Farben nach der gängigen Bedeutung: Rot für Halt/Störung, Gelb für Warnung, Grün für Betrieb.
2. **Komponenten:** Taste fertig gestalten → `run_command {command: "component.create", params: {ids: [id]}}` → Kopien über `instance.create {component, x, y, parent}`. 2. **Komponenten:** Taste fertig gestalten → `run_command {command: "component.create", params: {ids: [id]}}` → Kopien über `instance.create {component, x, y, parent}`.
3. **Weitergabe:** `export {ids: [rahmen], format: "pdf", path}` für Doku/Kunde, `format: "png", scale: 2` für Präsentationen, `svg` für Web. 3. **Weitergabe:** `export` bzw. `file.export` mit `ids` des Hauptrahmens. PDF-Druck (CLI und `file.export`, 0.11.2): `bleed` (`"3mm"`, `"0.125in"`, `"9pt"` oder Punkt), `cropMarks`, `bleedMarks`, `cmyk`. `format: "png", scale: 2` für Präsentationen, `svg` für Web. Die CLI hat zusätzlich `convert <in> <out>` und `plugin publish`.
## Abschlussprüfung ## Abschlussprüfung
+2 -2
View File
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "figcraft-mcp", "name": "figcraft-mcp",
"display_name": "FigCraft for Claude", "display_name": "FigCraft for Claude",
"version": "0.1.0", "version": "0.2.0",
"description": "Bedienoberflächen und Screens (z. B. HMI-Masken) entwerfen und als PNG/PDF/SVG exportieren. Frühe Alpha, getestet mit FigCraft 0.7.0. Benötigt FigCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\FigCraft\\.", "description": "Bedienoberflächen und Screens (z. B. HMI-Masken) entwerfen und als PNG/PDF/SVG exportieren, PDF mit Beschnitt und CMYK. CLI 0.11.2. Benötigt FigCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\FigCraft\\.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
+1 -1
View File
@@ -1 +1 @@
{"version":"0.7.0","repository":"https://github.com/storytold/figcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"figcraft-cli.exe","path":"C:\\Program Files\\FigCraft\\figcraft-cli.exe","tag":"v0.7.0","sha256":"34c2ca22281d1176d6750be15acd8c1b9d1626128fa44c76356144a3866df69a"} {"version":"0.11.2","repository":"https://github.com/storytold/figcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"figcraft-cli.exe","path":"C:\\Program Files\\FigCraft\\figcraft-cli.exe","tag":"v0.11.2","sha256":"ba212a8c476f38640d9b5d3742ce3c7cb4177a420f23958b538d6ae0b8f039e6"}
+7
View File
@@ -0,0 +1,7 @@
# Changelog – filmcraft-mcp
## 0.1.0 (2026-10-26)
- Erste Version: Skill und Claude-Desktop-Erweiterung für FilmCraft 0.13.0 (`C:\Program Files\FilmCraft\filmcraft-cli.exe`, nicht auf PATH).
- `mcp` kopflos. `--bridge 127.0.0.1:PORT` steht vor dem Unterbefehl und spricht `filmcraft --control PORT` an. Keine Ordner-Flags in der Hilfe.
- Zeitbasis 254016000000 Ticks pro Sekunde. `command_run` nimmt `id`. Die `ui_*`-Werkzeuge nur an der App.
+59
View File
@@ -0,0 +1,59 @@
# filmcraft-mcp
[Alle Skills](../../README.md)
## Zweck
Schneidet `.fcproj`-Projekte über den MCP-Server von FilmCraft und exportiert die Sequenz. CLI 0.13.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen
- **FilmCraft 0.13.0** (`C:\Program Files\FilmCraft\filmcraft-cli.exe`, nicht auf PATH). Publisher Learning Machines LLC.
- Claude Desktop **oder** Cursor
- 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. `filmcraft-mcp-v0.1.0.mcpb` und `filmcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/filmcraft-mcp%2Fv0.1.0/filmcraft-mcp-v0.1.0.mcpb) laden.
2. Die `.mcpb` doppelklicken. FilmCraft fragt nicht nach Ordnern.
3. **FilmCraft for Claude** einschalten, Skill-ZIP hochladen, Claude neu starten, neuen Chat öffnen.
## Ordner und Start
`filmcraft-cli mcp` ist kopflos und hat keine Ordner-Flags. An die App: `filmcraft-cli --bridge 127.0.0.1:PORT mcp`, die App mit `filmcraft --control PORT`. Die Erweiterung setzt `--bridge` nicht.
## Test
Neuen Chat öffnen und fragen, ob die FilmCraft-Werkzeuge da sind. Präfix `…FilmCraft_for_Claude…`. Ohne genanntes Projekt nichts importieren.
## Stolpersteine
- Es gibt keine Ordnersperre. In Claude bei Import und Export auf **„Immer fragen“** lassen.
- 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)
```json
{
"mcpServers": {
"filmcraft": {
"command": "C:\\Program Files\\FilmCraft\\filmcraft-cli.exe",
"args": ["mcp"]
}
}
}
```
Stolpersteine: [MCP unter Windows einrichten](../../docs/windows-mcp-einrichtung.md). Store-App: `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`.
## Änderungen
[CHANGELOG.md](CHANGELOG.md)
+66
View File
@@ -0,0 +1,66 @@
---
name: filmcraft-mcp
description: "Schnitte (.fcproj) mit dem FilmCraft-MCP-Server importieren, schneiden und exportieren. Verwenden, wenn FilmCraft-Werkzeuge verbunden sind oder der Nutzer FilmCraft nennt; typisch für Rohschnitt, Titel auf der Timeline, Export nach h264, ProRes, DNxHR oder als Bildsequenz. Nicht für Compositing und Keyframes (EffectCraft)."
---
# Schnitt mit FilmCraft (MCP)
FilmCraft ist ein Schnittprogramm (Rust), angelegt an Premiere Pro. CLI 0.13.0. Projektdatei `.fcproj`. Die Zeitbasis ist 254016000000 Ticks pro Sekunde. Die meisten Befehle nehmen auch `seconds`, `frame` oder `timecode`.
## Voraussetzung
Die Werkzeuge `command_list`, `command_run`, `doc_inspect`, `media_import`, `render_preview` … müssen verbunden sein. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
`filmcraft-cli mcp` ist kopflos. Die App steuert `--bridge 127.0.0.1:PORT` vor dem Unterbefehl (`filmcraft --control PORT`). Die `ui_*`-Werkzeuge gelten nur an der laufenden App. Die Hilfe nennt keine Lese-/Schreib-Ordner. `--project`, `--demo`, `--save` und `--save-as` sind globale Optionen.
## Werkzeuge
| Tool | Zweck |
|---|---|
| `command_list {filter}` | IDs, Menü, Parameter. Immer mit Filter |
| `command_run {id, params}` | ein Befehl. Feld heißt `id`, nicht `command` |
| `command_batch {steps}` | mehrere Befehle, Stopp beim ersten Fehler |
| `doc_inspect` | Projektbaum und aktive Sequenz |
| `project_inspect` / `sequence_inspect` | nur der Baum, nur die Sequenz |
| `media_import {paths}` | Medien per absolutem Pfad. `image_sequence` für nummerierte Bilder |
| `render_frame` / `render_preview` | PNG der aktiven Sequenz |
| `ui_elements`, `ui_click`, `ui_drag`, `ui_key`, `ui_type`, `ui_screenshot`, `ui_inspect`, `ui_control` | nur mit `--bridge` |
## Arbeitsweise
1. **Projekt nennen.** Kopflos ohne `--project` ist kein Kundenprojekt offen. `doc_inspect`, bevor etwas geschnitten wird.
2. **Befehle nie raten.** `command_list {filter: "razor"}` und dann `command_run`. Die CLI-Hilfe nennt als Beispiele `timeline.razor`, `sequence.addEdit`, `timeline.trim`, `effects.apply`, `file.import`, `file.newBin`. Ob jede dieser IDs in 0.13.0 noch so heißt, vor dem Aufruf mit `command_list` prüfen, nicht aus dieser Liste abschreiben.
3. **Ansehen:** `render_preview {seconds}`.
4. **Export** über den Befehl, den `command_list` für den Export nennt, oder die CLI `export`. Formate der CLI: h264, hevc, prores, dnxhr, apv, mjpeg, mxf-op1a, mxf-opatom, png, tiff, bmp, gif, wav, aiff, aac. Offline-Medien machen den Export zum Fehler, solange `--allow-offline` fehlt.
## Fallen
- **`command_run` nimmt `id`.** `{command: "…"}` ist das falsche Feld.
- **Ticks sind nicht Sekunden.** Für eine Zeitangabe `seconds` bevorzugen, wenn der Befehl das Feld hat. 254016000000 Ticks = 1 s.
- **`ui_*` ohne App tut nichts Nützliches.** Kopflos `command_run` und `render_preview`.
- **Fehlende Medien.** Die CLI warnt und endet mit Code 1, wenn ein Export Platzhalter zeichnet. Dem Nutzer die fehlende Datei nennen, nicht mit `--allow-offline` still weitermachen, solange er das nicht verlangt.
## Rezept
**Rohschnitt:** Projekt öffnen (`--project` oder der Import-Befehl aus `command_list`), `media_import` mit den Pfaden vom Nutzer, Clips in die Sequenz nur mit IDs aus `sequence_inspect`, an der Stelle schneiden, die `command_list` hergibt, `render_preview` an zwei Zeitpunkten, speichern unter neuem Namen (`.fcproj`). Eine Exportdatei nur auf Wunsch und nie über das Original.
## Abschlussprüfung
- `sequence_inspect`: die genannten Clips liegen in der richtigen Reihenfolge.
- Zwei Frames mit `render_preview` angesehen.
- Pfad von Projekt und, falls exportiert, der Mediendatei genannt.
## Datenschutz
Ampel:
- Grün: allgemeine und technische Inhalte ohne Kundenbezug.
- Gelb: Projekt- und Geschäftsinfos, nur nach Abwägung oder anonymisiert.
- Rot: personenbezogene Daten, Aufnahmen von Personen und NDA-Inhalte gehören nicht in die Cloud-KI.
`render_preview` schickt ein Bild ans Modell. Bei rot markiertem Material nicht rendern, sondern nur schneiden, wenn der Nutzer die Zeiten vorgibt, oder ihn selbst sichten lassen.
## Grenzen
- Kein Compositor. Titel mit Keyframes und Effekten auf Ebenen sind EffectCraft; ein Effekt auf einem Clip nur, wenn `command_list` ihn in FilmCraft führt.
- Encoder sind in der Hilfe genannt, auf dieser Maschine nicht durch einen Export geprüft.
@@ -0,0 +1,2 @@
server/*.exe
**/*.exe
@@ -0,0 +1,177 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 ArtCraft Team and the FilmCraft contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
@@ -0,0 +1,21 @@
FilmCraft
Copyright (c) 2026 ArtCraft Team and the FilmCraft contributors.
Licensed under the MIT License or the Apache License, Version 2.0, at your option
(LICENSE-MIT, LICENSE-APACHE).
The ArtCraft name, wordmark and logos in docs/brand/ are trademarks of the ArtCraft Team. They are
not open source and are not covered by the license above; their terms are in
docs/brand/LICENSE-brand.txt.
Third-party material
This product bundles third-party material under its own licenses, listed below. The per-file
list (author, source, license) is in ATTRIBUTION.md.
Inter font (assets/fonts/Inter-*.ttf) — OFL-1.1. See assets/fonts/OFL-Inter.txt.
Noto Serif font (assets/fonts/NotoSerif-Regular.ttf) — OFL-1.1. See assets/fonts/OFL-NotoSerif.txt.
JetBrains Mono font (assets/fonts/JetBrainsMono-Regular.ttf) — OFL-1.1. See assets/fonts/OFL-JetBrainsMono.txt.
Builds made with craft-fonts (CRAFT_FONTS_DIR; all official releases) also embed the fonts listed in
https://github.com/storytold/craft-fonts/blob/main/ATTRIBUTION.md (BIZ UDPGothic, Shippori Mincho,
BIZ UDMincho, Noto Sans CJK SC, Noto Sans Arabic, Noto Sans Thai, Noto Sans Georgian) — OFL-1.1. Their licence texts ship with the packages as OFL-<family>.txt.
Public-domain film and NASA frames and CC0 music shown in README screenshots (docs/images/) — public domain / CC0-1.0. See ATTRIBUTION.md.
@@ -0,0 +1,101 @@
{
"manifest_version": "0.3",
"name": "filmcraft-mcp",
"display_name": "FilmCraft for Claude",
"version": "0.1.0",
"description": "Schnitte in .fcproj importieren, schneiden und exportieren. CLI 0.13.0. Benötigt FilmCraft unter C:\\Program Files\\FilmCraft\\.",
"author": {
"name": "Dominic Gundel"
},
"repository": {
"type": "git",
"url": "https://git.gundel.dev/dg/claude-skills.git"
},
"homepage": "https://git.gundel.dev/dg/claude-skills",
"license": "MIT",
"compatibility": {
"platforms": [
"win32"
]
},
"server": {
"type": "binary",
"entry_point": "server/README.txt",
"mcp_config": {
"command": "C:\\Program Files\\FilmCraft\\filmcraft-cli.exe",
"args": [
"mcp"
]
}
},
"tools": [
{
"name": "command_list",
"description": "Command ids, labels and parameter docs. Filter with filter."
},
{
"name": "command_run",
"description": "Run one command by id with params."
},
{
"name": "command_batch",
"description": "Run several commands. Stops at the first error by default."
},
{
"name": "doc_inspect",
"description": "Project tree plus the active sequence."
},
{
"name": "project_inspect",
"description": "Bins and items."
},
{
"name": "sequence_inspect",
"description": "Active sequence: tracks, clips, markers, playhead. 254016000000 ticks = 1 second."
},
{
"name": "media_import",
"description": "Import media by absolute path."
},
{
"name": "render_frame",
"description": "PNG of a sequence frame."
},
{
"name": "render_preview",
"description": "PNG of a sequence frame. Bridge mode: Program monitor."
},
{
"name": "ui_elements",
"description": "Live app only: clickable element ids."
},
{
"name": "ui_click",
"description": "Live app only: click an element or a point."
},
{
"name": "ui_drag",
"description": "Live app only: drag from one point or element to another."
},
{
"name": "ui_key",
"description": "Live app only: press a key or shortcut."
},
{
"name": "ui_type",
"description": "Live app only: type into the focused field."
},
{
"name": "ui_screenshot",
"description": "Live app only: screenshot of the window or one panel."
},
{
"name": "ui_inspect",
"description": "Live app only: tool, workspace, panels, playback."
},
{
"name": "ui_control",
"description": "Live app only: call a control-channel method."
}
]
}
@@ -0,0 +1,3 @@
Diese Erweiterung enthaelt keine CLI.
Erwarteter Pfad: C:\Program Files\FilmCraft\filmcraft-cli.exe
Der Installer (ArtCraft-Launcher oder eigener) ist hier nicht geprueft.
@@ -0,0 +1 @@
{"version":"0.13.0","repository":"https://github.com/storytold/filmcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"filmcraft-cli.exe","path":"C:\\Program Files\\FilmCraft\\filmcraft-cli.exe","tag":"v0.13.0","sha256":"ed5c7e7f4df343a90f745867a6d4f6aea1ebd15c34b72bad0e94dc6ff3cee189"}
+5
View File
@@ -1,5 +1,10 @@
# Changelog – gridcraft-mcp # Changelog – gridcraft-mcp
## 0.4.0 (2026-10-26)
- CLI 0.12.1. `open_workbook` öffnet .xlsm, .xls, .xlsb und .ods. Werkzeug `select`. Pivot: `insert.pivotTable`, `insert.pivotChart`, `pivot.*`.
- CLI-Befehle info, convert, eval, cat, check, run, commands, functions, mcp --connect PORT, send, version. Die Fallen von 0.8.0 sind nicht erneut durchgespielt.
## 0.3.0 (2026-10-19) ## 0.3.0 (2026-10-19)
- Skill clientneutral: Claude-/Cursor-Details nur noch in README/docs; schärfere `description`. - Skill clientneutral: Claude-/Cursor-Details nur noch in README/docs; schärfere `description`.
+3 -3
View File
@@ -4,7 +4,7 @@
## Zweck ## Zweck
Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Server von GridCraft. Getestet mit 0.8.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.xlsm`, `.xls`, `.xlsb`, `.ods`, `.csv`) über den MCP-Server von GridCraft, einschließlich Pivot. CLI 0.12.1. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen ## Voraussetzungen
@@ -20,13 +20,13 @@ Erstellt und bearbeitet Excel-Arbeitsmappen (`.xlsx`, `.csv`) über den MCP-Serv
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `gridcraft-mcp-v0.3.0.mcpb` und `gridcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.3.0/gridcraft-mcp-v0.3.0.mcpb) laden. 1. `gridcraft-mcp-v0.4.0.mcpb` und `gridcraft-mcp-v0.4.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/gridcraft-mcp%2Fv0.4.0/gridcraft-mcp-v0.4.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. Unter Einstellungen → Erweiterungen prüfen, dass **GridCraft for Claude** eingeschaltet ist. 3. Unter Einstellungen → Erweiterungen prüfen, dass **GridCraft for Claude** eingeschaltet ist.
4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**. 4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
5. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen. 5. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.
Wer v0.1.0 oder v0.2.0 installiert hat: alte Erweiterung entfernen, v0.3.0 installieren, einschalten, Skill-ZIP v0.3.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen. Wer v0.1.0, v0.2.0 oder v0.3.0 installiert hat: alte Erweiterung entfernen, v0.4.0 installieren, einschalten, Skill-ZIP v0.4.0 hochladen.
**Umsteigen von der manuellen Config:** Eintrag `gridcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen. **Umsteigen von der manuellen Config:** Eintrag `gridcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen.
+17 -4
View File
@@ -1,11 +1,11 @@
--- ---
name: gridcraft-mcp name: gridcraft-mcp
description: "Excel-Arbeitsmappen (.xlsx, .csv) mit dem GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen und prüfen. Verwenden, wenn GridCraft-Werkzeuge verbunden sind oder der Nutzer GridCraft nennt; typisch für Kalkulationen, Stücklisten (BOM), Listen, Diagramme, PDF-Export. Nicht für eingebaute xlsx-Hilfen ohne GridCraft-Server." description: "Excel-Arbeitsmappen (.xlsx, .xlsm, .xls, .xlsb, .ods, .csv) mit dem GridCraft-MCP-Server erstellen, öffnen, ändern, berechnen und prüfen, einschließlich Pivot-Tabellen. Verwenden, wenn GridCraft-Werkzeuge verbunden sind oder der Nutzer GridCraft nennt; typisch für Kalkulationen, Stücklisten (BOM), Listen, Diagramme, Pivot, PDF-Export. Nicht für eingebaute xlsx-Hilfen ohne GridCraft-Server."
--- ---
# Tabellen mit GridCraft (MCP) # Tabellen mit GridCraft (MCP)
GridCraft ist eine Open-Source-Tabellenkalkulation (Rust), die Excel-Parität anstrebt. Alles ist ein Befehl mit stabiler ID nach dem Excel-Ribbon (`home.bold`, `insert.chart`, `data.sort` …); Ribbon, CLI und MCP rufen dieselben Befehle auf. Getestet mit Version 0.8.0. GridCraft ist eine Open-Source-Tabellenkalkulation (Rust), die Excel-Parität anstrebt. Alles ist ein Befehl mit stabiler ID nach dem Excel-Ribbon (`home.bold`, `insert.chart`, `data.sort` …); Ribbon, CLI und MCP rufen dieselben Befehle auf. CLI 0.12.1. Die Fallen weiter unten sind am 0.8.0 bestätigt und an 0.12.1 nicht erneut durchgespielt.
## Voraussetzung ## Voraussetzung
@@ -27,11 +27,12 @@ Die Werkzeuge `write_range`, `read_range`, `execute_command` … müssen verbund
| `write_range` | `{range, values}` – 2-D-Array; Strings mit `=` sind Formeln | | `write_range` | `{range, values}` – 2-D-Array; Strings mit `=` sind Formeln |
| `set_cell` / `get_cell` | eine Zelle schreiben/lesen (Wert, Formel, Text, Stil) | | `set_cell` / `get_cell` | eine Zelle schreiben/lesen (Wert, Formel, Text, Stil) |
| `evaluate_formula` | Formel testen, ohne das Blatt zu ändern | | `evaluate_formula` | Formel testen, ohne das Blatt zu ändern |
| `select` | Auswahl setzen (`range`, `active?`); Befehle ohne `range` wirken darauf |
| `format_range` | `bold, italic, underline, fontName, fontSize, fontColor, fillColor, numberFormat, horizontalAlign, wrapText, borders` | | `format_range` | `bold, italic, underline, fontName, fontSize, fontColor, fillColor, numberFormat, horizontalAlign, wrapText, borders` |
| `create_table` | `{range, name?, header?, style?}` | | `create_table` | `{range, name?, header?, style?}` |
| `insert_chart` | `{range, type, title?, subtype?, at?}` | | `insert_chart` | `{range, type, title?, subtype?, at?}` |
| `sort_range` / `filter` | Sortieren / AutoFilter | | `sort_range` / `filter` | Sortieren / AutoFilter |
| `new_workbook` / `open_workbook` / `save_workbook` | Dateien (.xlsx, .csv, .tsv, .json, .html) | | `new_workbook` / `open_workbook` / `save_workbook` | öffnen: .xlsx, .xlsm, .xls, .xlsb, .ods, .csv, .tsv, .txt, .json; speichern: .xlsx, .csv, .tsv, .json, .html |
| `undo` / `redo` | Verlauf | | `undo` / `redo` | Verlauf |
| `list_functions` | verfügbare Tabellenfunktionen | | `list_functions` | verfügbare Tabellenfunktionen |
| `screenshot` | nur mit verbundener Desktop-App | | `screenshot` | nur mit verbundener Desktop-App |
@@ -65,8 +66,19 @@ Bereiche mit Blatt: `"Kalkulation!A3:E8"`.
Vor dem Massenbefüllen Formel mit `evaluate_formula` testen. Vor dem Massenbefüllen Formel mit `evaluate_formula` testen.
## Pivot (0.12.1)
`list_commands {search: "pivot"}` vor dem ersten Aufruf. Belegte IDs, Auszug:
- `insert.pivotTable` — `source` (Bereich oder Tabellenname), `destination` (`"new"` = neues Blatt, Bericht bei A3, oder `"Sheet1!H3"`), `rows`, `columns`, `values` (`{field, func?, name?}`), `filters`
- `insert.pivotChart` — Diagramm an die Pivot-Tabelle gebunden (`pivot`, `type`, `at`)
- `pivot.addField` / `pivot.removeField` / `pivot.moveField` — `area`: `rows`, `columns`, `values`, `filters`
- `pivot.refresh`, `pivot.layout` (`compact|outline|tabular`), `pivot.filter`, `pivot.sort`, `pivot.valueSettings`
## open_workbook und alreadyOpen ## open_workbook und alreadyOpen
`.xls` bringt Werte, Formeln und Zahlenformate. `.xlsb` und `.ods` bringen Blattdaten und zwischengespeicherte Formelwerte; die Warnungen der Antwort lesen.
`open_workbook` auf eine bereits offene Datei liefert nur `{"alreadyOpen": true}` und lädt **nicht** neu – für die Kontrolle der gespeicherten Datei ungeeignet. Andere Mappe aktivieren/schließen oder Datei extern prüfen. `open_workbook` auf eine bereits offene Datei liefert nur `{"alreadyOpen": true}` und lädt **nicht** neu – für die Kontrolle der gespeicherten Datei ungeeignet. Andere Mappe aktivieren/schließen oder Datei extern prüfen.
## Parameter-Beispiele (im Test bestätigt) ## Parameter-Beispiele (im Test bestätigt)
@@ -145,4 +157,5 @@ Vorlage öffnen → Zeilen ab Startzeile mit `write_range` schreiben → bei Bed
- Keine Netzwerkfunktionen (`WEBSERVICE` liefert `#VALUE!`), keine Makros/VBA. - Keine Netzwerkfunktionen (`WEBSERVICE` liefert `#VALUE!`), keine Makros/VBA.
- Funktionsumfang mit `list_functions` prüfen. - Funktionsumfang mit `list_functions` prüfen.
- Mit verbundener Desktop-App entfällt jede Ordnerbeschränkung ebenfalls. - Mit verbundener Desktop-App (`mcp --connect PORT`, die Screenshot-Hilfe nennt 7979) entfällt jede Ordnersperre ebenfalls. Die CLI kennt keine Lese-/Schreib-Ordner.
- CLI neben MCP: `info`, `convert`, `eval`, `cat`, `check`, `run`, `commands`, `functions`, `send`, `version`.
+2 -2
View File
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "gridcraft-mcp", "name": "gridcraft-mcp",
"display_name": "GridCraft for Claude", "display_name": "GridCraft for Claude",
"version": "0.3.0", "version": "0.4.0",
"description": "Excel-Arbeitsmappen (.xlsx, .csv) erstellen und bearbeiten. Getestet mit GridCraft 0.8.0. Benötigt GridCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\GridCraft\\. Ohne Ordnersperre – GridCraft kann alle Dateien lesen und schreiben, auf die der Benutzer Zugriff hat.", "description": "Excel-Arbeitsmappen erstellen und bearbeiten, einschließlich Pivot. CLI 0.12.1. Benötigt GridCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\GridCraft\\. Ohne Ordnersperre – GridCraft kann alle Dateien lesen und schreiben, auf die der Benutzer Zugriff hat.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
+1 -1
View File
@@ -1 +1 @@
{"version":"0.8.0","repository":"https://github.com/storytold/gridcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"gridcraft-cli.exe","path":"C:\\Program Files\\GridCraft\\gridcraft-cli.exe","tag":"v0.8.0","sha256":"2eafa6b8d08357fb44610e030ebe54491b5abc1329da3d748878228a868d779a"} {"version":"0.12.1","repository":"https://github.com/storytold/gridcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"gridcraft-cli.exe","path":"C:\\Program Files\\GridCraft\\gridcraft-cli.exe","tag":"v0.12.1","sha256":"4e20b4ab006f6923cc3c5480df27eebd2a01456aa73c07c24681e70acc6e7d96"}
+5
View File
@@ -1,5 +1,10 @@
# Changelog – pdfcraft-mcp # Changelog – pdfcraft-mcp
## 0.2.0 (2026-10-26)
- CLI 0.14.0. Zusätzlich `batch` (convert, ocr, optimize), `audit` und `tools`. `--compact` und die Ordner-Flags bleiben.
- `ocr_status` auf diesem Rechner: verfügbar, Sprache nur Englisch, Modelle unter `C:\Program Files\PdfCraft\models`.
## 0.1.0 (2026-10-19) ## 0.1.0 (2026-10-19)
- Erste Version: Skill und Claude-Desktop-Erweiterung für PdfCraft 0.9.0 aus dem ArtCraft-Launcher (`C:\Program Files\PdfCraft\pdfcraft-cli.exe`, nicht auf PATH). - Erste Version: Skill und Claude-Desktop-Erweiterung für PdfCraft 0.9.0 aus dem ArtCraft-Launcher (`C:\Program Files\PdfCraft\pdfcraft-cli.exe`, nicht auf PATH).
+2 -2
View File
@@ -4,7 +4,7 @@
## Zweck ## Zweck
Öffnet, liest, schwärzt, bereinigt und bündelt PDFs über den MCP-Server von PdfCraft. Getestet mit 0.9.0 (Schwärzen, Doku-Pakete). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). Öffnet, liest, schwärzt, bereinigt und bündelt PDFs über den MCP-Server von PdfCraft. CLI 0.14.0 (Schwärzen und Doku-Pakete am 0.9.0 geprüft). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen ## Voraussetzungen
@@ -18,7 +18,7 @@
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `pdfcraft-mcp-v0.1.0.mcpb` und `pdfcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.1.0/pdfcraft-mcp-v0.1.0.mcpb) laden. 1. `pdfcraft-mcp-v0.2.0.mcpb` und `pdfcraft-mcp-v0.2.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/pdfcraft-mcp%2Fv0.2.0/pdfcraft-mcp-v0.2.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. **Lese-Ordner weit:** `Dokumente` (`${HOME}/Documents`). **Schreib-Ordner eng und darin:** `Dokumente\Claude`. PdfCraft lehnt es ab, eine selbst geschriebene Datei wieder zu öffnen, wenn der Schreib-Ordner außerhalb des Lese-Ordners liegt. 3. **Lese-Ordner weit:** `Dokumente` (`${HOME}/Documents`). **Schreib-Ordner eng und darin:** `Dokumente\Claude`. PdfCraft 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 **PdfCraft for Claude** eingeschaltet ist. 4. Unter Einstellungen → Erweiterungen prüfen, dass **PdfCraft for Claude** eingeschaltet ist.
+3 -2
View File
@@ -5,7 +5,7 @@ description: PDFs über den PdfCraft-MCP-Server öffnen, auslesen, schwärzen, b
# PDFs mit PdfCraft (MCP) # PDFs mit PdfCraft (MCP)
PdfCraft ist ein Open-Source-PDF-Programm (Rust), das Acrobat-Pro-Parität anstrebt. Getestet mit Version 0.9.0. PdfCraft ist ein Open-Source-PDF-Programm (Rust), das Acrobat-Pro-Parität anstrebt. CLI 0.14.0. Die Schwärz-Fallen sind am 0.9.0 bestätigt und an 0.14.0 nicht erneut durchgespielt.
## Voraussetzung ## Voraussetzung
@@ -50,7 +50,7 @@ Wichtige Werkzeuge über `tool_call`: `redact_mark`, `redact_apply`, `doc_audit_
- **`doc_combine {paths, out, open: true}`** schreibt die Datei sofort. Das geöffnete Ergebnis heißt „Combined“ und hat keinen Pfad: Spätere Änderungen mit `doc_save {path}` speichern. Lesezeichen heißen danach wie die Quelldateien; mit `bookmark_rename` umbenennen. - **`doc_combine {paths, out, open: true}`** schreibt die Datei sofort. Das geöffnete Ergebnis heißt „Combined“ und hat keinen Pfad: Spätere Änderungen mit `doc_save {path}` speichern. Lesezeichen heißen danach wie die Quelldateien; mit `bookmark_rename` umbenennen.
- **Kopf-/Fußzeile:** `doc_header_footer {footer_right: "Seite <<1>> von <<n>>"}` funktioniert. Datums-Platzhalter gibt es nur amerikanisch (`<<m/d/yyyy>>`, `<<d/m/yyyy>>`, `<<yyyy-mm-dd>>`), `<<dd.mm.yyyy>>` bleibt als Text stehen. Das Datum ausgeschrieben einsetzen (`Stand 19.10.2026`). - **Kopf-/Fußzeile:** `doc_header_footer {footer_right: "Seite <<1>> von <<n>>"}` funktioniert. Datums-Platzhalter gibt es nur amerikanisch (`<<m/d/yyyy>>`, `<<d/m/yyyy>>`, `<<yyyy-mm-dd>>`), `<<dd.mm.yyyy>>` bleibt als Text stehen. Das Datum ausgeschrieben einsetzen (`Stand 19.10.2026`).
- `page_add_text`/Kopfzeilen: Schriften nur helvetica, times, courier; Umlaute, ß und € gehen. - `page_add_text`/Kopfzeilen: Schriften nur helvetica, times, courier; Umlaute, ß und € gehen.
- **OCR:** vorher `ocr_status`. Ohne mitgelieferte Sprachmodelle ist `available: false`; dann dem Nutzer sagen, dass gescannte PDFs nicht durchsuchbar gemacht werden können. - **OCR:** `ocr_status` (CLI 0.14.0 auf diesem Rechner: `available: true`, Sprache nur `en`, Modelle unter `C:\Program Files\PdfCraft\models`). `batch --steps convert,ocr,optimize` nimmt `--language` (Hilfe zeigt `en`). Deutsch ist nicht in der Sprachliste.
## Rezepte ## Rezepte
@@ -91,3 +91,4 @@ Dem Nutzer sagen, welche Kategorien geschwärzt wurden, und ihn das Ergebnis sel
- Digitale Signaturen: Nach Schwärzen, Zusammenführen oder Seitenänderungen ist eine bestehende Signatur ungültig. Den Nutzer vorher darauf hinweisen. - Digitale Signaturen: Nach Schwärzen, Zusammenführen oder Seitenänderungen ist eine bestehende Signatur ungültig. Den Nutzer vorher darauf hinweisen.
- Komplexe Layouts exportieren nur näherungsweise nach Word (`doc_export_office`). - Komplexe Layouts exportieren nur näherungsweise nach Word (`doc_export_office`).
- Formulare und JavaScript nur bearbeiten, wenn der Nutzer das ausdrücklich will. - Formulare und JavaScript nur bearbeiten, wenn der Nutzer das ausdrücklich will.
- CLI zusätzlich zu den MCP-Werkzeugen: `batch` (Schritte `convert`, `ocr`, `optimize`), `audit` (Scheinschwärzung, Exit-Code bei Fund), `tools` (JSON-Schemas). `audit` ersetzt nicht `doc_audit_redactions` nach einem Schwärzlauf.
+2 -2
View File
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "pdfcraft-mcp", "name": "pdfcraft-mcp",
"display_name": "PdfCraft for Claude", "display_name": "PdfCraft for Claude",
"version": "0.1.0", "version": "0.2.0",
"description": "PDFs öffnen, auslesen, schwärzen, bereinigen, zusammenführen und mit Seitenzahlen/Wasserzeichen versehen. Getestet mit PdfCraft 0.9.0. Benötigt PdfCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\PdfCraft\\.", "description": "PDFs öffnen, auslesen, schwärzen, bereinigen, zusammenführen und mit Seitenzahlen/Wasserzeichen versehen. CLI 0.14.0. Benötigt PdfCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\PdfCraft\\.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
+1 -1
View File
@@ -1 +1 @@
{"version":"0.9.0","repository":"https://github.com/storytold/pdfcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"pdfcraft-cli.exe","path":"C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe","tag":"v0.9.0","sha256":"149c8b55364fde4da332fed5cba3b31c084402867e5e5f8655fd05a69e995f60"} {"version":"0.14.0","repository":"https://github.com/storytold/pdfcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"pdfcraft-cli.exe","path":"C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe","tag":"v0.14.0","sha256":"bdd19e35f2f8bf4da75144545a1059fc9abcf499389313254adc13947e44ecaf"}
+12
View File
@@ -1,5 +1,17 @@
# Changelog – solidcraft-mcp # Changelog – solidcraft-mcp
## 0.3.0 (2026-10-26)
- CLI 0.23.0. Kantenwahl lehnt Punkte ab, die weiter als 5 % der Körpergröße von jeder Kante liegen. Mitgelieferte Skills über `skill_reference`: modeling, mechanisms, editing, checking (Checking-Text gegen 0.21.0).
- Neue Werkzeuge: `describe_command`, `crash_reports`, `pending`, `running`, `skill_reference`. Export zusätzlich OBJ und ASCII-STL.
- `--connect 127.0.0.1:PORT` steuert die App (`solidcraft --control PORT`). Ohne laufende App scheitern die Entwurfswerkzeuge; `skill_reference` bleibt. Die Erweiterung startet weiter kopflos mit zwei `--allow-path`. `solvecraft-cli.exe` ist nur noch ein Alias.
- Laser-DXF bleibt bei VectorCraft. Die SolidCraft-Hilfe nennt CADCraft nicht.
## 0.2.0 (2026-10-20)
- Befehlserklärungen zu SolidCraft 0.16.2: Nut vor dem Einstieg bei gleicher Startebene und gleichem Außenradius (`boolean Cut: no result` — Einstieg zuerst, die Nut ein Stück hinein und etwas flacher); `sketch.circle.center` lehnt einen Ausdruck in `diameter` ab (`needs radius or diameter`), Zahl plus `sketch.dimension` mit `type: diameter`, `solid.cylinder` nimmt Ausdrücke; `solid.revolve` mit `angle` dreht von der Skizzierebene nach −Y; ein Kreismuster solcher Schnitte kann `Boolean retry: tool displacement` um etwa 4e-4 mm warnen, das Volumen bleibt in der Toleranz.
- `solid.combine` mit `intersect` auf leerer Überdeckung löscht den Zielkörper und meldet trotzdem Erfolg. Vorher `inspect.interference`.
## 0.1.0 (2026-10-20) ## 0.1.0 (2026-10-20)
- Erste Version: Skill und Claude-Desktop-Erweiterung für SolidCraft 0.16.2. SolidCraft kommt über den eigenen Installer (`C:\Program Files\SolidCraft\solidcraft-cli.exe`, nicht auf PATH), nicht über den ArtCraft-Launcher. - Erste Version: Skill und Claude-Desktop-Erweiterung für SolidCraft 0.16.2. SolidCraft kommt über den eigenen Installer (`C:\Program Files\SolidCraft\solidcraft-cli.exe`, nicht auf PATH), nicht über den ArtCraft-Launcher.
+7 -5
View File
@@ -4,11 +4,11 @@
## Zweck ## Zweck
Baut parametrische 3D-Teile über den MCP-Server von SolidCraft, misst sie und gibt sie als .solidcraft, STEP, STL oder 3MF aus. Getestet mit 0.16.2 (Quader 40×30×20 mm = 24000 mm³). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). Baut parametrische 3D-Teile über den MCP-Server von SolidCraft, misst sie und gibt sie als .solidcraft, STEP, STL, OBJ oder 3MF aus. CLI 0.23.0. Der Quader 40×30×20 mm = 24000 mm³ ist an 0.16.2 gemessen, an 0.23.0 nicht wiederholt. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen ## Voraussetzungen
- **SolidCraft 0.16.2** über den eigenen Installer, getrennt vom ArtCraft-Launcher: [GitHub Releases](https://github.com/tangency-labs/solidcraft/releases) (MSI) oder `winget install bherbruck.SolidCraft`. CLI: `C:\Program Files\SolidCraft\solidcraft-cli.exe` (nicht auf PATH) - **SolidCraft 0.23.0** über den eigenen Installer, getrennt vom ArtCraft-Launcher: [GitHub Releases](https://github.com/tangency-labs/solidcraft/releases) (MSI) oder `winget install bherbruck.SolidCraft`. CLI: `C:\Program Files\SolidCraft\solidcraft-cli.exe` (nicht auf PATH). `solvecraft-cli.exe` ist nur ein Alias.
- Claude Desktop **oder** Cursor (siehe unten) - Claude Desktop **oder** Cursor (siehe unten)
- Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP - Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP
@@ -18,7 +18,7 @@ Baut parametrische 3D-Teile über den MCP-Server von SolidCraft, misst sie und g
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `solidcraft-mcp-v0.1.0.mcpb` und `solidcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.1.0/solidcraft-mcp-v0.1.0.mcpb) laden. 1. `solidcraft-mcp-v0.3.0.mcpb` und `solidcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/solidcraft-mcp%2Fv0.3.0/solidcraft-mcp-v0.3.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren).
3. **Beide Ordner ausfüllen.** Lese-Ordner weit: `Dokumente`. Schreib-Ordner eng: `Dokumente\Claude`. Jeder wird als `--allow-path` übergeben. Fehlt einer, kann der Agent dort nicht speichern. 3. **Beide Ordner ausfüllen.** Lese-Ordner weit: `Dokumente`. Schreib-Ordner eng: `Dokumente\Claude`. Jeder wird als `--allow-path` übergeben. Fehlt einer, kann der Agent dort nicht speichern.
4. Unter Einstellungen → Erweiterungen prüfen, dass **SolidCraft for Claude** eingeschaltet ist. 4. Unter Einstellungen → Erweiterungen prüfen, dass **SolidCraft for Claude** eingeschaltet ist.
@@ -29,7 +29,9 @@ Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
## Ordner und Start ## Ordner und Start
Der Server bekommt zwei `--allow-path` (Lese-Ordner und Schreib-Ordner) und läuft ohne Fenster. `--allow-path` erlaubt Lesen und Schreiben in dem genannten Ordner. **Kein `--connect`** (das würde eine laufende App ansprechen) und **kein `--allow-any-path`**. Der Server der Erweiterung bekommt zwei `--allow-path` (Lese-Ordner und Schreib-Ordner) und läuft kopflos. `--allow-path` erlaubt Lesen und Schreiben in dem genannten Ordner. **Kein `--allow-any-path`.**
`--connect 127.0.0.1:PORT` ist der andere Start: er steuert die laufende App (`solidcraft --control PORT`). Die Erweiterung setzt ihn nicht. Eine Cursor-`mcp.json` kann ihn trotzdem setzen, zusammen mit `--allow-path`. Lauscht die App nicht, scheitern die Entwurfswerkzeuge mit `no SolidCraft app is listening`; `skill_reference` geht weiter. Port 7878 ist der Port aus dieser Konfiguration, kein zweiter Standard neben dem, den der Nutzer an `--control` übergibt.
| | Standard | | | Standard |
|---|---| |---|---|
@@ -81,7 +83,7 @@ Statt der Erweiterung in `claude_desktop_config.json` eintragen. Stolpersteine:
} }
``` ```
Beide `--allow-path` setzen. `--connect` und `--allow-any-path` weglassen. Beide `--allow-path` setzen. `--allow-any-path` weglassen. `--connect 127.0.0.1:PORT` nur, wenn die App mit `solidcraft --control PORT` läuft.
## Änderungen ## Änderungen
+62 -45
View File
@@ -1,90 +1,107 @@
--- ---
name: solidcraft-mcp name: solidcraft-mcp
description: parametrische 3D-Teile über den SolidCraft-MCP-Server bauen, ändern, messen und als .solidcraft, STEP, STL oder 3MF ausgeben. Verwenden, wenn SolidCraft-Werkzeuge verbunden sind oder der Nutzer SolidCraft nennt; typisch für Laschen, Platten, Gehäuse, Bohrbilder. Nicht für 2D-DXF (VectorCraft) und nicht für native SOLIDWORKS-Dateien. description: parametrische 3D-Teile über den SolidCraft-MCP-Server bauen, ändern, messen und als .solidcraft, STEP, STL, OBJ oder 3MF ausgeben. Verwenden, wenn SolidCraft-Werkzeuge verbunden sind oder der Nutzer SolidCraft nennt; typisch für Laschen, Platten, Gehäuse, Bohrbilder, Baugruppen. Nicht für Laser-DXF (VectorCraft), nicht für DXF/DWG-Zeichnungen (CADCraft) und nicht für native SOLIDWORKS-Dateien.
--- ---
# Parametrische Teile mit SolidCraft (MCP) # Parametrische Teile mit SolidCraft (MCP)
SolidCraft ist ein Open-Source-CAD (Rust) für parametrische Volumenkörper. Getestet mit Version 0.16.2. SolidCraft ist ein Open-Source-CAD (Rust) für parametrische Volumenkörper. CLI 0.23.0. Die mitgelieferten Skills (`skill_reference`) sind die Befehlsreferenz; dieser Text hält nur die Regeln fest, die davon abweichen oder die der Agent sonst falsch macht. Nur `solidcraft-cli.exe` starten. `solvecraft-cli.exe` ist ein Alias und fällt weg.
## Voraussetzung ## Voraussetzung
Die Werkzeuge `list_commands`, `execute`, `batch`, `inspect_design`, `measure`, `screenshot`, `export`, `open`, `save` … müssen verbunden sein. Ihr Präfix hängt vom Client und vom Namen der Erweiterung bzw. des Servers ab. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README). Die Werkzeuge `list_commands`, `execute`, `batch`, `inspect_design`, `measure`, `screenshot`, `export`, `open`, `save` … müssen verbunden sein. Ihr Präfix hängt vom Client ab. Fehlen sie, dem Nutzer sagen, dass der Server nicht verbunden ist (Einrichtung siehe README).
Dateizugriff nur in den erlaubten Ordnern (Lese- und Schreib-Ordner). Der Server läuft ohne Fenster. Zwei Starts, beides ist `solidcraft-cli mcp`:
- **Kopflos**, ohne `--connect` (optional `--headless`). Der Server rechnet im eigenen Prozess. `--allow-path` (mehrfach) begrenzt Lesen und Schreiben. Das ist der Start der Erweiterung.
- **An der App:** `--connect 127.0.0.1:PORT` (optional `--token`). Die App muss mit `solidcraft --control PORT` lauschen. Tut sie das nicht, antworten Entwurfswerkzeuge mit `no SolidCraft app is listening at 127.0.0.1:7878`. `skill_reference` liest trotzdem, die Skills stecken in der CLI. `--connect` ist nötig, wenn der Nutzer die offene Datei in der App sehen und anfassen soll. Für einen neuen Teil im Hintergrund reicht kopflos.
Lauscht die App nicht, nicht im Kreis wiederholen. Dem Nutzer sagen, dass `solidcraft --control 7878` fehlt, oder kopflos neu starten.
## Mitgelieferte Skills
Vor dem Bauen `skill_reference` lesen, nicht den Befehlskatalog auswendig lernen. `file` ist `SKILL.md` oder `reference.md` (Standard `reference.md`).
| Skill | Wann |
|---|---|
| `solidcraft-modeling` | neues Teil |
| `solidcraft-mechanisms` | Baugruppe, Gelenk, Zahnrad, Kurve, Kontakt, Bewegungsstudie |
| `solidcraft-editing` | bestehende Datei ändern, Checkpoint, Absturz |
| `solidcraft-checking` | Parameterbereiche, jeder zulässige Wert, STEP-Vergleich, Portierung aus build123d, CadQuery oder OpenSCAD. Der Text in der CLI nennt die Prüfung gegen 0.21.0 |
## Werkzeuge ## Werkzeuge
| Tool | Zweck | | Tool | Zweck |
|---|---| |---|---|
| `list_commands {filter}` | Befehlskatalog (id, Bezeichnung, Parameter). Nur mit Filter | | `list_commands {filter}` | Befehlskatalog. Nur mit Filter; ohne Filter über 100 KB |
| `describe_command {id}` | Parameter eines Befehls; für `solid.box`, `solid.extrude` und `engine.describe` auch JSON Schema |
| `execute {command, params, verbose}` | ein Befehl; ein Fehler lässt den Entwurf unverändert | | `execute {command, params, verbose}` | ein Befehl; ein Fehler lässt den Entwurf unverändert |
| `batch {commands, verbose}` | Schritte der Reihe nach; beim ersten Fehler wird der Stapel zurückgenommen | | `batch {commands, verbose}` | Schritte der Reihe nach; beim ersten Fehler wird der Stapel zurückgenommen |
| `inspect_design` | Parameter, Zeitachse (Fehler, Warnung), Körper, Skizzen | | `inspect_design` | Parameter, Zeitachse, Körper, Skizzen, Gelenke |
| `measure` | Volumen (mm³), Fläche, Schwerpunkt, Hüllbox, Zählungen | | `measure` | Volumen (mm³), Fläche, Schwerpunkt, Hüllbox |
| `body_topology {body}` | Kanten (Mittelpunkt) und Flächen (Name, Punkt) eines Körpers | | `body_topology {body}` | Kanten (Mittelpunkt) und Flächen |
| `set_parameter {name, value}` | Parameter anlegen oder ändern und neu rechnen | | `set_parameter {name, value}` | Parameter anlegen oder ändern |
| `screenshot` | PNG; immer `source: "model"` | | `screenshot` | PNG. Immer `source: "model"`, wenn die App verbunden ist |
| `export {path, format}` | step, 3mf, stl, urdf | | `export {path, format}` | step, 3mf, 3mf-tagged, stl, stla, obj, urdf |
| `open {path}` / `save {path}` | .solidcraft, STEP; STL und 3MF als Netz | | `open {path}` / `save {path}` | .solidcraft, STEP, Netz (.3mf, .stl, .obj, .glb, .gltf). `save` nach `.json` ist Klartext |
| `new_design` | leerer Entwurf | | `new_design` | leerer Entwurf |
| `undo` / `redo` | ein Schritt zurück oder wieder vor | | `undo` / `redo` | ein Schritt |
| `crash_reports` | Absturzberichte auf diesem Rechner. Den auslösenden Befehl nicht unverändert wiederholen |
| `running` | was die App gerade rechnet. Fragen, wenn ein Aufruf hängt, bevor derselbe Befehl noch einmal geht |
| `pending` | Ergebnis eines Aufrufs, der mit `still running:` zurückkam. Nicht noch einmal senden |
| `skill_reference` | mitgelieferte Skills, siehe oben |
## Arbeitsweise ## Arbeitsweise
1. **Zuerst rechnen:** Parameter, Lage (Teil um den Ursprung legen, damit Muster und Spiegel an den Ebenen hängen), für jede Kante oder Fläche den Weltpunkt, erwartetes Volumen und die Hüllbox. 1. **Zuerst `skill_reference`**, dann rechnen: Parameter, Lage (Teil um den Ursprung), für jede Kante oder Fläche den Weltpunkt, erwartetes Volumen und die Hüllbox.
2. **Wenige große `batch`-Aufrufe:** (1) Parameter und erster Körper, (2) Verrundung und Schale, (3) Bohrungen und Schnitte. Ein Stapel ist alles oder nichts (`failed.index`, `failed.error`). Einen riskanten Schritt allein schicken. 2. **Wenige große `batch`-Aufrufe.** Ein Stapel ist alles oder nichts (`failed.index`, `failed.error`). Einen riskanten Schritt allein schicken.
3. **Danach `measure`** gegen die eigene Rechnung. Volumen, Hüllbox und Flächenzahl (`faces`, nicht `kernel.faces`). Eine Lücke von etwa 0,001–0,01 % gilt als Treffer; lange flache Bögen etwa 0,1 %. 3. **Danach `measure`** gegen die eigene Rechnung. Volumen, Hüllbox und Flächenzahl (`faces`, nicht `kernel.faces`). Eine Lücke von etwa 0,001–0,01 % gilt als Treffer; lange flache Bögen etwa 0,1 %.
4. **Kanten** über den exakten Mittelpunkt wählen, als nackte Zahlen. Die senkrechte Eckkante eines zentrierten Quaders liegt bei `[w/2, d/2, h/2]`. 4. **Kanten** über den exakten Mittelpunkt wählen, als nackte Zahlen. Die senkrechte Eckkante eines zentrierten Quaders liegt bei `[w/2, d/2, h/2]`.
5. **`list_commands` nur mit `filter`.** Ohne Filter ist die Liste über 100 KB. 5. In großen Entwürfen `"verbose": false`.
6. In großen Entwürfen `"verbose": false` an `batch` und `execute`.
Längen sind mm. Winkel in Ausdrücken brauchen eine Einheit, z. B. `"30 deg"`. Längen sind mm. Winkel in Ausdrücken brauchen eine Einheit, z. B. `"30 deg"`.
## Fallen ## Fallen
- **Ein Schnitt kann Erfolg melden und das Volumen unverändert lassen.** Im Test mit 0.16.2 bestätigt: `solid.box` mit `length` 40, `width` 30, `height` 20 ergab 24000 mm³ (Hüllbox 0–40 × 0–30 × 0–20, 6 Flächen). Ein `solid.cylinder` mit `operation: "cut"` außerhalb des Quaders meldete keinen Fehler und ließ das Volumen bei 24000 mm³. Nur ein `measure`, das zur Rechnung passt, zählt. Die Doku beschreibt dasselbe für eine Bohrung, deren Skizze unter dem Teil in der Luft liegt: die Skizze auf die Deckfläche legen (`offset` der Höhe). - **Ein Schnitt kann Erfolg melden und das Volumen unverändert lassen.** An 0.16.2 gemessen, an 0.23.0 nicht wiederholt: `solid.box` 40×30×20 mm ergab 24000 mm³. Ein `solid.cylinder` mit `operation: "cut"` daneben ließ das Volumen stehen. Nur ein `measure`, das zur Rechnung passt, zählt. Die mitgelieferte Anleitung sagt dasselbe für eine Bohrung, deren Skizze in der Luft liegt.
- **Die Kantenwahl schnappt ohne Fehler an die nächste Kante.** Keine Abstandsschranke. Den Mittelpunkt aus der Geometrie rechnen und danach prüfen, ob sich die Flächenzahl geändert hat. Eine Wahl ist eine nackte Zahl, wird einmal aufgelöst und folgt danach ihrer Kante. - **Kantenwahl:** weiter als 5 % der Körpergröße von jeder Kante entfernt wird abgelehnt (`the nearest edge is 15.000 mm away`). Es gibt keine stille Schnappwahl mehr ohne Schranke. Den Mittelpunkt aus der Geometrie rechnen. Eine Wahl ist eine nackte Zahl, wird einmal aufgelöst und folgt danach ihrer Kante.
- **Außen verrunden, bevor geschält wird,** damit die Schale den Rundungen folgt. Ausnahme: eine Kante der Fläche, die die Schale entfernt (der Rand eines offenen Kastens). Diese Kante erst nach der Schale runden, sonst kann die Schale scheitern. - **Außen verrunden, bevor geschält wird,** damit die Schale den Rundungen folgt. Ausnahme: eine Kante der Fläche, die die Schale entfernt. Die mitgelieferte Anleitung nennt eine zweite Ausnahme: eine Verrundung zwischen zwei gekrümmten Flächen vor der Schale scheitert (`offset: only bodies with planes, cylinders, cones, spheres and tori`).
- **Eine nackte Zahl folgt keinem Parameter.** Was mitziehen soll, steht in einer Skizzenbemaßung oder einem Ausdruck (`"w/2 - wall"`). `solid.cylinder` nimmt Ausdrücke in `base`; `solid.hole` mit `position` ebenfalls. - **Eine nackte Zahl folgt keinem Parameter.** Was mitziehen soll, steht in einer Skizzenbemaßung oder einem Ausdruck.
- **`new_design` und `open` verwerfen ungespeicherte Arbeit.** Hat der Entwurf schon Features auf der Zeitachse, vorher fragen. Sonst in den offenen Entwurf weiterbauen. - **`new_design` und `open` verwerfen ungespeicherte Arbeit.** Hat der Entwurf Features auf der Zeitachse, vorher fragen.
- **Screenshot mit `source: "model"`.** `width` und `height` gelten nur für Modellbilder. Ohne `source` liefert ein mit der App verbundener Server das Fenster, und `view` dreht dessen Kamera. Für Features in Wänden `"view": "top"`. - **Screenshot mit `source: "model"`.** Ohne `source` liefert ein mit der App verbundener Server das Fenster, und `view` dreht dessen Kamera.
- **Nut vor dem Einstieg, gleiche Startebene und gleicher Außenradius** (0.16.2): der zweite `solid.revolve` mit `cut` meldet `boolean Cut: the operation failed: no result`. Einstieg zuerst.
- **`sketch.circle.center` nimmt im Feld `diameter` keinen Ausdruck** (`needs radius or diameter`). Zahl plus `sketch.dimension` mit `type: diameter`.
- **`solid.revolve` mit `angle` dreht von der Skizzierebene in die negative Winkelrichtung** (von +X nach −Y). `direction: symmetric` legt den Winkel um die Ebene.
- **Ein Kreismuster solcher Schnitte kann `Boolean retry: tool displacement` um etwa `4e-4` mm warnen.** Das Volumen an 0.16.2 blieb in der Toleranz. Die Checking-Anleitung sagt, eine Boolean-Warnung kann die Geometrie trotzdem falsch lassen: Volumen prüfen.
- **Überdeckung:** `solid.combine` mit `intersect` auf leerer Überdeckung löscht den Zielkörper und meldet trotzdem Erfolg. Zum Prüfen `inspect.interference`.
- **Absturz:** `crash_reports`, dann `doc.recovery_list` und `doc.recover`. Den abstürzenden Befehl nicht unverändert wiederholen. Vor riskanten Änderungen an einer bestehenden Datei `edit.checkpoint`.
## Rezepte ## Rezepte
1. **Grundplatte mit Bohrbild und Parameteränderung:** 1. **Grundplatte mit Bohrbild:** Parameter, ein `batch` (Skizze auf `XY`, Extrusion, Verrundung über Mittelpunkte innerhalb der 5-%-Schranke, Bohrung, Muster mit Ausdrücken), `measure`, `set_parameter`, erneut `measure`, `save` als `.solidcraft`, `export` als STEP.
1. Parameter für Länge, Breite, Dicke und Randabstand. 2. **Kleines Gehäuse:** Kasten, Außenkanten verrunden, Schale, Rand der Öffnung danach runden, `measure` nach jedem Schritt.
2. Ein `batch`: Skizze auf `XY`, Rechteck über den Ursprung, Extrusion, Verrundung der Außenecken über ihre Mittelpunkte, Bohrung auf der Deckfläche, rechteckiges Muster mit Abständen als Ausdrücke. 3. **Baugruppe:** nicht hier nachbauen. `skill_reference {"skill":"solidcraft-mechanisms","file":"SKILL.md"}`, dann erst Gelenke. URDF lässt Gelenke weg, die eine Schleife schließen.
3. `measure` gegen das gerechnete Volumen. 4. **Vorhandenes STEP nur ansehen:** `open` nur mit Zustimmung. `measure`, ein Bild `screenshot {source: "model", view: "iso"}`. Nichts ändern, solange der Nutzer nur messen will.
4. `set_parameter` der Länge, erneut `measure`: die Bohrungen bleiben in den Ecken, Schwerpunkt und Hüllbox verschieben sich um den gerechneten Betrag.
5. `save` als `.solidcraft`, `export` als STEP.
2. **Kleines Gehäuse (Deckel offen):**
1. Kasten (`solid.box` oder Extrusion).
2. Außenkanten verrunden.
3. Schale: die Deckfläche entfernen (`solid.shell`, Punkt oder Flächenname), Wandstärke als Parameter.
4. Den Rand der Öffnung danach runden.
5. `measure` nach Verrundung und nach der Schale. Speichern, STEP für die Weitergabe.
3. **Vorhandenes STEP öffnen, messen, Iso-Bild:** `open` nur mit Zustimmung (siehe Datenschutz). `measure` (Volumen, Hüllbox, Körperszahl). Ein Bild mit `screenshot {source: "model", view: "iso"}`. Nichts ändern, solange der Nutzer nur messen und ansehen will.
## Abschlussprüfung ## Abschlussprüfung
- `measure` passt zum selbst gerechneten Volumen, zur Hüllbox und zur Flächenzahl. - `measure` passt zum selbst gerechneten Volumen, zur Hüllbox und zur Flächenzahl.
- `inspect_design` mit `measure: false` und `sketches: false`: kein `error` in der Zeitachse. Eine Boolean-Warnung ist harmlos, wenn das Volumen trotzdem stimmt; stimmt es nicht, kann die Geometrie falsch sein, ohne dass ein Fehler gemeldet wurde. - `inspect_design` mit `measure: false` und `sketches: false`: kein `error` in der Zeitachse. Eine Boolean-Warnung nennen; stimmt das Volumen nicht, ist die Geometrie falsch, auch ohne Fehlerzeile.
- Ein `screenshot` mit `source: "model"` angesehen. - Ein `screenshot` mit `source: "model"` angesehen.
- Pfade von `.solidcraft` und Export dem Nutzer genannt. - Pfade von `.solidcraft` und Export dem Nutzer genannt.
## Datenschutz ## Datenschutz
Ampel: 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.
Ein Kunden-STEP mit Kundenname oder NDA-Vermerk ist 🔴: nur mit Zustimmung des Nutzers öffnen. - 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.
Ein Kunden-STEP mit Kundenname oder NDA-Vermerk ist rot: nur mit Zustimmung des Nutzers öffnen.
## Grenzen ## Grenzen
- Kein SLDPRT und kein SLDASM. Native SOLIDWORKS-Dateien werden nicht geöffnet. - Kein SLDPRT und kein SLDASM.
- Kein Ersatz für eine freigegebene Fertigungszeichnung. STEP und STL sind Geometrie, keine Zeichnung mit Toleranzen. - Kein Ersatz für eine freigegebene Fertigungszeichnung.
- Baugruppen mit Gelenken nur am Rand. `export` kann URDF schreiben; Gelenke, Kontakte und Bewegungsstudien gehören nicht in diesen Ablauf. - 2D-DXF für Laser bleibt bei VectorCraft. Die SolidCraft-Hilfe nennt CADCraft nicht; DXF/DWG als Zeichnung mit AutoCAD-Befehlen ist CADCraft, nicht dieser Skill.
- 2D-DXF für Laser bleibt bei VectorCraft.
@@ -29,5 +29,8 @@ for sketch text, BIZ UDPGothic for web Japanese display) are licensed under SIL
per-file list is in ATTRIBUTION.md. per-file list is in ATTRIBUTION.md.
SolidCraft is an independent project and is not affiliated with, sponsored by or endorsed by SolidCraft is an independent project and is not affiliated with, sponsored by or endorsed by
Autodesk, Inc. Autodesk and Fusion are trademarks of Autodesk, Inc.; they are used here only to Autodesk, Dassault Systèmes, PTC, Siemens, Blender or any other CAD vendor. Fusion, AutoCAD,
describe compatibility goals. Inventor, Alias and Tinkercad are trademarks of Autodesk, Inc.; SolidWorks is a trademark of
Dassault Systèmes; Onshape and Creo are trademarks of PTC; Blender is a trademark of the Blender
Foundation. Product names appear only to describe compatibility, such as the mouse navigation
presets in Preferences › Navigation and file formats from public specifications.
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "solidcraft-mcp", "name": "solidcraft-mcp",
"display_name": "SolidCraft for Claude", "display_name": "SolidCraft for Claude",
"version": "0.1.0", "version": "0.3.0",
"description": "Parametrische 3D-Teile bauen, ändern, messen und als STEP, STL oder 3MF ausgeben. Getestet mit SolidCraft 0.16.2. Benötigt SolidCraft aus dem eigenen Installer unter C:\\Program Files\\SolidCraft\\.", "description": "Parametrische 3D-Teile bauen, ändern, messen und als STEP, STL, OBJ oder 3MF ausgeben. CLI 0.23.0. Benötigt SolidCraft aus dem eigenen Installer unter C:\\Program Files\\SolidCraft\\.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
@@ -1 +1 @@
{"version":"0.16.2","repository":"https://github.com/tangency-labs/solidcraft","bundled":false,"source":"SolidCraft-Installer","exe":"solidcraft-cli.exe","path":"C:\\Program Files\\SolidCraft\\solidcraft-cli.exe","tag":"v0.16.2","sha256":"ad153608cde0323577f7d6bc8e9cd1a0390d649495aac3adfa7b79ff83f06190"} {"version":"0.23.0","repository":"https://github.com/tangency-labs/solidcraft","bundled":false,"source":"SolidCraft-Installer","exe":"solidcraft-cli.exe","path":"C:\\Program Files\\SolidCraft\\solidcraft-cli.exe","tag":"v0.23.0","sha256":"3a8ad3262b659df64df7fa962309807eca400b31df352eb7f4a353381a32e3cb"}
+5
View File
@@ -1,5 +1,10 @@
# Changelog – vectorcraft-mcp # Changelog – vectorcraft-mcp
## 0.2.0 (2026-10-26)
- CLI 0.17.0. Lesbar zusätzlich .drawcraft, .psd, .psb, .af, .afdesign, .afpub; schreibbar unter anderem .psd. DWG steht in keiner der beiden Listen.
- `mcp` ohne Ordner-Flags versucht zuerst 127.0.0.1:7979 und fällt sonst auf kopflos zurück. Ordner-Flags erzwingen kopflos.
## 0.1.0 (2026-10-19) ## 0.1.0 (2026-10-19)
- Erste Version: Skill und Claude-Desktop-Erweiterung für VectorCraft 0.13.1 aus dem ArtCraft-Launcher (`C:\Program Files\VectorCraft\vectorcraft-cli.exe`, nicht auf PATH). - Erste Version: Skill und Claude-Desktop-Erweiterung für VectorCraft 0.13.1 aus dem ArtCraft-Launcher (`C:\Program Files\VectorCraft\vectorcraft-cli.exe`, nicht auf PATH).
+2 -2
View File
@@ -4,7 +4,7 @@
## Zweck ## Zweck
Zeichnet Vektorgrafiken über den MCP-Server von VectorCraft und exportiert sie als SVG, PDF oder DXF. Getestet mit 0.13.1 (Typenschilder, Schilder, DXF für Laser). Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). 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 ## Voraussetzungen
@@ -18,7 +18,7 @@ Zeichnet Vektorgrafiken über den MCP-Server von VectorCraft und exportiert sie
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `vectorcraft-mcp-v0.1.0.mcpb` und `vectorcraft-mcp-v0.1.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/vectorcraft-mcp%2Fv0.1.0/vectorcraft-mcp-v0.1.0.mcpb) laden. 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). 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. 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. 4. Unter Einstellungen → Erweiterungen prüfen, dass **VectorCraft for Claude** eingeschaltet ist.
+5 -5
View File
@@ -1,17 +1,17 @@
--- ---
name: vectorcraft-mcp 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. 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. 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) # Vektorgrafik mit VectorCraft (MCP)
VectorCraft ist ein Open-Source-Vektorprogramm (Rust), das Illustrator-Parität anstrebt. Getestet mit Version 0.13.1. 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 ## 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). 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. Wegen der Ordnergrenzen läuft der Server immer ohne Fenster (headless). Die Werkzeuge `inspect_ui`, `type_text`, `open_panel`, `ui_*` und `screenshot {window: true}` gehen deshalb nicht. 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 ## Werkzeuge
@@ -25,7 +25,7 @@ Dateizugriff: Lesen nur im Lese-Ordner, Schreiben nur im Schreib-Ordner. Wegen d
| `set_paint`, `transform`, `pathfinder`, `apply_effect` | Farbe, verschieben/drehen/skalieren, Boolesche Operationen, Effekte | | `set_paint`, `transform`, `pathfinder`, `apply_effect` | Farbe, verschieben/drehen/skalieren, Boolesche Operationen, Effekte |
| `inspect_document {depth}` / `doc_inspect` | Ebenen, Objekte, Begrenzungen | | `inspect_document {depth}` / `doc_inspect` | Ebenen, Objekte, Begrenzungen |
| `render_preview` / `screenshot` | Zeichenfläche als PNG | | `render_preview` / `screenshot` | Zeichenfläche als PNG |
| `open_file` / `save_file` / `export` | .vectorcraft, SVG, PDF, AI, EPS, DXF, EMF, PNG, JPG … | | `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 | | `undo` / `redo` | Verlauf |
## Arbeitsweise ## Arbeitsweise
@@ -81,4 +81,4 @@ Kundenzeichnungen (DXF/PDF) mit Kundenname oder NDA-Vermerk sind 🔴: nur mit Z
- **Keine zertifizierten Sicherheitszeichen.** Selbst gezeichnete Warnschilder sind Entwürfe. Für die Maschine die offiziellen ISO-7010-Zeichen verwenden und das dem Nutzer sagen. - **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. - Logos und Marken Dritter nicht nachzeichnen. Eigenes Firmenlogo nur aus einer Datei, die der Nutzer liefert.
- DWG kann nicht geschrieben werden, nur DXF. Binäre DXF und DWG werden nicht geöffnet. - 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.
@@ -75,12 +75,12 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Shared PDF backend Shared PDF backend
The patched hayro-interpret 0.7.0, hayro-syntax 0.7.2 and hayro-jbig2 0.3.0 The patched hayro-interpret 0.7.0, hayro-syntax 0.7.2, hayro-jbig2 0.3.0, hayro-cmap 0.1.0
are fetched from https://github.com/storytold/craft-libs at revision and hayro-postscript 0.1.0 are fetched from https://github.com/storytold/craft-libs at revision
ca50d63b773c99f96e75c77ce5a1d21e7c9cda0d. Their upstream project is 2eca9b3a53a98ac52efed2a27353c6a6927ead10. Their upstream project is
https://github.com/LaurenzV/hayro, licensed MIT OR Apache-2.0. The snapshot retains each https://github.com/LaurenzV/hayro, licensed MIT OR Apache-2.0. The snapshot retains each
crate's upstream licence files. The patch ledger is at crate's upstream licence files. The patch ledger is at
https://github.com/storytold/craft-libs/blob/ca50d63b773c99f96e75c77ce5a1d21e7c9cda0d/vendor/README.craft-reader.md. https://github.com/storytold/craft-libs/blob/2eca9b3a53a98ac52efed2a27353c6a6927ead10/vendor/README.craft-reader.md.
Assets already bundled through Hayro's default features retain their licences: Assets already bundled through Hayro's default features retain their licences:
- Foxit standard-14 substitutes: Copyright 2014 PDFium Authors. All rights reserved. - Foxit standard-14 substitutes: Copyright 2014 PDFium Authors. All rights reserved.
@@ -92,3 +92,34 @@ Assets already bundled through Hayro's default features retain their licences:
non-visual character-mapping data; see licenses/pdf-backend/hayro-cmap/LICENSE.txt. non-visual character-mapping data; see licenses/pdf-backend/hayro-cmap/LICENSE.txt.
Adobe and contributor names do not endorse or promote this product. Adobe and contributor names do not endorse or promote this product.
Per-file hashes and sources are recorded in ASSETS.md. Per-file hashes and sources are recorded in ASSETS.md.
Linux Wayland window decorations
-------------------------------
sctk-adwaita 0.10.1 (https://github.com/PolyMeilex/sctk-adwaita,
commit d5f343c45c04d4a026db57f76760819b7325db00) is used by winit on Linux
for vector window controls. Its title-font features are disabled: no Cantarell
font is embedded by this dependency and no font file is added to this repo.
sctk-adwaita's MIT licence:
MIT License
Copyright (c) 2022 Bartłomiej Maryńczak
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "vectorcraft-mcp", "name": "vectorcraft-mcp",
"display_name": "VectorCraft for Claude", "display_name": "VectorCraft for Claude",
"version": "0.1.0", "version": "0.2.0",
"description": "Vektorgrafiken zeichnen – Typenschilder, Schilder, Piktogramme – und als SVG/PDF/DXF exportieren. Getestet mit VectorCraft 0.13.1. Benötigt VectorCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\VectorCraft\\.", "description": "Vektorgrafiken zeichnen und als SVG/PDF/DXF exportieren. Öffnet auch PSD und Affinity. CLI 0.17.0. Benötigt VectorCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\VectorCraft\\.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
@@ -1 +1 @@
{"version":"0.13.1","repository":"https://github.com/storytold/vectorcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"vectorcraft-cli.exe","path":"C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe","tag":"v0.13.1","sha256":"fb1867428fc134c1e02418ff010e81a05a01d39e6148177accfb5b4944c48dd9"} {"version":"0.17.0","repository":"https://github.com/storytold/vectorcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"vectorcraft-cli.exe","path":"C:\\Program Files\\VectorCraft\\vectorcraft-cli.exe","tag":"v0.17.0","sha256":"4f6e76d6394dfe77e081770ef207abd5804207378f9b1c489acfe5dbb1a9d52a"}
+6
View File
@@ -1,5 +1,11 @@
# Changelog – wordcraft-mcp # Changelog – wordcraft-mcp
## 0.4.0 (2026-10-26)
- CLI 0.11.0. Neues Dokument folgt der Systemregion (auf diesem Rechner A4, nicht mehr pauschal US-Letter). `mcp --connect` und die Ordner-Flags schließen sich aus.
- Formate: XML (Flat OPC, Word 2003 XML über die CLI). Passwort und Zotero nur als CLI belegt; das MCP-Feld für Passwörter ist nicht geprüft.
- Renderer-Grenzen bleiben als Befund von 0.8.0 stehen.
## 0.3.0 (2026-10-19) ## 0.3.0 (2026-10-19)
- Skill clientneutral: Claude-/Cursor-Details nur noch in README/docs; schärfere `description`. - Skill clientneutral: Claude-/Cursor-Details nur noch in README/docs; schärfere `description`.
+4 -4
View File
@@ -4,7 +4,7 @@
## Zweck ## Zweck
Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung und der Fallen aus dem Praxistest mit WordCraft 0.8.0. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral). Erstellt, bearbeitet und prüft Word-Dokumente über den MCP-Server von WordCraft – inklusive Nachverfolgung. CLI 0.11.0; die Fallen stammen aus dem Praxistest mit 0.8.0 und sind nicht erneut durchgespielt. Die Anweisungen für den Agenten stehen in [SKILL.md](SKILL.md) (clientneutral).
## Voraussetzungen ## Voraussetzungen
@@ -20,7 +20,7 @@ Falls der Plugin-Skill `wordcraft-dokumente` installiert ist: deaktivieren bzw.
Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz: Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
1. `wordcraft-mcp-v0.3.0.mcpb` und `wordcraft-mcp-v0.3.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.3.0/wordcraft-mcp-v0.3.0.mcpb) laden. 1. `wordcraft-mcp-v0.4.0.mcpb` und `wordcraft-mcp-v0.4.0.zip` aus dem [Release](https://git.gundel.dev/dg/claude-skills/releases/download/wordcraft-mcp%2Fv0.4.0/wordcraft-mcp-v0.4.0.mcpb) laden.
2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). **Lese-Ordner weit** (z. B. Dokumente oder Benutzerordner), **Schreib-Ordner eng** (eigener Ordner, z. B. `Dokumente\Claude`). 2. Die `.mcpb` doppelklicken (oder über Einstellungen → Erweiterungen installieren). **Lese-Ordner weit** (z. B. Dokumente oder Benutzerordner), **Schreib-Ordner eng** (eigener Ordner, z. B. `Dokumente\Claude`).
3. Unter Einstellungen → Erweiterungen prüfen, dass **WordCraft for Claude** eingeschaltet ist. 3. Unter Einstellungen → Erweiterungen prüfen, dass **WordCraft for Claude** eingeschaltet ist.
4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**. 4. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
@@ -28,7 +28,7 @@ Schritt-für-Schritt: [docs/INSTALLATION.md](../../docs/INSTALLATION.md). Kurz:
Bei `open_document` / `save_document` in Claude „Immer fragen“ lassen, wenn du Pfade mitkontrollieren willst. Bei `open_document` / `save_document` in Claude „Immer fragen“ lassen, wenn du Pfade mitkontrollieren willst.
Wer v0.1.0 oder v0.2.0 installiert hat: alte Erweiterung entfernen, v0.3.0 installieren, einschalten, Skill-ZIP v0.3.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen. Wer v0.1.0, v0.2.0 oder v0.3.0 installiert hat: alte Erweiterung entfernen, v0.4.0 installieren, einschalten, Skill-ZIP v0.4.0 hochladen. Alte Skills `wordcraft-dokumente` bitte löschen.
**Umsteigen von der manuellen Config:** Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie), sonst gibt es die Werkzeuge doppelt. **Umsteigen von der manuellen Config:** Eintrag `wordcraft` unter `mcpServers` vor der Installation der Erweiterung entfernen (vorher Sicherungskopie), sonst gibt es die Werkzeuge doppelt.
@@ -76,7 +76,7 @@ Die App kann den Eintrag beim Speichern eigener Einstellungen überschreiben –
} }
``` ```
Laufende App steuern (nicht auf Ordner beschränkt): `wordcraft --control 7981` und `wordcraft-cli mcp --connect 127.0.0.1:7981`. Laufende App steuern (nicht auf Ordner beschränkt): `wordcraft --control 7981` und `wordcraft-cli mcp --connect 127.0.0.1:7981`. `--connect` und die Ordner-Flags zusammen sind ein Fehler.
```powershell ```powershell
Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue Get-ChildItem "$env:ProgramFiles","$env:LOCALAPPDATA" -Recurse -Filter "wordcraft-cli.exe" -ErrorAction SilentlyContinue
+8 -4
View File
@@ -23,7 +23,7 @@ Schutz durch Lese- und Schreib-Root (nicht die Freigabe-Dialoge). Lesen weit, Sc
| `execute` | einen Befehl ausführen: `{command, params}` | | `execute` | einen Befehl ausführen: `{command, params}` |
| `batch` | mehrere Befehle in Reihenfolge (stoppt beim ersten Fehler) | | `batch` | mehrere Befehle in Reihenfolge (stoppt beim ersten Fehler) |
| `new_document` | blank, sample, letter, resume, report | | `new_document` | blank, sample, letter, resume, report |
| `open_document` / `save_document` | docx, doc (nur öffnen), odt, rtf, html, md, tex, txt, json; speichern auch pdf, png | | `open_document` / `save_document` | docx, doc (nur öffnen), odt, rtf, html, md, tex, txt, json, xml (Flat OPC; CLI `--format wordml2003` für Word 2003 XML); speichern auch pdf, png |
| `type_text` | an der Schreibmarke tippen (ersetzt Markierung) | | `type_text` | an der Schreibmarke tippen (ersetzt Markierung) |
| `select_text` | n-tes Vorkommen eines Textes markieren | | `select_text` | n-tes Vorkommen eines Textes markieren |
| `get_text` / `inspect_document` | Dokument zurücklesen (Struktur als JSON, inkl. Kopf-/Fußzeilen unter `parts`) | | `get_text` / `inspect_document` | Dokument zurücklesen (Struktur als JSON, inkl. Kopf-/Fußzeilen unter `parts`) |
@@ -50,7 +50,7 @@ Liegt eine Datei **außerhalb des Lese-Ordners**, wird sie abgelehnt. Dann: (a)
## Neues Dokument – Grundeinrichtung (DE) ## Neues Dokument – Grundeinrichtung (DE)
`new_document blank` startet in **US-Letter** und englischer Sprache. Immer zuerst: `new_document blank` übernimmt das Papier der Systemregion (CLI 0.11.0: A4, in Letter-Regionen US-Letter; `WORDCRAFT_REGION` setzt die Region fest). Auf diesem Rechner war ein leeres Dokument A4 (11906×16838 Twip), die Ränder 1 Zoll. Sprache und Ränder deshalb weiter explizit setzen:
```json ```json
[{"command":"layout.size","params":{"name":"A4"}}, [{"command":"layout.size","params":{"name":"A4"}},
{"command":"layout.margins","params":{"top":70.87,"bottom":56.69,"left":70.87,"right":56.69}}, {"command":"layout.margins","params":{"top":70.87,"bottom":56.69,"left":70.87,"right":56.69}},
@@ -141,7 +141,9 @@ Längen in Punkt, Farben als `"#RRGGBB"`, `[r,g,b]` oder `{"Rgb":[r,g,b]}`; bei
- Zeichen (`format.set {"props": …}`): `font`, `size`, `bold`, `italic`, `underline`, `color`, `highlight`, `vertAlign`, `lang`, `link` - Zeichen (`format.set {"props": …}`): `font`, `size`, `bold`, `italic`, `underline`, `color`, `highlight`, `vertAlign`, `lang`, `link`
- Absatz (`para.set {"props": …}`): `style`, `align`, `indentLeft`, `indentFirst`, `spaceBefore`, `spaceAfter`, `lineSpacing` (`{"rule":"multiple","value":1.15}`), `keepNext`, `keepLines`, `pageBreakBefore`, `outlineLevel`, `numbering`, `tabs`, `borders`, `shading` - Absatz (`para.set {"props": …}`): `style`, `align`, `indentLeft`, `indentFirst`, `spaceBefore`, `spaceAfter`, `lineSpacing` (`{"rule":"multiple","value":1.15}`), `keepNext`, `keepLines`, `pageBreakBefore`, `outlineLevel`, `numbering`, `tabs`, `borders`, `shading`
## Renderer-Grenzen (0.8.0) ## Renderer-Grenzen (an 0.8.0 gesehen)
An 0.11.0 nicht erneut geprüft:
- mehrzeilige Zellen in dunkel hinterlegten Tabellenköpfen zeigen nur die letzte Zeile - mehrzeilige Zellen in dunkel hinterlegten Tabellenköpfen zeigen nur die letzte Zeile
- Seitenzahlfelder in Fußzeilen importierter python-docx-Dokumente bleiben leer - Seitenzahlfelder in Fußzeilen importierter python-docx-Dokumente bleiben leer
@@ -156,5 +158,7 @@ Bei Auffälligkeiten erst das Original rendern und vergleichen.
## Grenzen ## Grenzen
- Die Ordnerbeschränkung gilt nur headless; mit verbundener Desktop-App entfällt sie. - Die Ordner-Flags gelten nur kopflos. `mcp --connect HOST:PORT` und `--automation-read-root` / `--automation-write-root` zusammen sind ein Fehler (CLI 0.11.0). Mit verbundener App entfällt die Ordnersperre.
- Befehle ohne Pfad wirken immer auf das zuletzt geöffnete Dokument. Vor dem Öffnen eines anderen Dokuments speichern. - Befehle ohne Pfad wirken immer auf das zuletzt geöffnete Dokument. Vor dem Öffnen eines anderen Dokuments speichern.
- Passwortgeschützte Dateien: die CLI nimmt `--password`, `--password-file` oder `WORDCRAFT_PASSWORD` und schreibt das Passwort wieder mit. Ob `open_document` ein Passwort-Feld hat, ist nicht geprüft.
- Zotero (CLI, Zotero muss laufen): `addEditCitation`, `addEditBibliography`, `addNote`, `refresh`, `removeCodes`, `setDocPrefs`. Kein eigenes MCP-Werkzeug dafür geprüft.
@@ -52,6 +52,28 @@ list (author, source, license) is in ATTRIBUTION.md.
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE. OF THE POSSIBILITY OF SUCH DAMAGE.
- German hyphenation patterns (assets/hyphenation/de.pat) — hyph-de-1996.tex (reformed spelling)
from the hyph-utf8 package, bundled unmodified and used under the MIT License; the copyright
and permission notice is in the file:
Copyright (c) 2013-2024 Stephan Hennig, Werner Lemberg, Günter Milde, Sander van Geloven,
Georg Pfeiffer, Gisbert W. Selke, Tobias Wendorf, Keno Wehr
Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or
substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
- Italian hyphenation patterns (assets/hyphenation/it.pat) — hyph-it.tex from the hyph-utf8 - Italian hyphenation patterns (assets/hyphenation/it.pat) — hyph-it.tex from the hyph-utf8
package, Copyright (C) 2008-2011 Claudio Beccari, bundled unmodified and used under the MIT package, Copyright (C) 2008-2011 Claudio Beccari, bundled unmodified and used under the MIT
License (offered under LPPL 1.3+ or MIT); the copyright and permission notice is in the file: License (offered under LPPL 1.3+ or MIT); the copyright and permission notice is in the file:
+2 -2
View File
@@ -2,8 +2,8 @@
"manifest_version": "0.3", "manifest_version": "0.3",
"name": "wordcraft-mcp", "name": "wordcraft-mcp",
"display_name": "WordCraft for Claude", "display_name": "WordCraft for Claude",
"version": "0.3.0", "version": "0.4.0",
"description": "Word-Dokumente (.docx, .odt, .md, PDF) erstellen und bearbeiten. Getestet mit WordCraft 0.8.0. Benötigt WordCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\WordCraft\\.", "description": "Word-Dokumente (.docx, .odt, .md, PDF, XML) erstellen und bearbeiten. CLI 0.11.0. Benötigt WordCraft aus dem ArtCraft-Launcher unter C:\\Program Files\\WordCraft\\.",
"author": { "author": {
"name": "Dominic Gundel" "name": "Dominic Gundel"
}, },
+1 -1
View File
@@ -1 +1 @@
{"version":"0.8.0","repository":"https://github.com/storytold/wordcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"wordcraft-cli.exe","path":"C:\\Program Files\\WordCraft\\wordcraft-cli.exe","tag":"v0.8.0","sha256":"58716716647575ab68d1638f0b0a5b37b62f05cb4ed896614e7e98da5801221a"} {"version":"0.11.0","repository":"https://github.com/storytold/wordcraft","bundled":false,"source":"ArtCraft-Launcher","exe":"wordcraft-cli.exe","path":"C:\\Program Files\\WordCraft\\wordcraft-cli.exe","tag":"v0.11.0","sha256":"f8435abe4bc7ebc84a6a98a2e0bf60cab8e4757a953e0b85d6e5c677093aa3a5"}