# justusbraitinger/autodesk-fusion-360-mcp-server architecture

> Architecture diagram of the GitHub repository justusbraitinger/autodesk-fusion-360-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/justusbraitinger/autodesk-fusion-360-mcp-server
- Repository: https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server

## Overview

##### Project Type and Purpose
- This is an integration project (“Fusion MCP Integration”) combining:
- A local MCP server (Server/MCP_Server.py) that hosts AI-driven “tools” and prompt definitions via HTTP/SSE.
- A Python-based Autodesk Fusion 360 add-in (MCP/MCP.py + MCP/commands + MCP/lib) that bridges incoming HTTP calls into Fusion’s API.
- Goal: Allow conversational CAD in Fusion 360 by routing user prompts (from Claude Desktop or VS Code) through the MCP protocol into Fusion and back.

##### File Structure Analysis
Top-level
- LICENSE, README.md
- MCP/ ← Fusion add-in directory
– MCP.py, config.py
– commands/ ← shared tool modules (entry.py in subfolders commandDialog, paletteSend, paletteShow)
– lib/fusionAddInUtils/ ← event & utility helpers
- Server/ ← standalone MCP server
– MCP_Server.py (defines server, tools, prompts)
– config.py, requirements.txt
- Patterns:
- “MCP” folder houses code loaded both in Fusion add-in and by the server (tool definitions).
- Server folder hosts the actual HTTP/SSE service.
- Commands subfolders map one-to-one with “tools” (e.g., sketch tools, modify tools, analysis tools).

##### README Insights
- Server.py: “Defines MCP server, tools, and prompts; handles HTTP calls to Fusion add-in.”
- MCP.py: “Fusion Add-in using custom event handler & task queue because Fusion API is not thread-safe.”
- External integrations: Claude Desktop, VS Code Copilot Chat via MCP.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Interfaces
    subgraph "Client Interfaces"
        style CI fill:#ffe5b4,stroke:#e68a00
        Claude["Claude Desktop"]:::external
        VSCode["VS Code Copilot Chat"]:::external
    end

    %% MCP Server
    subgraph "MCP Server (SSE + HTTP)" 
        style MS fill:#cce5ff,stroke:#005cbf
        MCP_Server["MCP_Server.py"]:::server
        Server_config["config.py"]:::server
        Requirements["requirements.txt"]:::server
        SSE["SSE Endpoint"]:::server
        PromptRegistry["Prompt Registry & Tool Loader"]:::server
        HTTPClient["HTTP Client to Add-in"]:::server
    end

    %% Shared Tool Modules
    subgraph "Shared Tool Modules (commands)"
        style ST fill:#e6ccff,stroke:#8000ff
        CMD1["commandDialog/entry.py"]:::shared
        CMD2["paletteSend/entry.py"]:::shared
        CMD3["paletteShow/entry.py"]:::shared
    end

    %% Fusion Add-in
    subgraph "Fusion Add-in (Event Queue)"
        style FA fill:#d4edda,stroke:#28a745
        Addin_py["MCP.py"]:::addin
        Manifest["MCP.manifest"]:::addin
        Addin_config["config.py"]:::addin
        HTTPListener["HTTP Listener"]:::addin
        EventQueue["Event Queue & Handler"]:::addin
        Dispatcher["Command Dispatcher"]:::addin
        EventUtils["event_utils.py"]:::utils
        GeneralUtils["general_utils.py"]:::utils
    end

    %% Fusion 360 Host
    subgraph "Autodesk Fusion 360 Host"
        style FH fill:#f2f2f2,stroke:#6c757d
        FusionAPI["Fusion API"]:::host
    end

    %% Data Flows
    Claude -->|HTTP/SSE| MCP_Server
    VSCode -->|HTTP| MCP_Server
    MCP_Server -->|"imports tools"| CMD1
    MCP_Server -->|imports tools| CMD2
    MCP_Server -->|imports tools| CMD3
    MCP_Server -->|HTTP POST| Addin_py
    Addin_py -->|queues events| EventQueue
    EventQueue -->|calls| FusionAPI
    FusionAPI -->|responses| Dispatcher
    Dispatcher -->|HTTP response| MCP_Server
    MCP_Server -->|SSE events| Claude
    MCP_Server -->|HTTP response| VSCode
    Addin_py -->|uses| EventUtils
    Addin_py -->|uses| GeneralUtils
    CMD1 -->|shared code| Addin_py
    CMD2 -->|shared code| Addin_py
    CMD3 -->|shared code| Addin_py

    %% Click Events
    click MCP_Server "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/Server/MCP_Server.py"
    click Server_config "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/Server/config.py"
    click Requirements "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/Server/requirements.txt"
    click Addin_py "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/MCP.py"
    click Manifest "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/MCP.manifest"
    click Addin_config "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/config.py"
    click CMD1 "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/commands/commandDialog/entry.py"
    click CMD2 "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/commands/paletteSend/entry.py"
    click CMD3 "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/commands/paletteShow/entry.py"
    click EventUtils "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/lib/fusionAddInUtils/event_utils.py"
    click GeneralUtils "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/MCP/lib/fusionAddInUtils/general_utils.py"
    click readme "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/blob/main/README.md"
    click license "https://github.com/justusbraitinger/autodesk-fusion-360-mcp-server/tree/main/LICENSE"

    %% Styles
    classDef external fill:#ffe5b4,stroke:#e68a00;
    classDef server fill:#cce5ff,stroke:#005cbf;
    classDef shared fill:#e6ccff,stroke:#8000ff;
    classDef addin fill:#d4edda,stroke:#28a745;
    classDef utils fill:#d4edda,stroke:#28a745;
    classDef host fill:#f2f2f2,stroke:#6c757d;
```
