solidcraft-cli mcp è un server Model Context Protocol su stdio. Gli agenti eseguono gli stessi comandi del motore usati dalla barra degli strumenti, dagli script e dalla CLI (creare schizzi e feature, impostare parametri, misurare, fare screenshot, esportare in STEP/STL, annullare/ripetere) senza aprire finestre di dialogo.
solidcraft --control PORT, così puoi seguire il lavoro in diretta.# Headless
solidcraft-cli mcp
# Headless partendo da un progetto o da uno script
solidcraft-cli mcp --in part.solidcraft
# Con bridge verso l'app in esecuzione
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
Nelle installazioni Snap la CLI si chiama solidcraft.cli.
SOLIDCRAFT_CONTROL_TOKEN invece di --token: gli argomenti della riga di comando sono visibili nell'elenco dei processi (documentazione ufficiale).solidcraft-cli per MCPL'AppImage per Linux avvia l'eseguibile della GUI (solidcraft) e non espone mcp come comando CLI. Il server MCP si trova come solidcraft-cli dentro il filesystem squashfs dell'AppImage: estrailo, oppure usa il .tar.gz/.deb, che includono entrambi gli strumenti. Passaggi verificati, tabella dei pacchetti e configurazioni con percorsi assoluti per Claude Code / Desktop / Cursor:
Guida CLI e MCP per l'AppImage →
Dalla documentazione MCP ufficiale:
claude mcp add solidcraft -- solidcraft-cli mcp
Oppure nel file .mcp.json del progetto:
{
"mcpServers": {
"solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
}
}
Esempio ufficiale per claude_desktop_config.json:
{
"mcpServers": {
"solidcraft": {
"command": "/path/to/solidcraft-cli",
"args": ["mcp", "--connect", "127.0.0.1:7878"]
}
}
}
Prima avvia l'app con solidcraft --control 7878.
~/.codex/config.toml (oppure, nei progetti attendibili, in un .codex/config.toml di progetto), condiviso da Codex CLI, estensione IDE e app desktop.Aggiungi il server headless con un solo comando:
codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list # controlla che sia registrato
Oppure modifica a mano ~/.codex/config.toml, per esempio per collegarti con il bridge a un'app in esecuzione e consentire l'accesso a una cartella di progetti:
[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
Nell'interfaccia da terminale di Codex, /mcp mostra i server attivi. Se solidcraft-cli non è nel PATH, indica il percorso completo dell'eseguibile (Snap: solidcraft.cli; con l'AppImage: vedi dove si trova la CLI). A parte questo, il pannello Chat con l'agente integrato in SolidCraft può eseguire Codex tramite npm install -g @agentclientprotocol/codex-acp (documentazione ufficiale).
.cursor/mcp.json o ~/.cursor/mcp.json). Dopo il riavvio, controlla che gli strumenti compaiano nelle impostazioni MCP di Cursor.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Se Cursor non trova solidcraft-cli nel PATH, indica il percorso completo dell'eseguibile. Con Snap: solidcraft.cli.
| Strumento | Funzione |
|---|---|
list_commands | Catalogo dei comandi |
execute / batch | Esegue comandi di modellazione (batch può annullare tutto in caso di errore) |
inspect_design / measure / body_topology | Legge geometria e sequenza temporale |
set_parameter | Crea/modifica parametri e ricalcola |
screenshot | PNG del modello o della finestra |
export | STEP, 3MF, STL, OBJ, URDF… |
open / save / new_design | Ciclo di vita del documento |
undo / redo | Cronologia |
crash_reports | Elenca i report di crash di questo computer o ne apre uno tramite id (backtrace e ultimi comandi) |
Non ancora nella 0.16.2: il branch principale (main) del progetto documenta già due novità che dovrebbero arrivare con la prossima release. Uno strumento di sola lettura, describe_command, restituisce la documentazione dei parametri di un comando e, quando il comando ha un contratto tipizzato (per ora solid.box, solid.extrude e engine.describe), gli schemi JSON (JSON Schema) dei suoi input e del suo risultato. Le sessioni headless ottengono inoltre --param-check off|warn|strict: off è il valore predefinito, warn esegue la chiamata ma allega degli avvisi, ad esempio per una chiave probabilmente scritta male, e strict rifiuta la chiamata e lascia il progetto invariato. Le chiamate inoltrate all'app in esecuzione non vengono ancora controllate. Fonte: docs/mcp.md.
Le skill opzionali per gli agenti si trovano nella cartella skills/ del repository (solidcraft-modeling, solidcraft-editing ecc.).
Per impostazione predefinita gli strumenti accedono solo a:
--allow-path DIR.solidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-path elimina il limite (il comportamento precedente): usalo con cautela.
Il flusso concettuale della sessione di esempio nella documentazione ufficiale:
batch con rettangolo nello schizzo → estrusione → raccordo → foromeasure per volume / areascreenshot con view: "iso"export verso un percorso all'interno di una cartella consentitaScript dimostrativi: examples/demo/enclosure_mcp.py costruisce un contenitore tramite MCP.
Vedi anche: server MCP per CAD a confronto · guida all'installazione · esempi.