SolidCraft-MCP 0.1.0 aufnehmen, damit der Skill mit eigenem Installer wie die anderen Crafts ausgeliefert werden kann.

2026-10-20 00:26:49 +02:00
1 parent ad0ea86adc
commit f3e49b5d37
@@ -0,0 +1,88 @@
+# solidcraft-mcp
+
+[Alle Skills](../../README.md)
+
+## 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).
+
+## 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)
+- 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. `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.
+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.
+4. Unter Einstellungen → Erweiterungen prüfen, dass **SolidCraft for Claude** eingeschaltet ist.
+5. Skill-ZIP hochladen: **„+“ → „Skill erstellen“ → „Skill hochladen“**.
+6. Claude komplett beenden (auch Taskleiste) und neu starten. **Neuen** Chat öffnen.
+
+**Umsteigen von der manuellen Config:** Eintrag `solidcraft` unter `mcpServers` vor der Installation entfernen.
+
+## 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`**.
+
+| | Standard |
+|---|---|
+| Lesen | `${HOME}/Documents` |
+| Schreiben | `${HOME}/Documents/Claude` |
+
+## Freigaben
+
+In Claude bei `open`, `save` und `export` auf **„Immer fragen“** lassen, wenn du Pfade mitkontrollieren willst.
+
+## Enthaltene Software
+
+Die Erweiterung steuert [SolidCraft](https://github.com/tangency-labs/solidcraft) (MIT oder Apache-2.0) aus dem eigenen Installer; die CLI wird **nicht** mitgeliefert. Lizenztexte liegen in der `.mcpb` unter `LICENSES/`. Das Icon ist die App-Kachel 512×512 aus `assets/icons/app/linux/exports/hicolor/512x512/apps/ai.storyteller.solidcraft.png` (Tag v0.16.2, ebenfalls MIT oder Apache-2.0).
+
+## Test
+
+Neuen Chat öffnen und einen Quader 40×30×20 mm bauen lassen. Das Volumen muss 24000 mm³ sein. Präfix `…SolidCraft_for_Claude…`.
+
+Fehlen die Tools: Erweiterung eingeschaltet? CLI unter `C:\Program Files\SolidCraft\solidcraft-cli.exe`? Neu starten, neuer Chat.
+
+## Stolpersteine
+
+- Speichern scheitert, weil der Pfad außerhalb der erlaubten Ordner liegt: beide Ordner unter Einstellungen → Erweiterungen → SolidCraft for Claude setzen.
+- 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": {
+    "solidcraft": {
+      "command": "C:\\Program Files\\SolidCraft\\solidcraft-cli.exe",
+      "args": [
+        "mcp",
+        "--allow-path", "C:\\Pfad\\zu\\Dokumente",
+        "--allow-path", "C:\\Pfad\\zu\\Dokumente\\Claude"
+      ]
+    }
+  }
+}
+```
+
+Beide `--allow-path` setzen. `--connect` und `--allow-any-path` weglassen.
+
+## Änderungen
+
+[CHANGELOG.md](CHANGELOG.md)