FreeCAD MCP conecta Claude Desktop con FreeCAD, el software de CAD paramétrico open source. El repositorio neka-nat/freecad-mcp permite crear documentos, crear y editar objetos, borrar objetos, ejecutar código Python en FreeCAD, insertar piezas desde la biblioteca FreeCAD, recuperar vistas, listar objetos y lanzar un análisis FEM mediante CalculiX. Es uno de los conectores CAD más adoptados de esta selección, con 1902 estrellas y 256 forks en la verificación GitHub del 26 de agosto de 2026.
Para un estudio de arquitectura, FreeCAD MCP no tiene el mismo papel que Revit MCP o Archicad MCP. FreeCAD no es la herramienta BIM principal de la mayoría de estudios franceses, pero puede ser útil para prototipar una pieza, explicar el modelado paramétrico, generar una geometría simple o probar una automatización open source sin licencia comercial. El conector interesa sobre todo como laboratorio CAD controlado por IA.
Sumario
- Qué hace FreeCAD MCP
- Instalación y arquitectura
- Capacidades útiles
- Comparación con MCP BIM y CAD
- Seguridad, remote y límites
- Posición de Educasium
- Fuentes y siguiente lectura
Qué hace FreeCAD MCP
En síntesis: FreeCAD MCP da a Claude una interfaz de acción sobre FreeCAD, con creación de objetos, edición, captura de vista, biblioteca de piezas y ejecución Python. Su fuerza es la flexibilidad open source; su límite es el nivel técnico requerido.
Herramientas expuestas
El README lista create_document, create_object, edit_object, delete_object, execute_code, insert_part_from_library, get_view, get_objects, get_object, get_parts_list, get_rpc_status y run_fem_analysis. Las herramientas que devuelven capturas aceptan include_screenshot y view_name para suprimir u orientar la imagen. El modo only_text_feedback puede desactivar globalmente las capturas para ahorrar tokens.
Esta superficie es más amplia que un simple generador de formas. El asistente puede inspeccionar el documento, modificar un objeto existente, insertar una pieza desde la biblioteca oficial FreeCAD-library o lanzar un análisis FEM sobre un FemAnalysis existente. Para una formación, es un buen soporte para mostrar la diferencia entre objeto paramétrico, captura de vista y script Python.
Python en FreeCAD
La herramienta execute_code es el punto más potente. Permite ejecutar Python en FreeCAD, lo que abre casi todo el perímetro de la API FreeCAD. Es exactamente lo que hace útil el conector para workflows avanzados, pero también lo que exige disciplina de prueba.
Una instrucción mal acotada puede crear objetos rotos, bloquear el hilo GUI o modificar un documento de forma difícil de revisar. El README señala que después de una excepción execute_code en un build de desarrollo de FreeCAD, hay que inspeccionar los nuevos objetos FeaturePython antes de modificarlos o borrarlos, porque un objeto sin Proxy requerido puede bloquear el hilo GUI.
Instalación y arquitectura
En síntesis: FreeCAD MCP combina un add-on FreeCAD local y un servidor MCP lanzado con uvx o uv. No basta con añadir una línea en Claude Desktop.
Add-on FreeCAD
El README da las carpetas de add-on para Windows, macOS y varias distribuciones Linux. La instalación consiste en copiar addon/FreeCADMCP en la carpeta Mod de FreeCAD y reiniciar FreeCAD. El usuario selecciona después el workbench MCP Addon y lanza el servidor RPC desde la barra FreeCAD MCP.
El servidor RPC también puede arrancar automáticamente si se activa Auto-Start Server en el menú FreeCAD MCP. El ajuste se guarda en freecad_mcp_settings.json y persiste entre sesiones. Este detalle es útil para un puesto recurrente, pero en fase piloto es mejor mantener el arranque manual para saber cuándo la herramienta está activa.
Servidor MCP y prerrequisitos Python
La configuración de Claude Desktop usa uvx con el argumento freecad-mcp. El pyproject verificado indica un paquete freecad-mcp en versión 0.1.22, bajo licencia MIT, con Python 3.12 o superior y dependencias mcp y validators. Para un desarrollador, el README también propone un lanzamiento con uv desde un clone local del repositorio.
Este funcionamiento es más simple que los conectores que exigen Visual Studio o DLL Civil 3D, pero sigue siendo técnico. Hay que instalar el add-on en el lugar correcto, lanzar o auto-lanzar el RPC del lado de FreeCAD, y configurar el cliente MCP del lado de Claude. Un error en cualquiera de estos tres niveles basta para romper la conexión.
Capacidades útiles
En síntesis: FreeCAD MCP es pertinente para prototipar, enseñar y automatizar objetos paramétricos simples. No sustituye un workflow BIM de estudio.
Modelado y biblioteca de piezas
Las herramientas create_object, edit_object y delete_object cubren la manipulación directa de objetos FreeCAD. insert_part_from_library y get_parts_list añaden un enlace con FreeCAD-library, lo que permite insertar piezas existentes en lugar de reconstruir todo. Para un taller pedagógico, facilita las demostraciones: crear un documento, añadir un volumen, modificar sus parámetros, insertar una pieza y capturar la vista.
En un estudio, este perímetro puede servir para explorar detalles, objetos, ensamblajes simples o variantes de geometría. No está diseñado como sustituto de un modelo Revit, Archicad o Rhino completo. Su valor viene sobre todo de la apertura: FreeCAD y Python permiten entender qué hace realmente la automatización.
FEM y CalculiX
run_fem_analysis lanza el solver CalculiX sobre un FemAnalysis existente y devuelve resultados de síntesis: tensión von Mises máxima, desplazamiento máximo, número de nodos y carpeta de trabajo. El README precisa que auto-crea un SolverCcxTools si el análisis no tiene ninguno, y remite a un ejemplo cantilever_fem.py.
Esta capacidad es interesante pero no debe sobrevenderse. Puede ayudar a demostrar una cadena de cálculo o probar una pieza simple, pero no sustituye un estudio estructural cualificado. Cualquier resultado FEM debe quedar bajo control de un ingeniero competente, sobre todo si una decisión de diseño depende de él.
Comparación con MCP BIM y CAD
En síntesis: FreeCAD MCP es el más abierto y experimental de los conectores CAD de esta serie. Es menos métier que un MCP Revit, pero más accesible para explorar CAD programable.
| Opción | Uso natural | Principal fortaleza | Límite a vigilar |
|---|---|---|---|
| FreeCAD MCP | Prototipar y automatizar FreeCAD | Open source, Python, objetos paramétricos, capturas | execute_code y madurez workflow estudio |
| Revit MCP | Actuar sobre una maqueta BIM edificio | Herramientas BIM listas para usar | Dependencia a Revit y gobernanza de escritura |
| AutoCAD MCP | Automatizar AutoCAD LT y DXF | Backends AutoCAD y ezdxf | Centrado en DWG/DXF, menos paramétrico |
FreeCAD MCP frente a Revit y Archicad
El MCP de Revit y el MCP de Archicad apuntan a softwares BIM usados directamente en producción de estudio. FreeCAD MCP apunta a un software open source más transversal. Eso lo hace menos inmediatamente compatible con entregables corrientes de estudio, pero más interesante para aprender la lógica de automatización.
Un estudio Revit o Archicad no debería migrar de workflow por FreeCAD MCP. En cambio, puede usarlo como entorno de prueba para entender cómo un asistente crea, modifica e inspecciona objetos CAD sin exponer una maqueta cliente.
FreeCAD MCP frente a AutoCAD MCP
El MCP AutoCAD está más orientado a dibujo, capas, bloques, anotaciones y DXF. FreeCAD MCP está más orientado a objetos paramétricos, scripts Python, capturas y simulación simple. Por tanto, no tienen el mismo uso.
Si el objetivo es producir o modificar un plano DWG/DXF, AutoCAD MCP es más natural. Si el objetivo es explorar geometría paramétrica open source o mostrar cómo Python controla un CAD, FreeCAD MCP es más pedagógico.
Seguridad, remote y límites
En síntesis: FreeCAD MCP arranca localmente por defecto, pero puede aceptar conexiones de red si el usuario lo activa. Esta opción debe tratarse con prudencia.
Conexiones locales y remote
Por defecto, el servidor RPC no acepta conexiones remotas y escucha localhost. El README documenta una opción Remote Connections que bind el servidor en 0.0.0.0 al reiniciar, con una lista de IP o subredes autorizadas. 127.0.0.1 sigue siendo el valor por defecto y las entradas inválidas se rechazan.
Para un estudio, la regla debe ser simple: permanecer en localhost durante las pruebas. Las conexiones remotas solo deben activarse si la necesidad es clara, con red controlada, allowlist limitada y validación IT. Un servidor capaz de ejecutar Python en FreeCAD no debe exponerse ampliamente.
GUI dispatch y objetos rotos
El README señala que si una operación GUI supera su timeout después de haber arrancado, el bridge devuelve GUI_DISPATCH_STUCK y rechaza las operaciones GUI siguientes. get_rpc_status sirve entonces para identificar la operación aún en curso. FreeCAD no puede cancelar sin riesgo un trabajo GUI bloqueado; si el estado no vuelve a healthy después de terminar la operación, hay que reiniciar FreeCAD.
Este límite es importante en producción. Significa que un mal script no siempre se corrige con un simple retry. Hay que guardar, probar en documento separado y evitar encadenar operaciones pesadas sin control intermedio.
Posición de Educasium
En síntesis: Educasium puede usar FreeCAD MCP como entorno de aprendizaje, pero no debe presentarlo como una herramienta ya validada en un estudio cliente.
Experiencia disponible
Educasium todavía no ha desplegado FreeCAD MCP en un estudio cliente ni medido un ahorro de tiempo verificado sobre un flujo CAD real. Esta página se apoya en el README, pyproject, ejemplos y metadatos GitHub verificados. Describe una capacidad open source, no un caso de estudio.
El interés pedagógico es fuerte. FreeCAD MCP permite mostrar la relación entre prompt, objeto paramétrico, captura, código Python y resultado. También se adapta a talleres donde se quiere evitar una licencia propietaria o una maqueta confidencial.
Hypothetical implementation
Hypothetical implementation. Para un piloto Educasium, la primera etapa sería instalar el add-on FreeCADMCP, lanzar el RPC manualmente y conectar Claude Desktop con uvx. Las primeras pruebas deberían limitarse a create_document, create_object, get_objects, get_view y edit_object con include_screenshot activado, para verificar visualmente cada paso.
execute_code y run_fem_analysis vendrían más tarde, sobre documentos test y scripts cortos. Las conexiones remotas permanecerían desactivadas. El criterio de éxito sería una secuencia reproducible: crear un objeto simple, modificar un parámetro, capturar una vista y explicar lo que hizo el código.
Fuentes y siguiente lectura
En síntesis: la información de esta página viene del repositorio GitHub y fue verificada el 26 de agosto de 2026. Las versiones, herramientas, parámetros de captura, remote connections y prerrequisitos Python vienen del README y del pyproject.
Qué leer después
Para workflows BIM edificio, compare FreeCAD MCP con el MCP de Revit y el MCP de Archicad. Para flujos CAD 2D, lea también AutoCAD MCP y CAD-MCP.
Para construir una estrategia de adopción más amplia, consulte el comparativo de software IA para arquitectos y la formación Dominar la IA en arquitectura.