solidcraft-cli mcpLos agentes ejecutan los mismos comandos del motor que la barra de herramientas, los scripts y el CLI - crear esquemas, características, parámetros de configuración, medición, captura de pantalla, exportación STEP/STL, undo/redo - sin abrir diálogos.
127.0.0.1:27878(o el siguiente puerto gratuito hasta 27893). Desactivarlos en Preferencias › Asistente › "Deje que los agentes de IA se conecten (canal de control / MCP)" si lo prefiere.# Headless
solidcraft-cli mcp
# Headless from a design or script
solidcraft-cli mcp --in part.solidcraft
# Bridged: app listens by default — bare mcp finds it (headless when none runs; --headless forces that)
solidcraft &
solidcraft-cli mcp
# Fixed port / second app
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
En Snap instalará el CLIsolidcraft.cliLa aplicación escribe el puerto seleccionado paracontrol/current.porten su carpeta de datos;--control / SOLIDCRAFT_CONTROL_PORTTodavía se sobrepone.
SOLIDCRAFT_CONTROL_TOKENsobre--tokencuando bridge — las args de la línea de comandos se ven en la lista de procesos (docs oficiales).solidcraft-cli para MCPLa mayoría de los paquetes ponen solidcraft-cli en el PATH tras instalar (carpeta del instalador de Windows; deb/rpm/FreeBSD en /usr/bin; Homebrew cask; el AppImage en el primer arranque escribe un pequeño lanzador en ~/.local/bin; la app de macOS enlaza en /opt/homebrew/bin o /usr/local/bin). Dos quedan fuera del PATH a propósito: Snap expone solidcraft.cli; Flatpak ejecuta flatpak run --command=solidcraft-cli ai.storyteller.solidcraft — úselo como command del cliente con mcp en los args. El punto de entrada del AppImage sigue siendo la GUI; extraer solidcraft-cli del squashfs sigue siendo una alternativa válida. Pasos verificados y configs de cliente:
De acuerdo con el documento oficial del MCP:
claude mcp add solidcraft -- solidcraft-cli mcp
o Proyecto.mcp.json:
{
"mcpServers": {
"solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
}
}
Con el canal de control y MCP activos por defecto (0.21.0+, reiterado en 0.22.0), inicie la app con normalidad y apunte Claude Desktop a un simple mcp (encuentra la app en ejecución). Tras una instalación de paquete normal, solidcraft-cli suele estar en el PATH (carpeta del instalador de Windows; deb/rpm/FreeBSD; Homebrew; lanzador del AppImage en ~/.local/bin tras el primer arranque; enlace de la app de macOS) — reinicie el cliente para que tome el nuevo PATH. En Snap use solidcraft.cli; en Flatpak use flatpak con args run --command=solidcraft-cli ai.storyteller.solidcraft mcp (o configure command/args). El ejemplo oficial de puerto fijo para claude_desktop_config.json sigue valiendo si indica un puerto:
{
"mcpServers": {
"solidcraft": {
"command": "/path/to/solidcraft-cli",
"args": ["mcp"]
}
}
}
Para un puerto fijo:args: ["mcp", "--connect", "127.0.0.1:7878"]Inicia la aplicación consolidcraft --control 7878.
~/.codex/config.toml(o un proyecto.codex/config.tomlen proyectos de confianza), compartido por el Codex CLI, la extensión IDE y la aplicación de escritorio.Añade el servidor sin cabeza con un comando:
codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list # check it is registered
o Editar~/.codex/config.tomlmanualmente, por ejemplo, para conectarse a una aplicación en ejecución y permitir una carpeta de diseños:
[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
En la UI de terminal de Codex, /mcp muestra los servidores activos. Si solidcraft-cli no está en el PATH, use la ruta absoluta al binario (Snap: solidcraft.cli; Flatpak: flatpak run --command=solidcraft-cli ai.storyteller.solidcraft; AppImage: lanzador del primer arranque en ~/.local/bin, o vea dónde está el CLI). Por separado, el panel Agent chat de la app puede ejecutar Codex con npm install -g @agentclientprotocol/codex-acp (docs oficiales).
.cursor/mcp.jsono~/.cursor/mcp.jsonLas herramientas de verificación aparecen en la configuración de MCP de Cursor después de la descarga.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Use la ruta absoluta al binario si Cursor no encuentra solidcraft-cli en el PATH. En Snap: solidcraft.cli. En Flatpak: flatpak con run --command=solidcraft-cli ai.storyteller.solidcraft mcp.
| herramienta | El rol |
|---|---|
list_commands | Catálogo de comandos |
describe_command | Doces de parámetros para un comando; JSON Esquemas para su entrada y resultado donde el comando tiene un contrato tipado (sólo de lectura) |
execute / batch | Ejecuta comandos de modelado; batch puede revertir ante error e informa rolled_back, undone, applied y not_run. Opcional coalesce_parameters (por defecto false) fusiona ediciones consecutivas solo de parámetros para que el diseño se reconstruya una vez por ejecución (un solo undo; cada paso guarda una longitud de run coalesced). Algunas herramientas pueden nombrarse como pasos; screenshot, body_topology, batch, pending, running y skill_reference no |
inspect_design / measure / body_topology | Leer geometría y cronología.inspect_designTambién incluye la lista de las juntas de una asamblea (se apaga conjoints: false) |
set_parameter | Crear/cambiar parámetros y recomputar |
screenshot | PNG del modelo o ventana |
export | STEP, 3MF, STL, OBJ, URDF, ... |
open / save / new_design | Documentos del ciclo de vida |
undo / redo | Historia |
crash_reports | Listar los informes de accidente de este ordenador, o abrir uno por id (backtrace y comandos recientes) |
skill_reference | Lea un documento de habilidad combinado (solidcraft-modeling, solidcraft-mechanisms, solidcraft-editing, solidcraft-checking• Opcionalfile(El defectoreference.mdUsado por el agente de chat cuando las herramientas de archivo están apagadas (desde 0.21.0) |
running | Mostrar lo que la aplicación está ocupada con o ha dejado en cola para cada cliente conectado (sin parámetros); responde incluso mientras la aplicación está ocupada, por lo que compruebe después de un período de tiempo antes de reenviar un cambio (desde 0.18.3) |
pending | Modo de puente: después de que una larga solicitud de control devuelva "todavía en funcionamiento", espere hasta 60 s para ese resultado (done: falsemientras se corre;pending: nullcuando nada está esperando). sólo lectura, conrunning, skill_referenceycrash_reports |
Solicitudes de larga duración (bridged):el servidor puede bloquear hasta aproximadamente 300 s en una llamada de control lento; establezca el tiempo de espera del cliente MCP por encima de 330 s. Si una llamada se apaga o vuelve "todavía en funcionamiento", no reenvíe el mismo cambio - llamadapendingy/orunning(o elinspect_designEn primer lugar.
Verificación de parámetros (desde 0.17.0):Comandos con un contrato tipificado (hasta ahorasolid.box, solid.extrudeyengine.describe) pueden ser verificados cuando son llamados, ydescribe_commandInicia una sesión sin cabeza con--param-check off|warn|strict: offes el defecto y no cambia nada,warnejecuta la llamada, pero añade advertencias como una clave probablemente errónea, ystrictrechaza la llamada y deja el diseño intacto. Las llamadas redirigidas a una aplicación en ejecución aún no se controlan. Para ver a qué está unido un solo joint, ejecutejoint.inspecta travésexecuteLa fuente:docs/mcp.md en v0.17.0.
Las habilidades de los agentes opcionales viven bajoskills/en el repo (solidcraft-modeling, solidcraft-editingY así sucesivamente, el MCPskill_referencela herramienta (desde 0.21.0) devuelve esos documentos empacados sin necesidad de acceso al disco; los documentos también documentan lospendingherramienta (19 herramientas totales con undo/redo contadas por separado; sin cambios en 0.22.0).
Por defecto, las herramientas solo tocan:
--allow-path DIRY usted añade.solidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-pathElimina el límite (comportamiento anterior) – use con cuidado.
Flujo conceptual de la sesión de ejemplo del doc oficial:
batchun esbozo rectángulo → extrude → filete → corte un agujeromeasureVolumen / Áreascreenshotconview: "iso"exporta un camino dentro de una carpeta permitidaDemo de guión:ejemplos/demo/enclosure_mcp.pyConstruye un enclave sobre el MCP.
También se ve:Comparación de servidores CAD MCP · Guía de Instalación · Ejemplos.