SolidCraft-MCP 0.1.0 aufnehmen, damit der Skill mit eigenem Installer wie die anderen Crafts ausgeliefert werden kann.
This commit is contained in:
Dominic Gundel committed
1 parent
ad0ea86adc
commit
f3e49b5d37
21 files changed
+629
-22
No files matched your search
+23
-5
@@ -6,7 +6,7 @@ Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine
|
||||
|
||||
## Voraussetzung
|
||||
|
||||
1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die jeweilige App (Standardpfad `C:\Program Files\…\<app>-cli.exe`, nicht auf PATH). FigCraft steht im Katalog seit Launcher 0.4.1.
|
||||
1. [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die jeweilige App (Standardpfad `C:\Program Files\…\<app>-cli.exe`, nicht auf PATH). FigCraft steht im Katalog seit Launcher 0.4.1. SolidCraft getrennt davon: eigener Installer ([Releases](https://github.com/tangency-labs/solidcraft/releases) oder `winget install bherbruck.SolidCraft`), CLI `C:\Program Files\SolidCraft\solidcraft-cli.exe`.
|
||||
2. Cursor Desktop.
|
||||
|
||||
## Plugin installieren (empfohlen)
|
||||
@@ -16,9 +16,9 @@ Jedes Werkzeug ist ein **eigenes** Cursor-Plugin (1:1 zur Claude-`.mcpb`). Keine
|
||||
3. **Developer: Reload Window**.
|
||||
4. Unter Customize prüfen, dass Skill und MCP-Server sichtbar sind.
|
||||
|
||||
WordCraft, PdfCraft, FigCraft und VectorCraft: 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).
|
||||
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`.
|
||||
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).
|
||||
|
||||
## Alternativ: nur MCP + Skill
|
||||
|
||||
@@ -108,6 +108,23 @@ VectorCraft (Ordner-Argumente nicht weglassen):
|
||||
}
|
||||
```
|
||||
|
||||
SolidCraft (zwei `--allow-path`, kein `--connect`):
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"solidcraft": {
|
||||
"command": "C:\\Program Files\\SolidCraft\\solidcraft-cli.exe",
|
||||
"args": [
|
||||
"mcp",
|
||||
"--allow-path", "${userHome}/Documents",
|
||||
"--allow-path", "${userHome}/Documents/Claude"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Unterstützte Variablen in `mcp.json`: `${userHome}`, `${env:NAME}`, `${workspaceFolder}`, `${pathSeparator}` (siehe Cursor-MCP-Doku). In Plugin-`mcp.json` zusätzlich Plugin-Variablen (`${READ_ROOT}`, …) und `${CURSOR_PLUGIN_ROOT}` (hier unnötig, keine gebündelte EXE).
|
||||
|
||||
**1-Klick-Deeplink:** `config` ist nur das Transport-Objekt (`{command, args}`), der Servername steht in `name=`. Pfade mit Schrägstrich (`C:/Program Files/...`). Ein Wrapper `{ servername: {command…} }` im `config` führt in Cursor zu leerem `command`.
|
||||
@@ -120,7 +137,7 @@ PdfCraft ohne `--compact` liefert 171 Werkzeuge mit etwa 176 KB Beschreibung und
|
||||
|
||||
## Test
|
||||
|
||||
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. die andere App. PdfCraft: Test-PDF schwärzen und `doc_audit_redactions`. FigCraft: kleine HMI-Maske als PNG. VectorCraft: Typenschild 100×50 mm als DXF, Maße im CAD prüfen.
|
||||
Im Agent: „Sind die WordCraft-Werkzeuge verfügbar?“ bzw. die andere App. PdfCraft: Test-PDF schwärzen und `doc_audit_redactions`. FigCraft: kleine HMI-Maske als PNG. VectorCraft: Typenschild 100×50 mm als DXF, Maße im CAD prüfen. SolidCraft: Quader 40×30×20 mm, Volumen 24000 mm³.
|
||||
|
||||
## Probleme
|
||||
|
||||
@@ -129,8 +146,9 @@ 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\…`? |
|
||||
| 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. |
|
||||
| SolidCraft erreicht die Datei nicht | Beide `--allow-path` in der Plugin-`mcp.json`. Kein `--connect` und kein Port 7979. |
|
||||
| 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`) registriert. |
|
||||
| Doppelte Server | Alten Eintrag in `~/.cursor/mcp.json` entfernen, wenn das Plugin denselben Namen (`wordcraft`, `gridcraft`, `pdfcraft`, `figcraft`, `vectorcraft`, `solidcraft`) registriert. |
|
||||
|
||||
## Datenschutz
|
||||
|
||||
|
||||
+20
-5
@@ -1,6 +1,6 @@
|
||||
# Claude-Werkzeuge einrichten
|
||||
|
||||
Mit dieser Anleitung kann Claude auf deinem Rechner Word-Dokumente, Excel-Tabellen, PDFs, Oberflächen-Entwürfe und Vektorgrafiken 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 und parametrische 3D-Teile bearbeiten. Dauer: etwa 10 Minuten je Werkzeug. Du brauchst keine Programmierkenntnisse.
|
||||
|
||||
Für jedes Werkzeug installierst du zwei Dinge:
|
||||
|
||||
@@ -35,17 +35,28 @@ Installiere den [ArtCraft-Launcher](https://getartcraft.com/apps) und darin die
|
||||
|
||||
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).
|
||||
|
||||
## 1b. SolidCraft installieren
|
||||
|
||||
SolidCraft wird getrennt vom ArtCraft-Launcher installiert. Installer: [GitHub Releases](https://github.com/tangency-labs/solidcraft/releases) (MSI) oder in der Konsole `winget install bherbruck.SolidCraft`. Den Standardpfad nicht ändern.
|
||||
|
||||
| App | Wofür | CLI |
|
||||
|---|---|---|
|
||||
| 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**.
|
||||
|
||||
---
|
||||
|
||||
## 2. Dateien herunterladen
|
||||
|
||||
Lade die passende Version herunter (WordCraft und GridCraft **0.3.0**, PdfCraft, FigCraft und VectorCraft **0.1.0**):
|
||||
Lade die passende Version herunter (WordCraft und GridCraft **0.3.0**, PdfCraft, FigCraft, VectorCraft und SolidCraft **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)
|
||||
- [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)
|
||||
- [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)
|
||||
- [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)
|
||||
- [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)
|
||||
- [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)
|
||||
|
||||
Die ZIP-Dateien **nicht entpacken**.
|
||||
|
||||
@@ -59,9 +70,10 @@ Für jede `.mcpb`-Datei:
|
||||
2. Die `.mcpb`-Datei **doppelklicken** – oder sie ins Claude-Fenster ziehen.
|
||||
*Klappt beides nicht:* Einstellungen → Erweiterungen → Erweiterte Einstellungen → „Erweiterung installieren…“ → Datei auswählen.
|
||||
3. Es öffnet sich ein Installationsfenster. Angaben prüfen und bestätigen.
|
||||
4. **WordCraft, PdfCraft, FigCraft und VectorCraft** fragen nach zwei Ordnern. GridCraft nicht.
|
||||
4. **WordCraft, PdfCraft, FigCraft, VectorCraft und SolidCraft** fragen nach zwei Ordnern. GridCraft nicht.
|
||||
- **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.
|
||||
- **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`.
|
||||
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.
|
||||
@@ -78,7 +90,7 @@ Für jede `.zip`-Datei:
|
||||
1. In Claude auf **„+“** → **„Skill erstellen“** → **„Skill hochladen“**.
|
||||
2. Die ZIP-Datei auswählen und bestätigen.
|
||||
|
||||
Die Skills heißen danach `wordcraft-mcp`, `gridcraft-mcp`, `pdfcraft-mcp`, `figcraft-mcp` und `vectorcraft-mcp`.
|
||||
Die Skills heißen danach `wordcraft-mcp`, `gridcraft-mcp`, `pdfcraft-mcp`, `figcraft-mcp`, `vectorcraft-mcp` und `solidcraft-mcp`.
|
||||
|
||||
---
|
||||
|
||||
@@ -99,12 +111,13 @@ Je App ein kurzer Test:
|
||||
- **PdfCraft:** ein Test-PDF schwärzen und `doc_audit_redactions` ausführen.
|
||||
- **FigCraft:** eine kleine HMI-Maske als PNG exportieren.
|
||||
- **VectorCraft:** ein Typenschild 100×50 mm als DXF exportieren und die Maße im CAD prüfen.
|
||||
- **SolidCraft:** einen Quader 40×30×20 mm bauen und das Volumen prüfen lassen (24000 mm³).
|
||||
- **GridCraft:** eine kleine Excel-Tabelle mit drei Zeilen im Ausgabeordner anlegen.
|
||||
- **WordCraft:** ein kurzes Dokument im Schreib-Ordner speichern.
|
||||
|
||||
Beim ersten Mal fragt Claude, ob es die Werkzeuge benutzen darf – erlauben. Die Werkzeuge heißen mit Präfix `…PdfCraft_for_Claude…` (und entsprechend für die anderen Apps).
|
||||
|
||||
Lass bei WordCraft `open_document` / `save_document`, bei GridCraft `open_workbook` / `save_workbook` / `execute_command`, bei PdfCraft `doc_open` / `doc_save` / `tool_call` und bei FigCraft und VectorCraft `open_file` / `save_file` / `export` auf **„Immer fragen“**, wenn du Pfade mitkontrollieren willst.
|
||||
Lass bei WordCraft `open_document` / `save_document`, bei GridCraft `open_workbook` / `save_workbook` / `execute_command`, bei PdfCraft `doc_open` / `doc_save` / `tool_call`, bei FigCraft und VectorCraft `open_file` / `save_file` / `export` und bei SolidCraft `open` / `save` / `export` auf **„Immer fragen“**, wenn du Pfade mitkontrollieren willst.
|
||||
|
||||
---
|
||||
|
||||
@@ -123,6 +136,8 @@ 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. |
|
||||
| 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 speichert die Datei nicht | Beide Ordner im Dialog gesetzt? Die Args sind zwei `--allow-path`, kein `--connect`. |
|
||||
| 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. |
|
||||
| Excel-Formeln zeigen `#NAME?` | Claude hat deutsche Funktionsnamen benutzt. Sagen: „Nutze englische Formeln, wie im Skill beschrieben.“ |
|
||||
|
||||
Reference in new issue
Block a user