Controlando FreeCAD via Claude Desktop Usando MCP

Recentemente encontrei um projeto interessante: uma integração do FreeCAD com o Claude Desktop via o Model Context Protocol. Estava procurando uma forma de criar rapidamente um modelo 3D simples ou uma peça a partir de um desenho sem precisar clicar manualmente através de esboços na interface do CAD. O repositório neka-nat/freecad-mcp resolve exatamente esse problema. Você descreve a peça em palavras ou anexa uma imagem com um desenho, e o modelo de linguagem constrói a geometria diretamente na janela aberta do FreeCAD.

O que é

O projeto é um servidor MCP que conecta o FreeCAD com clientes como o Claude Desktop. Todo o sistema é composto por duas partes: um plugin (Addon) para o FreeCAD que inicia um servidor RPC local dentro do editor, e um utilitário Python que traduz os comandos do protocolo MCP em chamadas para esse servidor RPC.

Como resultado, o modelo enxerga a cena atual, pode criar objetos, executar código Python arbitrário e até realizar cálculos de análise estrutural.

Como funciona na prática

O autor do repositório demonstrou vários cenários práticos de uso.

Modelagem a partir de descrição

Você pede para fazer um flange ou um carrinho de brinquedo com dimensões especificadas. O Claude cria esboços, extruda faces e arredonda cantos através de chamadas de ferramentas.

Reconstruindo uma peça 3D a partir de um desenho 2D

Se você soltar um desenho técnico padrão com dimensões no chat, a rede neural analisa as projeções, gera um esboço e constrói um modelo 3D.

Após analisar as dimensões, o Claude monta a peça passo a passo no editor:

Ferramentas e capacidades disponíveis

O repositório dá ao modelo de linguagem acesso a uma dúzia de funções prontas:

• create_document, create_object, edit_object, delete_object para operações básicas de geometria
• execute_code para executar código Python bruto dentro da sessão do FreeCAD
• get_view para capturar uma captura de tela da viewport atual a partir de um ângulo específico
• run_fem_analysis para executar cálculos FEM através do solver CalculiX com retorno da tensão máxima de Von Mises e deformações

Um detalhe interessante: cada ferramenta pode retornar uma captura de tela da cena em vista isométrica ou outra. Graças a isso, o modelo verifica visualmente o resultado de cada etapa. Se você quiser economizar contexto e tokens, a transmissão de imagens pode ser desabilitada com a flag --only-text-feedback.

Instalação e configuração

Você vai precisar do FreeCAD versão 1.0 ou 1.1 e do utilitário uvx para começar.

Primeiro, copie o addon para a pasta mod do 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/

Após reiniciar o FreeCAD, "MCP Addon" aparecerá na lista de workbenches.

Selecione-o e clique em "Start RPC Server" na barra de ferramentas. Você também pode habilitar a inicialização automática do servidor quando o programa for iniciado a partir daí.

Depois registre o servidor no arquivo de configuração claude_desktop_config.json:

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

Se o FreeCAD estiver sendo executado em um computador separado na rede local, você pode habilitar conexões remotas com a flag --host <ip-адрес> e configurar a lista de IPs permitidos diretamente na interface do addon.

Impressões

O projeto é ótimo para engenheiros, makers com impressoras 3D e desenvolvedores que frequentemente escrevem scripts de automação para o FreeCAD. Em vez de gastar muito tempo aprendendo a API Python do editor, você pode pedir ao Claude para escrever e aplicar imediatamente o código em um documento. Claro, para montagens complexas com centenas de peças, o controle manual ainda é necessário, mas para prototipagem e trabalho com desenhos simples, a ferramenta funciona muito bem.