claude-skills/skills/solidcraft-mcp/README.md

solidcraft-mcp

Alle Skills

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 (clientneutral).

Voraussetzungen

• SolidCraft 0.16.2 über den eigenen Installer, getrennt vom ArtCraft-Launcher: GitHub 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 und docs/CURSOR.md.

Installation (Claude Desktop)

Schritt-für-Schritt: docs/INSTALLATION.md. Kurz:

1. solidcraft-mcp-v0.2.0.mcpb und solidcraft-mcp-v0.2.0.zip aus dem Release 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 (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.

• Claude-Installer: %APPDATA%\Claude\claude_desktop_config.json
• Microsoft-Store-App: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.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