Controlar FreeCAD desde Claude Desktop usando MCP

Hace poco me encontré con un proyecto interesante: una integración de FreeCAD y Claude Desktop mediante el Model Context Protocol. Estaba buscando una forma de bocetar rápidamente un modelo 3D simple o una pieza a partir de un dibujo sin tener que hacer clic manualmente a través de bocetos en la interfaz CAD. El repositorio neka-nat/freecad-mcp resuelve exactamente este problema. Describís la pieza con palabras o adjuntás una imagen con un dibujo, y el modelo de lenguaje construye la geometría directamente en la ventana abierta de FreeCAD.

Qué es

El proyecto es un servidor MCP que conecta FreeCAD con clientes como Claude Desktop. Todo el sistema consiste en dos partes: un plugin (Addon) para FreeCAD que lanza un servidor RPC local dentro del editor, y una utilidad Python que traduce comandos del protocolo MCP en llamadas a este servidor RPC.

Como resultado, el modelo ve la escena actual, puede crear objetos, ejecutar código Python arbitrario e incluso realizar cálculos de análisis estructural.

Cómo se ve en la práctica

El autor del repositorio demostró varios escenarios de uso práctico.

Modelado a partir de descripción

Pedís que se haga una brida o un auto de juguete con dimensiones especificadas. Claude crea bocetos, extruye caras y redondea esquinas mediante llamadas a herramientas.

Reconstruyendo una pieza 3D a partir de un dibujo 2D

Si soltás un dibujo técnico estándar con dimensiones en el chat, la red neuronal analiza las proyecciones, genera un boceto y construye un modelo 3D.

Después de analizar las dimensiones, Claude ensambla la pieza paso a paso en el editor:

Herramientas y capacidades disponibles

El repositorio le da al modelo de lenguaje acceso a una docena de funciones listas para usar:

• create_document, create_object, edit_object, delete_object para operaciones básicas de geometría
• execute_code para ejecutar código Python sin procesar dentro de la sesión de FreeCAD
• get_view para capturar una captura de pantalla de la vista actual desde un ángulo específico
• run_fem_analysis para ejecutar cálculos FEM a través del solver CalculiX con retorno de tensiones y deformaciones máximas de Von Mises

Un detalle interesante: cada herramienta puede devolver una captura de pantalla de la escena en vista isométrica u otra. Gracias a esto, el modelo verifica visualmente el resultado de cada paso. Si querés guardar contexto y tokens, la transmisión de imágenes se puede desactivar con el flag --only-text-feedback.

Instalación y configuración

Necesitás FreeCAD versión 1.0 o 1.1 y la utilidad uvx para comenzar.

Primero, copiá el addon a la carpeta mod de FreeCAD:

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp

# Для Ubuntu / Debian
mkdir -p ~/.FreeCAD/Mod/
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# Для macOS
mkdir -p ~/Library/Application\ Support/FreeCAD/v1-1/Mod/
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

Después de reiniciar FreeCAD, aparecerá "MCP Addon" en la lista de ambientes de trabajo.

Seleccionálo y hacé clic en "Start RPC Server" en la barra de herramientas. También podés habilitar el inicio automático del servidor cuando se inicie el programa desde ahí.

Luego registrá el servidor en el archivo de configuración claude_desktop_config.json:

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

Si FreeCAD se está ejecutando en una computadora separada en la red local, podés habilitar conexiones remotas con el flag --host <ip-адрес> y configurar la lista de IPs permitidas directamente en la interfaz del addon.

Impresiones

El proyecto es genial para ingenieros, makers con impresoras 3D y desarrolladores que escriben frecuentemente scripts de automatización para FreeCAD. En lugar de pasar mucho tiempo aprendiendo la API Python del editor, podés pedirle a Claude que escriba y aplique código inmediatamente a un documento. Por supuesto, para ensamblajes complejos con cientos de piezas, aún es necesario el control manual, pero para prototipado y trabajo con dibujos simples, la herramienta funciona muy bien.