FreeCAD MCP

Este repositorio es un MCP de FreeCAD que te permite controlar FreeCAD desde Claude Desktop.

Demo

Diseñar una brida

Diseñar un coche de juguete

Diseñar una pieza a partir de un dibujo 2D

Dibujo 2D de entrada

Demo

Este es el historial de la conversación. https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

Related MCP server: FreeCAD MCP

Instalar complemento

El directorio de complementos de FreeCAD es

• Windows: %APPDATA%\FreeCAD\Mod\

• Mac:

  • FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

  • FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/Mod/

• Linux:

  • Ubuntu: ~/.FreeCAD/Mod/ o ~/snap/freecad/common/Mod/ (si instalas FreeCAD desde snap)

  • Debian: ~/.local/share/FreeCAD/Mod

Por favor, coloca el directorio addon/FreeCADMCP en el directorio de complementos.

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

# For Linux (Ubuntu/Debian)
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# For macOS (FreeCAD 1.1)
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

Cuando instales el complemento, debes reiniciar FreeCAD. Puedes seleccionar "MCP Addon" de la lista de entornos de trabajo (Workbench) y usarlo.

Y puedes iniciar el servidor RPC mediante el comando "Start RPC Server" en la barra de herramientas "FreeCAD MCP".

Inicio automático del servidor RPC

De forma predeterminada, el servidor RPC debe iniciarse manualmente cada vez que se abre FreeCAD. Para iniciarlo automáticamente:

1. Abre el menú FreeCAD MCP (cambia primero al entorno de trabajo MCP Addon)

2. Marca Auto-Start Server

La configuración se guarda en freecad_mcp_settings.json y persiste entre sesiones. En el siguiente inicio de FreeCAD, el servidor RPC se iniciará automáticamente una vez que la aplicación termine de cargarse.

Puedes desactivarlo en cualquier momento desmarcando Auto-Start Server en el mismo menú.

Configuración de Claude Desktop

Se requiere la preinstalación de uvx.

Y necesitas editar el archivo de configuración de Claude Desktop, claude_desktop_config.json.

Para el usuario.

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

Si deseas ahorrar tokens, puedes establecer only_text_feedback en true y usar solo comentarios de texto.

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

Para desarrolladores. Primero, necesitas clonar este repositorio.

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

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}

Conexiones remotas

De forma predeterminada, el servidor RPC no acepta conexiones remotas y escucha en localhost. Para controlar FreeCAD desde otra máquina en tu red:

1. Habilitar conexiones remotas en FreeCAD

En la barra de herramientas FreeCAD MCP:

1. Marca Remote Connections: el servidor RPC se vinculará a 0.0.0.0 (todas las interfaces) en el próximo reinicio. Por razones de seguridad, solo acepta conexiones de las direcciones IP o subredes CIDR especificadas en el campo Allowed IPs. De forma predeterminada, es 127.0.0.1.

2. Haz clic en Configure Allowed IPs e ingresa una lista separada por comas de direcciones IP o subredes CIDR a las que se les permite conectarse, por ejemplo:

   192.168.1.100, 10.0.0.0/24

   127.0.0.1 es siempre el valor predeterminado. Las entradas no válidas se rechazan con un cuadro de diálogo de error. Reinicia el servidor RPC después de cambiar esta configuración.

2. Apuntar el servidor MCP al host remoto

Pasa la bandera --host con la dirección IP o el nombre de host de la máquina que ejecuta FreeCAD:

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

El valor de --host se valida al inicio: debe ser una dirección IPv4/IPv6 o un nombre de host válido.

Herramientas

• create_document: Crea un nuevo documento en FreeCAD.

• create_object: Crea un nuevo objeto en FreeCAD.

• edit_object: Edita un objeto en FreeCAD.

• delete_object: Elimina un objeto en FreeCAD.

• execute_code: Ejecuta código Python arbitrario en FreeCAD.

• insert_part_from_library: Inserta una pieza de la biblioteca de piezas.

• get_view: Obtiene una captura de pantalla de la vista activa.

• get_objects: Obtiene todos los objetos en un documento.

• get_object: Obtiene un objeto en un documento.

• get_parts_list: Obtiene la lista de piezas en la biblioteca de piezas.

Colaboradores

Hecho con contrib.rocks.