solidcraft-cli mcp ist ein Model-Context-Protocol-Server über stdio. Agenten führen dieselben Engine-Befehle aus wie Werkzeugleiste, Skripte und CLI – Skizzen und Features erstellen, Parameter setzen, messen, Screenshots aufnehmen, STEP/STL exportieren, rückgängig machen und wiederholen –, ohne Dialoge zu öffnen.
solidcraft --control PORT gestartet wurde – Sie können dabei zusehen.# Headless
solidcraft-cli mcp
# Headless mit einer Konstruktion oder einem Skript
solidcraft-cli mcp --in part.solidcraft
# Über die Bridge mit der laufenden App verbinden
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
Bei Snap-Installationen heißt die CLI solidcraft.cli.
SOLIDCRAFT_CONTROL_TOKEN statt --token verwenden – Kommandozeilenargumente sind in der Prozessliste sichtbar (offizielle Dokumentation).solidcraft-cli für MCPDas Linux-AppImage startet das GUI-Binary (solidcraft) und bietet mcp nicht als CLI an. Der MCP-Server steckt als solidcraft-cli im squashfs des AppImage – extrahieren Sie ihn oder nehmen Sie .tar.gz/.deb, die beide Programme enthalten. Geprüfte Schritte, Paketübersicht und Konfigurationen mit absoluten Pfaden für Claude Code / Desktop / Cursor:
Aus der offiziellen MCP-Dokumentation:
claude mcp add solidcraft -- solidcraft-cli mcp
Oder im Projekt per .mcp.json:
{
"mcpServers": {
"solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
}
}
Offizielles Beispiel für claude_desktop_config.json:
{
"mcpServers": {
"solidcraft": {
"command": "/pfad/zu/solidcraft-cli",
"args": ["mcp", "--connect", "127.0.0.1:7878"]
}
}
}
Starten Sie die App vorher mit solidcraft --control 7878.
~/.codex/config.toml (oder in vertrauenswürdigen Projekten in einer projekteigenen .codex/config.toml); Codex-CLI, IDE-Erweiterung und Desktop-App teilen sich diese Datei.Den Headless-Server mit einem Befehl hinzufügen:
codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list # prüfen, ob er registriert ist
Oder ~/.codex/config.toml von Hand bearbeiten, etwa um eine laufende App per Bridge anzusteuern und einen Konstruktionsordner freizugeben:
[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absoluter/pfad/zu/ihren/konstruktionen"]
In der Terminal-Oberfläche von Codex zeigt /mcp die aktiven Server. Liegt solidcraft-cli nicht im PATH, geben Sie den vollständigen Pfad zum Binary an (Snap: solidcraft.cli; AppImage: siehe wo die CLI liegt). Unabhängig davon kann das Panel „Agenten-Chat“ in der App Codex über npm install -g @agentclientprotocol/codex-acp einbinden (offizielle Dokumentation).
.cursor/mcp.json oder ~/.cursor/mcp.json). Prüfen Sie nach dem Neuladen, ob die Werkzeuge in den MCP-Einstellungen von Cursor erscheinen.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absoluter/pfad/zu/ihren/konstruktionen"]
}
}
}
Findet Cursor solidcraft-cli nicht im PATH, geben Sie den vollständigen Pfad zum Binary an. Bei Snap: solidcraft.cli.
| Werkzeug | Funktion |
|---|---|
list_commands | Befehlskatalog |
execute / batch | Modellierbefehle ausführen (batch kann bei Fehlern zurückrollen) |
inspect_design / measure / body_topology | Geometrie und Zeitleiste auslesen |
set_parameter | Parameter anlegen/ändern und neu berechnen |
screenshot | PNG des Modells oder des Fensters |
export | STEP, 3MF, STL, OBJ, URDF, … |
open / save / new_design | Dokumente anlegen, öffnen, speichern |
undo / redo | Verlauf |
crash_reports | Absturzberichte dieses Rechners auflisten oder einen per ID öffnen (Backtrace und letzte Befehle) |
Noch nicht in 0.16.2: Der Hauptzweig (main) des Projekts dokumentiert bereits zwei Neuerungen, die mit dem nächsten Release kommen dürften. Das schreibgeschützte Werkzeug describe_command liefert die Parameterdokumentation zu einem Befehl und – sofern der Befehl einen typisierten Contract hat (derzeit solid.box, solid.extrude und engine.describe) – JSON-Schemas für seine Eingaben und sein Ergebnis. Headless-Sitzungen erhalten außerdem --param-check off|warn|strict: off ist die Voreinstellung, warn führt den Aufruf aus, hängt aber Warnungen an, etwa bei einem vermutlich falsch geschriebenen Schlüssel, und strict lehnt den Aufruf ab und lässt die Konstruktion unverändert. Aufrufe, die an die laufende App weitergeleitet werden, werden noch nicht geprüft. Quelle: docs/mcp.md.
Optionale Agent-Skills liegen im Repository unter skills/ (solidcraft-modeling, solidcraft-editing usw.).
Standardmäßig greifen die Werkzeuge nur zu auf:
--allow-path DIR freigeben.solidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-path hebt die Beschränkung auf (früheres Verhalten) – nur mit Bedacht einsetzen.
Der grundsätzliche Ablauf nach der Beispielsitzung der offiziellen Dokumentation:
batch: Skizzenrechteck → Extrusion → Rundung → Bohrungmeasure: Volumen / Flächescreenshot mit view: "iso"export in einen Pfad innerhalb eines freigegebenen OrdnersDemo-Skripte: examples/demo/enclosure_mcp.py baut ein Gehäuse über MCP.
Siehe auch: CAD-MCP-Server im Vergleich · Installationsanleitung · Beispiele.