Fusion360 Cam Assistant

🚀 Autodesk Fusion MCP Server 插件

用人工智能控制 Fusion ！

這款適用於 Autodesk Fusion 的插件可連接到 Aura Friday MCP-Link 服務器，使 Fusion 成為可供 AI 代理控制的遠程工具。官方商店鏈接

點擊上方觀看 AI 以 3D 形式創建 “Fusion Rocks!”

🚀 快速開始

本插件可讓 AI 通過三種強大功能對 Fusion 實現無限制訪問，以下為你詳細介紹其使用方法、新特性、功能示例等內容。

✨ 主要特性

最新特性：增強 Python 集成（2026 年 1 月）

• 🔥 預注入快捷方式 - 在 Python 中可立即使用 app、ui、design、rootComponent。
• 🔥 跨操作上下文 - 可通過 fusion_context 在 Python 中訪問通過 store_as 存儲的對象。
• 🔥 ValueInput 支持 - 通用 API 現在可自動構造 ValueInput 對象。
• 🔥 三重文檔來源 - 內省 + 在線文檔 + 最佳實踐。
• 🔥 附帶示例的豐富 API 文檔 - 從 Autodesk 的雲幫助中獲取帶代碼示例的文檔。
• 🔥 自動更新 - 安全、經過簽名驗證的更新，無需重新安裝。

線程安全架構（2025 年 11 月）

• ✅ 堅如磐石的穩定性 - 所有 Fusion API 調用現在都在主線程上執行。
• ✅ 零崩潰 - 工作隊列系統可防止線程問題。
• ✅ 集中日誌記錄 - 所有組件都能進行線程安全的診斷。
• ✅ 適合生產環境 - 可處理高負載而不會出現不穩定情況。

Python 執行 + MCP 工具集成

現在，AI 可以直接在 Fusion 內部運行任意 Python 代碼，並可完全訪問以下內容：

• ✅ 整個 Fusion API（adsk.core、adsk.fusion、adsk.cam）
• ✅ 所有已加載的插件（可自動訪問自定義插件！）
• ✅ SQLite 數據庫（存儲和查詢設計數據）
• ✅ 瀏覽器自動化（打開文檔、提取數據）
• ✅ 用戶彈窗（顯示結果、獲取輸入）
• ✅ 通過 OpenRouter 訪問 500 多種 AI 模型
• ✅ 本地 AI 模型（離線推理）
• ✅ 桌面自動化（Windows 控制）

示例：AI 分析你的 AirfoilTools 插件，從 1538 個翼型輪廓中找到最佳翼型，將結果存儲在 SQLite 中，並顯示一個彈窗 —— 所有操作只需一個命令即可完成！

📦 安裝指南

前提條件

1. 下載 MCP-Link 服務器
   獲取最新版本：https://github.com/AuraFriday/mcp-link-server/releases/tag/latest

2. 安裝插件 官方鏈接：https://apps.autodesk.com/FUSION/en/Detail/Index?id=7269770001970905100

可選的手動安裝步驟

2b. 克隆此倉庫

git clone https://github.com/AuraFriday/Fusion-360-MCP-Server.git

2c. 作為 Fusion 插件加載

• 打開 Fusion
• 按 Shift + S 打開“腳本和插件”
• 點擊“插件”選項卡
• 點擊“我的插件”旁邊的綠色 “+” 按鈕
• 導航到克隆的倉庫文件夾
• 選擇該文件夾並點擊“確定”
• 點擊“運行”以啟動插件

配置

插件在啟動時會自動連接到 MCP 服務器。在 Fusion 的“文本命令”窗口中查看連接日誌。

💻 使用示例

基礎用法

示例 1：獲取 API 文檔（新增功能）

# 按類名快速搜索
fusion360.execute({
  "operation": "get_api_documentation",
  "search_term": "Sketch",
  "category": "class_name",
  "max_results": 3
})

# 獲取帶代碼示例的豐富文檔
fusion360.execute({
  "operation": "get_online_documentation",
  "class_name": "ExtrudeFeatures",
  "member_name": "createInput"
})
# 返回：完整的參數描述、返回類型和 8 個工作示例！

# 獲取最佳實踐指南
fusion360.execute({
  "operation": "get_best_practices"
})
# 返回：座標系、實體命名、構造平面、PTransaction 模式

示例 2：簡單草圖（通用 API）

# 創建草圖
fusion360.execute({
  "api_path": "design.rootComponent.sketches.add",
  "args": ["design.rootComponent.xYConstructionPlane"],
  "store_as": "my_sketch"
})

# 添加矩形
fusion360.execute({
  "api_path": "$my_sketch.sketchCurves.sketchLines.addTwoPointRectangle",
  "args": [
    {"type": "Point3D", "x": 0, "y": 0, "z": 0},
    {"type": "Point3D", "x": 10, "y": 5, "z": 0}
  ]
})

高級用法

示例 3：結合數據庫使用 Python（新增功能）

fusion360.execute({
  "operation": "execute_python",
  "code": """
import adsk.core, adsk.fusion

# 創建安裝板
sketch = design.rootComponent.sketches.add(design.rootComponent.xYConstructionPlane)
lines = sketch.sketchCurves.sketchLines
lines.addTwoPointRectangle(
    adsk.core.Point3D.create(0, 0, 0),
    adsk.core.Point3D.create(10, 8, 0)
)

# 添加安裝孔
circles = sketch.sketchCurves.sketchCircles
for x, y in [(1, 1), (9, 1), (1, 7), (9, 7)]:
    circles.addByCenterRadius(adsk.core.Point3D.create(x, y, 0), 0.25)

# 存儲到數據庫
mcp.call('sqlite', {
    'input': {
        'sql': 'INSERT INTO parts (name, holes) VALUES (?, ?)',
        'params': [sketch.name, 4],
        'database': 'designs.db',
        'tool_unlock_token': '29e63eb5'
    }
})

print(f'創建了帶有 4 個安裝孔的 {sketch.name}')
"""
})

示例 4：訪問自定義插件（新增功能）

fusion360.execute({
  "operation": "execute_python",
  "code": """
import sys

# 查找已加載的插件
addins = [name for name in sys.modules.keys() if 'addin' in name.lower()]
print(f'找到 {len(addins)} 個插件')

# 訪問 AirfoilTools（如果已加載）
if 'AirfoilTools' in str(addins):
    airfoil_main = sys.modules['...AirfoilTools_py']
    foildb = airfoil_main.foildb2020.Foildb2020()
    
    # 找到最佳翼型
    best = max(foildb, key=lambda x: x['clcd'])
    print(f'最佳升阻比: {best["clcd"]:.2f}')
    
    # 存儲到數據庫
    mcp.call('sqlite', {
        'input': {
            'sql': 'INSERT INTO airfoils (name, ld_ratio) VALUES (?, ?)',
            'params': [best['Foil_fn'], best['clcd']],
            'database': 'airfoils.db',
            'tool_unlock_token': '29e63eb5'
        }
    })
"""
})

📚 詳細文檔

• 快速入門指南 - 10 項全面測試
• Python 集成 - 完整功能
• 演示腳本 - 實際工作示例
• AirfoilTools 演示 - 實際集成案例

🔧 技術細節

核心架構

• 使用 Fusion 的原生 Python API 構建
• 使用服務器發送事件（SSE）進行 MCP 連接
• 使用 JSON - RPC 協議執行命令
• 真正的內聯 Python 執行（無沙盒）
• 對 Fusion 性能零開銷
• 所有操作均在本地運行（無雲依賴）
• 具有指數退避的自動重新連接功能
• 使用原生消息協議進行服務器發現

線程安全與穩定性

• 主線程執行：所有 Fusion API 調用都在 Fusion 的主 UI 線程上執行
• 工作隊列系統：後臺線程將工作項排隊，以便在主線程上安全處理
• 自定義事件處理程序：使用 Fusion 的 CustomEvent 系統安全觸發 API 調用
• 集中日誌記錄：線程安全的日誌緩衝區確保從任何線程進行可靠的診斷
• 防止崩潰：強大的架構即使在高負載下也能防止崩潰

文檔系統（新增功能）

• 三層方法：內省 → 在線文檔 → 最佳實踐
• 內省：使用 Python 的 inspect 模塊進行即時 API 搜索
• 在線文檔：從 Autodesk 的雲幫助中獲取，URL 可預測
• 最佳實踐：內置指南涵蓋座標系、實體命名、PTransaction 模式
• 豐富內容：參數表、返回類型和工作代碼示例

自動更新系統（新增功能）

• 安全更新：RSA 簽名驗證確保更新的真實性
• 靜態加載器：最小化的存根，自身從不更新
• 安全覆蓋：在模塊加載之前應用更新
• 後臺下載：非阻塞的更新檢查
• 版本跟蹤：使用 VERSION.txt 進行可靠的版本比較
• 特定平臺：為 Windows/Mac 提供單獨的軟件包

📄 許可證

專有許可 - 詳情請參閱 LICENSE 文件。