FreeCAD über Claude Desktop mit MCP steuern

Ich bin recently auf ein interessantes Projekt gestoßen: eine FreeCAD- und Claude-Desktop-Integration über das Model Context Protocol. Ich suchte nach einer Möglichkeit, schnell ein einfaches 3D-Modell oder Teil aus einer Zeichnung zu skizzieren, ohne manuell durch Skizzen in der CAD-Oberfläche klicken zu müssen. Das neka-nat/freecad-mcp-Repository löst genau dieses Problem. Sie beschreiben das Teil in Worten oder fügen ein Bild mit einer Zeichnung bei, und das Sprachmodell erstellt die Geometrie direkt im geöffneten FreeCAD-Fenster.

Was es ist

Das Projekt ist ein MCP-Server, der FreeCAD mit Clients wie Claude Desktop verbindet. Das gesamte System besteht aus zwei Teilen: einem Plugin (Addon) für FreeCAD, das einen lokalen RPC-Server im Editor startet, und einem Python-Dienstprogramm, das MCP-Protokollbefehle in Aufrufe dieses RPC-Servers übersetzt.

Als Ergebnis sieht das Modell die aktuelle Szene, kann Objekte erstellen, beliebigen Python-Code ausführen und sogar Strukturanalyseberechnungen durchführen.

Wie es in der Praxis aussieht

Der Autor des Repositories demonstrierte mehrere praktische Anwendungsszenarien.

Modellierung aus Beschreibung

Sie bitten darum, einen Flansch oder ein Spielzeugauto mit angegebenen Abmessungen zu erstellen. Claude erstellt Skizzen, extrudiert Flächen und rundet Ecken über Tool-Aufrufe.

Rekonstruktion eines 3D-Teils aus einer 2D-Zeichnung

Wenn Sie eine standardmäßige technische Zeichnung mit Maßen in den Chat werfen, analysiert das neuronale Netz die Projektionen, erstellt eine Skizze und baut ein 3D-Modell.

Nach der Analyse der Maße assembliert Claude das Teil Schritt für Schritt im Editor:

Verfügbare Tools und Funktionen

Das Repository gewährt dem Sprachmodell Zugriff auf ein Dutzend fertige Funktionen:

• create_document, create_object, edit_object, delete_object für grundlegende Geometrieoperationen
• execute_code zum Ausführen von rohem Python-Code innerhalb der FreeCAD-Sitzung
• get_view zum Aufnehmen eines Screenshots des aktuellen Viewports aus einem bestimmten Winkel
• run_fem_analysis zum Ausführen von FEM-Berechnungen durch den CalculiX-Solver mit Rückgabe der maximalen Von-Mises-Spannung und Verformungen

Ein interessantes Detail: Jedes Tool kann einen Szene-Screenshot in isometrischer oder einer anderen Ansicht zurückgeben. Dank dessen prüft das Modell visuell das Ergebnis jedes Schritts. Wenn Sie Kontext und Tokens sparen möchten, kann die Bildübertragung mit dem Flag --only-text-feedback deaktiviert werden.

Installation und Einrichtung

Sie benötigen FreeCAD Version 1.0 oder 1.1 und das uvx-Dienstprogramm für den Einstieg.

Kopieren Sie zuerst das Addon in den mod-Ordner von 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/

Nach dem Neustart von FreeCAD erscheint "MCP Addon" in der Arbeitsbereichsliste.

Wählen Sie es aus und klicken Sie auf der Symbolleiste auf "RPC-Server starten". Von dort aus können Sie auch den automatischen Start des Servers beim Programmstart aktivieren.

Registrieren Sie dann den Server in der Konfigurationsdatei claude_desktop_config.json:

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

Wenn FreeCAD auf einem separaten Computer im lokalen Netzwerk läuft, können Sie Remote-Verbindungen mit dem Flag --host <ip-адрес> aktivieren und die Liste der erlaubten IPs direkt in der Oberfläche des Addons konfigurieren.

Eindrücke

Das Projekt ist großartig für Ingenieure, Maker mit 3D-Druckern und Entwickler, die häufig Automatisierungsskripte für FreeCAD schreiben. Anstatt viel Zeit damit zu verbringen, die Python-API des Editors zu erlernen, können Sie Claude bitten, Code zu schreiben und sofort auf ein Dokument anzuwenden. Natürlich ist für komplexe Baugruppen mit hunderten von Teilen manuelle Steuerung weiterhin erforderlich, aber für Prototyping und das Arbeiten mit einfachen Zeichnungen funktioniert das Tool hervorragend.