Fusion 360 MCP Integration

Autodesk Fusion 360 MCP-Integration

Die Anwendung Fusion MCP (Model Context Protocol) ist ein Integrationssystem, das KI-Assistenten die programmgesteuerte Interaktion mit Autodesk Fusion 360 ermöglicht. Diese Implementierung zeigt insbesondere, wie parametrische 3D-Modelle durch einfache API-Aufrufe erstellt werden und schließt so die Lücke zwischen Konversations-KI und CAD-Software.

Überblick

Die Fusion 360 MCP-Integration ermöglicht KI-Assistenten die Steuerung von Fusion 360 für 3D-Modellierungsaufgaben. Dieses Projekt ist besonders wertvoll für:

• KI-gestützte CAD-Design-Workflows
• Parametrische 3D-Modellgenerierung
• Automatisieren wiederkehrender Konstruktionsaufgaben in Fusion 360
• Erstellen programmgesteuerter Schnittstellen zu Fusion 360

Komponenten

Die Integration besteht aus drei Hauptkomponenten:

1. LiveCube-Skript ( LiveCube.py & LiveCube.manifest )

Ein Fusion 360-Add-In, das:

• Läuft in Fusion 360 als Skript
• Erstellt parametrische Würfel mit festgelegten Abmessungen
• Stellt einen HTTP-Endpunkt auf Port 18080 bereit, um Befehle zu empfangen
• Kann über einfache HTTP-GET-Anfragen ausgelöst werden

2. Fusion Server ( fusion_server.py )

Ein Zwischenserver, der:

• Fungiert als Brücke zwischen MCP und Fusion 360
• Lauscht auf Port 8000 auf MCP-Anfragen
• Übersetzt MCP-Aufrufe in Formate, die Fusion 360 verstehen kann
• Verwaltet die Kommunikation mit dem LiveCube-Skript

3. MCP-Server ( fusion_mcp.py )

Der Model Context Protocol-Server, der:

• Bietet Tools, die KI-Assistenten nutzen können
• Integriert mit Autodesk Platform Services (APS) für Cloud-Automatisierung
• Bietet das Tool generate_cube zum Erstellen parametrischer Würfel
• Verwendet OAuth-Authentifizierung für sicheren Zugriff auf APS

Merkmale

• Würfelerstellung : Generieren Sie parametrische Würfel mit angegebenen Abmessungen
• Autodesk Platform Services Integration : Verwenden Sie APS Design Automation für komplexe Vorgänge
• Einfache HTTP-Schnittstelle : Benutzerfreundliche API zur Steuerung von Fusion 360
• MCP-Standardkonformität : Funktioniert mit jedem MCP-kompatiblen KI-Assistenten

Installation

Voraussetzungen

• Autodesk Fusion 360 (2023 oder neuer)
• Python 3.9+ mit pip
• Autodesk Platform Services-Konto mit API-Zugriff
• MCP-kompatibler KI-Assistent (wie Claude in Windsurf-Umgebungen)

Installationsanweisungen

1. Installieren Sie Python-Abhängigkeiten :
   pip install -r requirements.txt
2. Umgebungsvariablen einrichten : Erstellen Sie eine Datei keys.env mit Ihren Autodesk Platform Services-Anmeldeinformationen:
   APS_CLIENT_ID=your_client_id APS_CLIENT_SECRET=your_client_secret FUSION_ACTIVITY_ID=your_activity_id
3. Installieren Sie das LiveCube-Skript in Fusion 360 :
   • Öffnen Sie Fusion 360
   • Navigieren Sie zu Skripten und Add-Ins (Umschalt+S)
   • Klicken Sie auf die grüne Schaltfläche „+“ und wählen Sie „Skript hinzufügen“
   • Navigieren Sie zum LiveCube -Ordner in diesem Repository und wählen Sie ihn aus.
   • Das Skript sollte nun in Ihrer Skriptliste erscheinen

Verwendung

Starten der Server

1. Starten Sie den Fusion Server :
   python fusion_server.py
   Dadurch wird das Abhören von http://localhost:8000 gestartet.
2. Führen Sie das LiveCube-Skript aus :
   • Gehen Sie in Fusion 360 zu Skripts und Add-Ins
   • Wählen Sie LiveCube aus und klicken Sie auf „Ausführen“.
   • Dadurch wird der HTTP-Server in Fusion 360 auf Port 18080 gestartet
3. Starten Sie den MCP-Server :
   python fusion_mcp.py
   Dadurch wird der MCP-Server standardmäßig mit stdio-Transport gestartet.

Verwendung mit KI-Assistenten

Konfigurieren Sie Ihren MCP-kompatiblen KI-Assistenten für die Verbindung mit dem Fusion MCP-Server. Beispiel:

Die KI kann dann das Tool generate_cube verwenden, um Würfel in Fusion 360 zu erstellen.

Direkter API-Zugriff

Sie können auch direkt mit dem HTTP-Endpunkt des LiveCube-Skripts interagieren:

Dadurch würde in Fusion 360 ein Würfel mit 50 mm Kantenlänge entstehen.

Entwicklernotizen

• Der MCP-Server kommuniziert mit Autodesk Platform Services (APS) über die OAuth 2.0-Authentifizierung
• Für erweiterte Anwendungsfälle können Sie fusion_mcp.py ändern, um neben der Würfelerstellung weitere Tools hinzuzufügen.
• Die Systemarchitektur kann erweitert werden, um andere Fusion 360-Operationen zu unterstützen, indem neue Handler in fusion_server.py und entsprechende Fusion 360-Skripte hinzugefügt werden.

Lizenz

MIT

Danksagung

• Autodesk für die Fusion 360 API und Plattformdienste
• Entwickler des Model Context Protocol (MCP) zur Ermöglichung der Interoperabilität von KI-Tools npx @modelcontextprotocol/server-everything

Ausführen des SSE-Servers

Führen Sie den streambaren HTTP-Server aus