FreeCAD aansturen via Claude Desktop met MCP

Onlangs stuitte ik op een interessant project: een FreeCAD en Claude Desktop integratie via het Model Context Protocol. Ik zocht naar een manier om snel een eenvoudig 3D-model of onderdeel te schetsen vanuit een tekening zonder handmatig door schetsen in de CAD-interface te klikken. De neka-nat/freecad-mcp repository lost dit probleem precies op. Je beschrijft het onderdeel in woorden of voegt een afbeelding met een tekening toe, en het taalmodel bouwt de geometrie direct in het geopende FreeCAD-venster.

Wat het is

Het project is een MCP-server die FreeCAD verbindt met clients zoals Claude Desktop. Het hele systeem bestaat uit twee delen: een plugin (Addon) voor FreeCAD die een lokale RPC-server in de editor start, en een Python-hulpprogramma dat MCP-protocolopdrachten vertaalt naar aanroepen naar deze RPC-server.

Als gevolg daarvan kan het model de huidige scène zien, objecten maken, willekeurige Python-code uitvoeren en zelfs structurele analyseberekeningen uitvoeren.

Hoe het er in de praktijk uitziet

De auteur van de repository demonstreerde verschillende praktische gebruiksscenario's.

Modelleren vanuit beschrijving

Je vraagt om een flens of speelgoedauto met opgegeven afmetingen te maken. Claude maakt schetsen, trekt vlakken uit en rondt hoeken af via tool-aanroepen.

Een 3D-onderdeel reconstrueren vanuit een 2D-tekening

Als je een standaard technische tekening met afmetingen in de chat plaatst, parseert het neurale netwerk de projecties, genereert een schets en bouwt een 3D-model.

Na het analyseren van de afmetingen bouwt Claude het onderdeel stap voor stap op in de editor:

Beschikbare tools en mogelijkheden

De repository geeft het taalmodel toegang tot een dozijn kant-en-klare functies:

• create_document, create_object, edit_object, delete_object voor basis geometrische bewerkingen
• execute_code voor het uitvoeren van ruwe Python-code binnen de FreeCAD-sessie
• get_view voor het vastleggen van een screenshot van de huidige viewport vanuit een specifieke hoek
• run_fem_analysis voor het uitvoeren van FEM-berekeningen via de CalculiX solver met terugkeer van maximale Von Mises-spanning en vervormingen

Een interessant detail: elke tool kan een scène-screenshot retourneren in isometrische of een andere weergave. Hierdoor kan het model het resultaat van elke stap visueel controleren. Als je context en tokens wilt besparen, kan beeldtransmissie worden uitgeschakeld met de --only-text-feedback vlag.

Installatie en configuratie

Je hebt FreeCAD versie 1.0 of 1.1 en het uvx-hulpprogramma nodig om te beginnen.

Kopieer eerst de addon naar de mod-map van 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/

Na het opnieuw opstarten van FreeCAD verschijnt "MCP Addon" in de werkbanklijst.

Selecteer het en klik op "Start RPC Server" in de werkbalk. Je kunt ook auto-start inschakelen voor de server wanneer het programma opent.

Registreer vervolgens de server in het configuratiebestand claude_desktop_config.json:

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

Als FreeCAD op een aparte computer op het lokale netwerk draait, kun je externe verbindingen inschakelen met de --host <ip-адрес> vlag en de toegestane IP-lijst direct in de interface van de addon configureren.

Impressies

Het project is geweldig voor ingenieurs, makers met 3D-printers en ontwikkelaars die regelmatig automatiseringsscripts voor FreeCAD schrijven. In plaats van veel tijd te besteden aan het leren van de Python API van de editor, kun je Claude vragen om code te schrijven en direct toe te passen op een document. Natuurlijk is voor complexe assemblages met honderden onderdelen handmatige besturing nog steeds noodzakelijk, maar voor prototyping en het werken met eenvoudige tekeningen werkt de tool geweldig.