FreeCAD MCP

Dieses Repository ist ein FreeCAD MCP, mit dem Sie FreeCAD von Claude Desktop aus steuern können.

Demo

Flansch entwerfen

Spielzeugauto entwerfen

Teil aus 2D-Zeichnung entwerfen

Eingabe 2D-Zeichnung

Demo

Dies ist der Gesprächsverlauf. https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

Related MCP server: FreeCAD MCP

Addon installieren

Das FreeCAD-Addon-Verzeichnis ist

• 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/ oder ~/snap/freecad/common/Mod/ (falls Sie FreeCAD über Snap installieren)

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

Bitte legen Sie das Verzeichnis addon/FreeCADMCP in das Addon-Verzeichnis.

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/

Wenn Sie das Addon installieren, müssen Sie FreeCAD neu starten. Sie können "MCP Addon" aus der Arbeitsbereichsliste auswählen und verwenden.

Und Sie können den RPC-Server über den Befehl "Start RPC Server" in der Symbolleiste "FreeCAD MCP" starten.

RPC-Server automatisch starten

Standardmäßig muss der RPC-Server bei jedem Öffnen von FreeCAD manuell gestartet werden. Um ihn automatisch zu starten:

1. Öffnen Sie das Menü FreeCAD MCP (wechseln Sie zuerst zum MCP Addon-Arbeitsbereich)

2. Aktivieren Sie Auto-Start Server

Die Einstellung wird in freecad_mcp_settings.json gespeichert und bleibt über Sitzungen hinweg erhalten. Beim nächsten Start von FreeCAD wird der RPC-Server automatisch gestartet, sobald die Anwendung vollständig geladen ist.

Sie können dies jederzeit deaktivieren, indem Sie im selben Menü Auto-Start Server deaktivieren.

Einrichten von Claude Desktop

Die Vorinstallation von uvx ist erforderlich.

Außerdem müssen Sie die Konfigurationsdatei von Claude Desktop, claude_desktop_config.json, bearbeiten.

Für Benutzer.

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

Wenn Sie Token sparen möchten, können Sie only_text_feedback auf true setzen und nur Text-Feedback verwenden.

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

Für Entwickler. Zuerst müssen Sie dieses Repository klonen.

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

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

Remote-Verbindungen

Standardmäßig akzeptiert der RPC-Server keine Remote-Verbindungen und lauscht auf localhost. Um FreeCAD von einem anderen Computer in Ihrem Netzwerk aus zu steuern:

1. Remote-Verbindungen in FreeCAD aktivieren

In der Symbolleiste FreeCAD MCP:

1. Aktivieren Sie Remote Connections — der RPC-Server wird beim nächsten Neustart an 0.0.0.0 (alle Schnittstellen) gebunden. Aus Sicherheitsgründen akzeptiert er nur Verbindungen von den IP-Adressen oder CIDR-Subnetzen, die im Feld Allowed IPs angegeben sind. Standardmäßig ist dies 127.0.0.1.

2. Klicken Sie auf Configure Allowed IPs und geben Sie eine durch Kommas getrennte Liste von IP-Adressen oder CIDR-Subnetzen ein, die eine Verbindung herstellen dürfen, z. B.:

   192.168.1.100, 10.0.0.0/24

   127.0.0.1 ist immer der Standardwert. Ungültige Einträge werden mit einem Fehlerdialog abgelehnt. Starten Sie den RPC-Server neu, nachdem Sie diese Einstellungen geändert haben.

2. Den MCP-Server auf den Remote-Host verweisen

Übergeben Sie das Flag --host mit der IP-Adresse oder dem Hostnamen des Computers, auf dem FreeCAD ausgeführt wird:

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

Der Wert --host wird beim Start validiert — er muss eine gültige IPv4/IPv6-Adresse oder ein gültiger Hostname sein.

Tools

• create_document: Erstellt ein neues Dokument in FreeCAD.

• create_object: Erstellt ein neues Objekt in FreeCAD.

• edit_object: Bearbeitet ein Objekt in FreeCAD.

• delete_object: Löscht ein Objekt in FreeCAD.

• execute_code: Führt beliebigen Python-Code in FreeCAD aus.

• insert_part_from_library: Fügt ein Teil aus der Teilebibliothek ein.

• get_view: Erstellt einen Screenshot der aktiven Ansicht.

• get_objects: Ruft alle Objekte in einem Dokument ab.

• get_object: Ruft ein Objekt in einem Dokument ab.

• get_parts_list: Ruft die Liste der Teile in der Teilebibliothek ab.

Mitwirkende

Erstellt mit contrib.rocks.