91 lines
4.7 KiB
Markdown
91 lines
4.7 KiB
Markdown
# 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, 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
|
||
|
||
- **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)
|
||
- 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.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).
|
||
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 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 |
|
||
|---|---|
|
||
| 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. `--allow-any-path` weglassen. `--connect 127.0.0.1:PORT` nur, wenn die App mit `solidcraft --control PORT` läuft.
|
||
|
||
## Änderungen
|
||
|
||
[CHANGELOG.md](CHANGELOG.md)
|