Skip to main content
Glama
shiguangzhe666

Fusion360 MCP Server

Fusion360 MCP Server

Beta – Dieses Projekt wird aktiv weiterentwickelt. APIs und das Verhalten der Tools können sich zwischen den Versionen ändern. Verwendung auf eigene Verantwortung. Feedback und Fehlerberichte sind über GitHub Issues willkommen.

MCP-Server, der KI-Programmieragenten für CAD-Automatisierung mit Autodesk Fusion 360 verbindet.

Getestet mit Claude Code. Funktioniert mit jedem MCP-kompatiblen Client – OpenCode, Codex, Cursor oder allem, was das Model Context Protocol spricht.

Wie es funktioniert

Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread

Zwei Komponenten:

  1. MCP-Server (dieses Repository) – Python-Prozess, der das MCP-Protokoll mit Claude spricht und Befehle über TCP weiterleitet

  2. Fusion360MCP-Add-in (installiert im Ordner AddIns von Fusion) – native Erweiterung in Fusion 360 und führt API-Aufrufe sicher im Hauptthread aus

Related MCP server: Fusion360 MCP Server

Voraussetzungen

  • uv (Python-Paketmanager)

  • Autodesk Fusion 360

  • Ein MCP-kompatibler Client (Claude Code, OpenCode, Codex, Cursor, usw.)

Installation

1. Fusion-360-Add-in installieren

Schnellinstallation (Symlink für die Entwicklung):

./scripts/install-addon.sh

Manuelle Installation:

# macOS
cp -r addon ~/Library/Application\ Support/Autodesk/Autodesk\ Fusion\ 360/API/AddIns/Fusion360MCP

# Windows (PowerShell)
Copy-Item -Recurse addon "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

Dann in Fusion starten: Shift+S → Add-Ins → Fusion360MCP → Ausführen

Im Fenster TEXT COMMANDS sollte [MCP] Server listening on localhost:9876 erscheinen.

2. MCP-Clientverbindung herstellen

Der MCP-Server ist auf PyPI veröffentlicht – das Repository muss nicht geklont werden.

Claude Code

claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

Andere MCP-Clients

Der Server läuft über stdio, sodass ihn jeder MCP-kompatible Client starten kann. Der Befehl lautet:

uvx fusion360-mcp-server --mode socket
{
  "mcpServers": {
    "fusion360": {
      "command": "uvx",
      "args": [
        "fusion360-mcp-server",
        "--mode", "socket"
      ]
    }
  }
}

3. Überprüfen

Rufen Sie in Ihrem Client das Tool ping auf. Wenn es {"pong": true} zurückgibt, ist alles verbunden.

Deinstallieren

  1. Entfernen Sie den Eintrag fusion360 aus Ihrer MCP-Client-Konfiguration.

  2. Stoppen Sie das Add-In in Fusion (Shift+SAdd-InsFusion360MCPStop).

  3. Löschen Sie den Add-in-Ordner aus dem AddIns-Verzeichnis von Fusion.

Verfügbare Tools (84)

Szene & Abfrage

Tool

Beschreibung

ping

Health Check (sofort, ohne Fusion API)

get_scene_info

Design Name, Körper, Skizzen, Features, Kamera

get_object_info

Detaillierte Informationen zu einem benannten Körper oder einer Skizze

list_components

Alle Komponenten im Design auflisten

Designtyp-Sicherheit

Tool

Beschreibung

get_design_type

Prüfen, ob der Entwurf im parametrischen oder direkten Modus ist

set_design_type

Gewerblichen Modus wechseln (parametrisch/direkt)

Skizzen

Tool

Beschreibung

create_sketch

Neue Skizze auf xy-/yz-/xz-Ebene, optional mit Versatz

draw_rectangle

Rechteck in der zuletzt erstellten Skizze

draw_circle

Kreis in der zuletzt erstellten Skizze

draw_line

Linie in der zuletzt erstellten Skizze

draw_arc

Bogen (Mittelpunkt + Start + Überlenkwinkel)

draw_spline

Spline mit Fit-Punkten oder Kontrollpunkten

create_polygon

Regelmäßiges Polygon (3–64 Seiten)

add_constraint

Geometrische Randbedingung (koinzident, parallel, tangential usw.)

add_dimension

Limit-Maß (Abstand, Winkel, radiuslich, Durchmesser)

offset_curve

Verbundene Skizzenkurven versetzen

trim_curve

Trimmen an Schnittpunkten

extend_curve

Verlängern bis zum nächsten Schnittpunkt

project_geometry

Kanten/Körper auf den Skizzeilenebene projizieren

Features

Tool

Beschreibung

extrude

Extrudieren eines Skizzenprofils

revolve

Profil um eine Achse drehen

sweep

Profil entlang eines Pfads biegen

loft

Loft zwischen zwei oder mehr Profilen

fillet

Kanten abrunden (alle/oben/unten/vertikal)

chamfer

Kanten anfasen

shell

Körper aushöhlen

mirror

Körper an einer Ebene spiegeln

create_hole

Bohrungs-Feature auf einer Körperfläche des Körpers

rectangular_pattern

Muster in Zeilen und Spalten

circular_pattern

Muster um eine Achse

create_thread

Gewinde hinzufügen (kosmetisch oder modelliert)

draft_faces

Schrägen/Konische Flächen für Entformung

split_body

Körper mithilfe einer Ebene teilen

split_face

Oberflächen eines Körpers teilen

offset_faces

Flächen um einen Abstand verschieben/ziehen

scale_body

Körper gleichmäßig oder ungleichmäßig skalieren

suppress_feature

Ein Z-zeitendiagramm-Feature unterdrücken

unsuppress_feature

Ein unterdrücktes Feature wieder aktivieren

Körperoperationen

Tool

Beschreibung

move_body

Körper um (x, y, z) verschieben

rename_body

Körper umbenennen (durchsucht den Stam- und alle Komponenten)

boolean_operation

Zwei Körper vereinen/subtrainieren/überschneiden

delete_all

Den Entwurf leeren

undo

Letzte Operation rückgängig machen (mit Sicherheitsabfrage für den Designtyp)

Direkte Grundelemente

Tool

Beschreibung

create_box

Quader (über TemporaryBRepManager)

create_cylinder

Zylinder

create_sphere

Kugel

create_torus

Torus

Oberflächenoperationen

Tool

Beschreibung

patch_surface

Vervollständigungsfläche aus Randkanten erstellen

stitch_surfaces

Oberflächenkörper zu einem einzigen verbinden

thicken_surface

Fläche zu einem Volumenkörper

ruled_surface

Geraden-Fläche aus einer Kante

trim_surface

Fläche mit einem anderen Körper bescheinigen

Blech

Tool

Beschreibung

create_flange

Abkante/Lippe an einer Kante erstellen

create_bend

Biegung hinzufügen

flat_pattern

Abwicklungsmuster erstellen

unfold

Bestimmte Biege-Stufen abwickeln

Konstruktionsgeometrie

Tool

Beschreibung

create_construction_plane

Versatz, Winkel, Mittelebene, Punkt-Punkt, tangential

create_construction_axis

Zweipunkt, Schnittkante, Kante, senkrecht

Baugruppe

Tool

Beschreibung

create_component

Unterbaugruppen-Komponente erstellen

add_joint

Verbindung (Joint) zwischen zwei Komponenten

create_as_built_joint

Verbindung aus aktuellen Positionen erstellen

create_rigid_group

Komponenten miteinander fixieren

Inspektion & Analyse

Tool

Beschreibung

measure_distance

Minimale Entfernung zwischen Objekten

measure_angle

Winkel zwischen Objekten

get_physical_properties

Gewicht, Volumen, Fläche, Schwerpunkt

create_section_analysis

Schnittebene durch das Modell

check_interference

Kollisionen zwischen Komponenten erkennen

Darstellung

Tool

Beschreibung

set_appearance

Materialansicht (Appearance) aus Bibliothek zuweisen

Parameter

Tool

Beschreibung

get_parameters

Alle Parameter anzeigen

create_parameter

Neuen Parameter erstellen

set_parameter

Parameterwert aktualisieren

delete_parameter

Parameter entfernen

Export

Tool

Beschreibung

export_stl

Körper als STL exportieren (unterstützt Körper in Komponenten)

export_step

Körper als STEP exportieren (unterstützt Körper in Komponenten)

export_f3d

Entwurf als Fusion-Archiv exportieren

CAM / Fertigung

Tool

Beschreibung

cam_create_setup

Einstellungen für Fertigung erstellen (Schneiden/Drehen/Verbinden)

cam_create_operation

Fertigungsoperation hinzufügen (Planieren, Kontur, adaptiv, Bohren, …)

cam_generate_toolpath

Werkzeugwege für Operationen generieren

cam_post_process

Nachbearbeitung für G-Code (Deutsch? – z. B. DFANUC, GRBL, HAAS)

cam_list_setups

Alle CAM-Setups auflisten

cam_list_operations

Operationen in einem Setup auflisten

cam_get_operation_info

Eigenschaften der Messoperation (Strategie, Werkzeug, Parameter)

Code Ausführung

Tool

Beschreibung

execute_code

Beliebigen Python-Code in Fusion ausführen (REPL-Stil)

MCP Protocol Features

  • Tool-Annotungenjedem Tool ist mit readOnlyHint, destructiveHint sowie idempotentHint markiert, damit MCP-Clients automatisch sichere Befehle freigeben können.

  • Ressourcen Beaconfusion360://status, fusion360://design, fusion360://parameters zur passiven Zustandsbeobachtung.

  • Ressourcenvorlagenfusion360://body/{name}, fusion360://component/{name} für eine dynamische Objektsuche.

  • Promptscreate-box, model-threaded-bolt, sheet-metal-enclosure als Workflow-Blaupausen.

  • Strukturierte Fehler – Werkzeugergebnisse enthalten isError=True, wenn das Add-in einen Fehler meldet.

  • Mock-Modus--mode mock liefert plausible Testdaten ohne Fusion (alle Antworten enthalten "mode": "mock").

Entwicklung

uv sync --dev       # install deps
uv run pytest -v    # run tests (171 tests)
uv run ruff check   # lint

Hinweise

  • Alle Fusion-APIs-Einheiten sind Zentimeter (die interne Einheit von Fusion).

  • Eine Operation pro Funktionsaufruf. Das Bündeln mehrerer Operationen lässt die App abstüt.

  • Sitzungsbefehle laufen nach 30 Sekunden aus.

  • Adon-In schreibt Logdateien mit ~/fusion360mcp.log.

  • Das undo-Tool enthält eine Schutzanzeige für den Designtyp: Es prüft Zustände vorher/nachher und automtetes neu, wenn das Rückgängigmachen vom parametrischen in den direkten Modus wechseln würde.

Danksagungen

Inspiriert von BlenderMCP – die Socket-Bridge-Architektur stammt von dort.

Basideert außerdem auf Ideen aus dem bestehenden Fusion-360-MCP-Ökosystem:

Lizenz

MIT

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language 3D modeling in Fusion 360 through an MCP server that translates user commands into Fusion 360 API calls. Supports creating, editing, and managing 3D objects, executing Python code, and capturing model views through conversational interactions.
    1
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Connects AI coding agents to Autodesk Fusion 360 for CAD automation, enabling natural language control over sketching, 3D modeling, and CAM operations. It uses a Python-based bridge and a custom add-in to execute over 80 tools ranging from simple geometry creation to complex assembly and parameter management.
    80
    77
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Open-source MCP server for controlling Autodesk Fusion 360 from any AI agent, enabling 3D modeling operations via natural language.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shiguangzhe666/Fusion360-MCP-AICAD'

If you have feedback or need assistance with the MCP directory API, please join our Discord server