SolidCraft: CAD open source en Rust con MCP nativo para agentes
TL;DR
- Verificado (API GitHub, 18-oct-2026 ~21:30 UTC): SolidCraft se describe a sí mismo como “an open-source parametric 3D CAD application built in pure Rust”. Repo creado el 7-oct-2026: 5.504 estrellas, 650 forks, 1.098 issues abiertas, 1.525 commits y dos releases el mismo día de esta verificación (v0.16.0 a las 19:52 UTC y v0.16.1 a las 21:27). Licencia MIT OR Apache-2.0 y mudanza reciente a la org tangency-labs.
- Verificado (docs/mcp.md): lleva servidor MCP nativo sobre stdio (JSON-RPC 2.0) con 15 tools. Lo interesante no es el número, sino esta frase del propio doc: cada tool ejecuta los comandos del engine, “the same ones the toolbar, palette, scripts and control channel use”, y “never opens a dialog”. Sin GUI automation: el agente es un cliente más, de primera clase.
- Verificado (docs/mcp.md): el sandbox de ficheros viene cerrado por defecto: solo la carpeta del diseño abierto (dentro de tu home, sin ocultas), la carpeta de recovery y un scratch privado. El propio home, los dotfiles (
.env,.gitfuera de alcance literal),..y los symlinks que escapan se resuelven y se rechazan;--allow-pathabre solo lo que pidas. - Verificado con letra pequeña (repo del rover): el rover SELENE, “built entirely through SolidCraft’s native MCP commands”, tiene 3.324 history entries en el modelo aprobado v7. El claim de “3,323 editable timeline steps” que repite el README principal corresponde a la variante grabada del timelapse (son dos fixtures distintos, y el propio repo pide no mezclarlos). El vídeo es “an accelerated construction sequence, not a real-time performance measurement” y el conjunto es “not a manufacturing-certified or space-qualified design”.
- Estado declarado: “early but usable for simple parts”, con un oracle geométrico que en la versión consultada de docs/oracle.md valida 83 de 83 casos de referencia contra volumen, área, centro de masa y bounding box analíticos o de FreeCAD, sin fallos con seguimiento (el README aún dice “75 of 76”) — junto a la advertencia del propio proyecto: “These checks do not establish complete geometric or workflow equivalence”. Más honestidad que en la mayoría de demos de “CAD con IA”.
Un CAD de escritorio donde el agente no es un parche
La mayoría de integraciones de agentes con aplicaciones de escritorio son automatización disfrazada: capturas de pantalla, clicks sintéticos, esperas a que el diálogo termine de pintarse. SolidCraft, un CAD paramétrico open source escrito en Rust con servidor MCP incluido, toma el camino contrario: el agente habla directamente con el engine usando exactamente los mismos comandos que la interfaz. Es la misma idea del protocolo que ya cubrimos en el tutorial de MCP con APIs REST, pero aplicada a un tool de escritorio, no a una API web.
Y hay una prueba de carga que no es un render de marketing: un rover científico construido enteramente vía MCP, con miles de entradas de timeline editables cuya evaluación, según su repo, no reporta errores en las poses guardadas. Con matices importantes que su propio autor documenta, y que conviene leer antes de citar la cifra de turno.
Qué es SolidCraft (y su ritmo, que también cuenta una historia)
SolidCraft es CAD paramétrico clásico: bocetos con restricciones resueltas por un solver propio, timeline de features (extrude, revolve, sweep, fillet, shell, patrones, sheet metal), ensamblajes con juntas y parámetros con expresiones conscientes de unidades (2 * width + 5 mm). Corre en Windows, macOS y Linux (MSI, DMG, AppImage, deb, rpm, snap), hay app web autohosteable con Docker, y también en el navegador sin instalar nada.
El ritmo de estos once primeros días es borderline entre admirable e inquietante, según el día:
| Métrica | Valor verificado (18-oct-2026, API GitHub) |
|---|---|
| Creación del repo | 2026-10-07 |
| Estrellas / forks | 5.504 / 650 |
| Issues abiertas | 1.098 |
| Commits | 1.525 |
| Releases en las últimas 24 h | 2 estables (v0.16.0 y v0.16.1), sin contar nightlies |
Entre la señal de research (4.434 estrellas) y esta verificación pasaron horas, no semanas, y las estrellas subieron un 24%. En ese mismo día el proyecto publicó dos releases: la v0.16.0 añade “agent chat” con ventana pop-out y adjuntos, boundary surfaces, temas de color, italiano y polaco nuevos, y —detalle que a los lectores de esta casa nos toca— “Spanish (Spain)” entre los idiomas. La v0.16.1, hora y media después, es un patch de navegación.
Dos letras pequeñas de esa misma release, porque dicen mucho de un proyecto 0.x: los diseños guardados con 0.16.0 usan el formato de fichero 27 y no abren en 0.15.x o anterior; y el chequeo de actualización in-app de ≤0.14 no siguió la mudanza del repo a tangency-labs (hay que descargar a mano; winget sigue siendo bherbruck.SolidCraft, el nombre del autor original). El movimiento es real, el ecosistema se está reorganizando en vivo, y eso también se nota en la documentación, donde aún quedan referencias al repo antiguo.
El servidor MCP: los mismos comandos que la UI
El doc oficial abre con la definición de diseño que deberían copiar otros proyectos: el agente modela “exactly like a person does” — cada tool ejecuta comandos del engine, los mismos que usan la toolbar, la paleta, los scripts y el canal de control, y nunca abre un diálogo. Nada de arrastrar un ratón virtual.
Arranque en dos modos:
# Headless: sesión de diseño en proceso, sin ventana
solidcraft-cli mcp
# Puente a la app abierta, para ver al agente modelar en vivo
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
Para Claude Code, la configuración es la de cualquier servidor stdio: claude mcp add solidcraft -- solidcraft-cli mcp.
Las 15 tools cubren el ciclo completo: list_commands (el catálogo con parámetros y atajos), execute y batch (ejecutar comandos en orden, con rollback al primer error), inspect_design, measure y body_topology (lectura: propiedades, volúmenes, topología), set_parameter (crear o cambiar un parámetro y recomputar), screenshot (PNG del modelo o de la ventana), export (STEP, 3MF, STL, OBJ, URDF), crash_reports, new_design, open, save, undo y redo. Y traen anotaciones MCP de verdad: cinco son read-only declaradas, set_parameter/undo/redo se marcan como cambios deshacibles, new_design como destructivo, y las que tocan ficheros declaran destructiveHint y openWorldHint. Un cliente puede auto-aprobar lecturas y pedir confirmación en escrituras sin adivinar.
Tres detalles de ingeniería que valen más que la lista de tools:
batchcon rollback exacto. Los pasos corren en orden, se para en el primer error y se deshace todo hasta un checkpoint del engine — diseño, boceto activo e historial de undo restaurados tal cual estaban. Un agente puede ensayar una secuencia de 20 comandos y fallar sin dejar el modelo a medias.- Errores que el modelo puede leer y corregir. Un fallo del engine no es una excepción opaca: es un resultado
isErrorcon el mensaje del engine, y los fallos de esquema son errores JSON-RPC-32602estándar. El loop de corrección queda dentro del protocolo. - Respuestas compactas opcionales.
verbose: falserecorta las respuestas de features largas conservando los cuerpos creados/cambiados/eliminados — control de contexto de sesión en diseños grandes, que es donde se muere la mayoría de agentes con tools.
Además del stdio hay render jobs asíncronos (render.start, render.status, render.export) y cuatro Agent Skills oficiales (solidcraft-modeling, solidcraft-editing, solidcraft-checking, solidcraft-mechanisms) que documentan el workflow, las formas de los comandos, cómo verificar con measure y las trampas conocidas. Que una app publique y mantenga su propia documentación de agente — “an agent builds a part in a few batch calls and reads far less output”, dice el doc — es una apuesta interesante: la herramienta enseña su manejo al operador no humano.
El sandbox: cerrado por defecto, y se nota que lo han pensado
Un servidor MCP que lee, escribe y borra ficheros es exactamente el tipo de superficie donde ya ha habido sustos graves — recordemos la vulnerabilidad crítica en el framework de MCP que usaba vLLM y miles de servidores. Por eso el apartado de sandbox de docs/mcp.md es la parte que más recomiendo leer entera.
Las reglas, verificadas verbatim contra el doc:
- Las tools solo tocan ficheros dentro de: la carpeta del diseño abierto (solo si está estrictamente dentro de tu home o del temporal, y no en una carpeta oculta), la carpeta de recovery de SolidCraft, y el scratch privado del servidor.
- El home en sí, sus carpetas padre (
/,/home,/Users, raíz de disco), las carpetas ocultas y “carpetas en cualquier otro sitio” no cuentan. Traducción literal del doc:.envy.gitquedan fuera de alcance.~/.ssh,~/.awso.bashrcnunca están al alcance por defecto, ni siquiera arrancando el servidor desde ahí. - Las rutas se resuelven antes de compararse:
..y symlinks que llevan fuera se rechazan (guardar a través de un link cuenta como escribir en su destino). - En Windows, además, se rechazan antes de llamar al sistema de ficheros: rutas UNC y de dispositivo, alternate data streams (
archivo.txt:stream), nombres reservados (NUL,CON,COM1.txt) y nombres cortos 8.3 (PROGRA~1). --allow-path DIRabre una carpeta concreta (con sus ocultos), repetible;--allow-any-pathexiste pero es el comportamiento antiguo sin límites, y el doc lo presenta como escape, no como opción por defecto.- Hasta la letra pequeña honesta está: un hard link dentro de una carpeta permitida es indistinguible de un fichero normal, así que un hard link a algo de fuera queda alcanzable — “no guardes ese tipo de links en una carpeta que permitas”.
Esto es lo que distingue un servidor MCP de producto de un wrapper de fin de semana: la lista de carpetas se anuncia en stderr al arrancar, y una ruta rechazada es un error de tool que explica por qué.
El rover SELENE: 3.324 pasos construidos vía MCP (con letra pequeña)
El caso estrella es SELENE, un rover científico de seis ruedas con suspensión visible, brazo de muestreo articulado, torreta de cámaras, paneles solares desplegables y antena orientable, creado por 0xlillith el 13-oct-2026 y publicado como release v1.0.0 (modelo y medios bajo MIT OR Apache-2.0; Apache-2.0 según el detector de GitHub). El claim de portada: “built entirely through SolidCraft’s native MCP commands”.
Las cifras del modelo aprobado (v7), verificadas contra el README del rover:
| Métrica | Modelo aprobado v7 |
|---|---|
| Cuerpos sólidos | 1.395 |
| Bocetos / curvas de boceto | 576 / 3.792 |
| Definiciones de componente | 36 + ensamblaje raíz |
| Juntas revolute | 17 |
| History entries | 3.324 (1.395 de ellos, body-transfer) |
| Triángulos de display (probe CLI 0.7.0) | 1.025.680 |
| Tamaño del fichero nativo | 216.036 bytes |
El history desglosado: 545 extrusiones, 498 cilindros, 254 cajas, 15 sweeps, 12 fillets, 6 coils, 6 patrones circulares, 2 shells, 1 revolve y 14 moves. El resultado no es un mesh sin historial: cada operación es un comando de CAD en el timeline, operado por un agente con dirección de diseño humana — la procedencia declarada del repo es “design direction and iteration by 0xlillith and AI-assisted modelling/automation”, siempre sobre SolidCraft 0.7.0 vía MCP.
Ahora la parte que hace útil esta pieza: contrastar el claim repetido con la fuente primaria.
| Claim repetido | Qué dice la fuente primaria | Veredicto |
|---|---|---|
| ”3,323 editable timeline steps” (README principal de SolidCraft) | El modelo aprobado v7 tiene 3.324 entries; la variante grabada del timelapse tiene 3.323 y 13 moves (el placement final de la suspensión se construye directo, sin move correctivo). El propio repo pide: “Keep these fixtures distinct when comparing measurements” | Verificado con matiz: la cifra famosa es la del fixture grabado |
| ”Rebuild with no errors" | "Feature evaluation and joint inspection reported no errors/conflicts for the saved poses; this does not validate every possible articulated pose” | Verificado con letra pequeña explícita |
| El vídeo de construcción | 379 capturas de un build MCP fresco, con timing editado: “an accelerated construction sequence, not a real-time performance measurement”; el README principal de SolidCraft dice que el embed se reproduce “at 2× speed” | No es una medición de rendimiento |
| ”Rover científico" | "an illustrative assembly with credible mounting details, not a manufacturing-certified or space-qualified design”; la Raspberry Pi 5 y las baterías son geometría simplificada | Ilustrativo, no ingeniería aeroespacial |
| Creado y validado con SolidCraft | La versión usada es la 0.7.0, no la 0.16 actual | Verificado; el repo del rover lo declara y pide abrir el modelo con esa versión |
Otra pata que casi nadie menciona: el repo del rover se publica también como workload público de rendimiento, con propuesta de benchmark y protocolo de reproducción — útil para separar decodificación del fichero, evaluación de geometría, colocación de componentes, meshing e interacción con el viewport. El propio README avisa que “complements small synthetic fixtures; it is not representative of every CAD design”. Un fichero de 216 KB que dispara 3.324 evaluaciones al abrir es, en efecto, un buen estresor.
El estado real del proyecto: “early but usable for simple parts”
El README declara el estado sin maquillaje: “Status: early but usable for simple parts.” Y lo respalda con algo mejor que una demo: un oracle geométrico que en la versión consultada valida 83 de 83 casos de referencia contra volumen, área, centro de masa y bounding box calculados analíticamente o con FreeCAD (el README sigue diciendo “75 of 76 … the other is a tracked bug”; los dos ficheros iban desincronizados a fecha de esta pieza). Con esta advertencia del propio proyecto: “These checks do not establish complete geometric or workflow equivalence”.
Mi lectura: esto es lo contrario del marketing habitual de “CAD con IA”, donde un modelo genera geometría y nadie puede auditar cómo. Aquí la IA no genera nada — opera una herramienta cuyos resultados se pueden contrastar contra matemáticas de bachillerato y FreeCAD. El suelo no es el modelo de lenguaje; es el kernel. Y lo están midiendo en público. El mismo 0xlillith aparece, por cierto, en los créditos de contribuidores de la v0.16.0: el ciclo comunidad → caso real → release está funcionando a la vista de todos.
Dicho esto, 1.098 issues abiertas y un formato de fichero que se rompe entre minor releases son el precio de ir a esta velocidad. No es un producto maduro; es un producto en construcción acelerada con buenas virtudes de ingeniería.
Qué implica para MCP fuera del chat
- Superficie de comandos compartida UI/agent como principio de diseño. Si el agente usa los mismos comandos que la UI, todo lo que la app sabe hacer es automatizable, y lo que el agente hace es auditable en el timeline. Sin capa de automatización frágil que mantener aparte. Es la diferencia entre “integrar IA” y “tener dos clientes del mismo engine”.
- Defaults que fallan ruidoso. Sandbox cerrado por defecto, rutas rechazadas que explican el motivo, batch que revierte exacto al primer fallo, errores del engine legibles por el modelo. El patrón para tools agénticas no es “permite todo y confía”, es “rechaza con información suficiente para corregir”.
- Anotaciones de tools serias. Read-only, undoable, destructivo, openWorld declarados por tool. Cualquier cliente MCP puede construir su política de aprobación sin documentación adicional.
- La app enseña su manejo. Skills oficiales para el agente, con workflow y trampas conocidas. Si esta idea cuaja, parte de la documentación de producto será prompt-facing, no humano-facing.
- El agente como feature de UI, no como bot externo. El “agent chat” con pop-out y adjuntos de la 0.16.0 apunta a un producto donde el agente vive dentro de la herramienta — mismo engine, mismo sandbox, mismas skills.
Si quieres montar el conductor (cliente MCP + herramientas locales) para probar algo así, empezaría por el pillar de agentes con MCP y herramientas locales.
Cómo probarlo
# Windows: winget install bherbruck.SolidCraft
# macOS/Linux: DMG, AppImage, deb, rpm o snap desde releases
# y el servidor MCP para tu cliente:
claude mcp add solidcraft -- solidcraft-cli mcp
Si quieres ver al agente modelar en la app abierta, usa el modo puente (solidcraft --control 7878 + solidcraft-cli mcp --connect 127.0.0.1:7878). Las skills de agente se instalan copiando las carpetas a ~/.claude/skills/. Y si quieres cargar un diseño grande a propósito, el modelo del rover v7 está descargable con su history nativo.
Cuándo gana y cuándo no
| Caso | ¿Hoy? | Por qué |
|---|---|---|
| Piezas simples paramétricas (cajas, tapas, soportes, carcasas) | ✅ | Es el uso declarado (“simple parts”) y lo que muestra el demo: una caja para Raspberry Pi 4 con soportes M2.5 sobre el rectángulo de agujeros de 58 × 49 mm, altura 24 → 32 mm en Parameters y rebuild completo |
| Variantes en serie (20 tamaños de lo mismo) | ✅ | Parámetros + batch con rollback es exactamente el caso fuerte de un agente sobre timeline paramétrico |
| Inspección de ficheros (STEP) con preguntas de topología | ✅ | open importa STEP y las tools de lectura responden volúmenes, distancias y topología sin GUI |
| Superficies complejas / trabajo orgánico | ❌ | El kernel es joven; el oracle cubre primitivas y piezas de referencia, no estética de superficies libre |
| Piezas de producción o con requisitos de certificación | ❌ | Ni el proyecto ni el rover lo pretenden; “not a manufacturing-certified or space-qualified design” aplica a todo lo que salga de aquí hoy |
| Sustituir Fusion/Onshape/FreeCAD en tu cadena actual | ❌ | 11 días de repo y formato de fichero que se rompe entre minors; como herramienta complementaria, sí; como sustituto, no |
Conclusión
SolidCraft es interesante menos por ser “otro CAD open source” y más por ser el ejemplo más limpio que he verificado de una herramienta de escritorio diseñada con el agente como cliente de primera clase: mismos comandos que la UI, sandbox cerrado por defecto, anotaciones serias y hasta skills para enseñarle el oficio. El rover SELENE muestra que esa superficie aguanta una carga real de miles de operaciones editables — y su propio repo demuestra cómo se matiza un claim sin destrozarlo: cifra exacta, fixture exacto, letra pequeña exacta.
Lo que no es todavía: un kernel CAD contrastado contra años de producción. El oracle 83/83 (el README aún arrastraba un “75 of 76” al verificarlo) es exactamente lo que quiero ver en un proyecto así, y también es solo el principio de lo que habría que validar para confiar en geometría de verdad. Si tocas CAD y agentes, pruébalo como laboratorio, no como sustituto — y mira docs/mcp.md aunque SolidCraft no te interese: es una clase de cómo diseñar un servidor MCP de producto.
Qué he verificado (y qué no)
Verificado por mí el 18-oct-2026 (~21:30 UTC): API GitHub de ambos repos (creación, stars, forks, issues, licencia), releases/latest y release v0.16.0 cruda, número de commits vía header Link, READMEs crudos de SolidCraft y del rover, docs/mcp.md crudo completo, y el estado del oracle en docs/oracle.md. La cifra “3,324 history entries” del v7 está contrastada literalmente contra el README del rover; el “3,323” contra el README principal.
No verificado en primera mano: no he compilado ni instalado la app, no he levantado el servidor MCP ni reproducido el rover — la procedencia del rover es la declarada por su repo, no algo que haya repetido yo. El repo se mueve rápido: estas cifras tendrán días cortos de vida.
Fuentes: repo SolidCraft · docs/mcp.md · docs/oracle.md · release v0.16.0 · repo solidcraft-rover (SELENE) · release v1.0.0 del rover