Fusion360 MCP Server

🚀 融合360 MCP服務器

本項目是一箇中間件，用於連接Cline與Autodesk Fusion 360。它藉助API將Fusion 360的工具欄命令轉化為可調用工具，通過自然語言解析實現具體操作，如“創建一個帶圓角的盒子”。項目會生成可在Fusion 360中直接運行的Python腳本。

🚀 快速開始

本項目是連接Cline與Autodesk Fusion 360的中間件，藉助API將Fusion 360工具欄命令轉化為可調用工具，通過自然語言解析實現具體操作，還能生成可在Fusion 360中運行的Python腳本。

✨ 主要特性

• 通過API將Fusion 360的工具欄命令暴露為可調用工具。
• 支持自然語言解析，將自然語言轉化為具體的操作步驟。
• 生成可在Fusion 360中直接運行的Python腳本。

📦 安裝指南

系統要求

• Python 3.9或更高版本
• Autodesk Fusion 360

安裝步驟

1. 克隆此倉庫到本地。
2. 使用以下命令安裝依賴：

pip install -r requirements.txt

💻 使用示例

基礎用法

HTTP模式

python server.py --http

訪問http://localhost:5000使用REST API。

MCP模式（Fusion插件）

將server.py作為Fusion插件運行，通過標準輸入輸出與插件通信。

高級用法

以下是腳本生成的示例代碼，展示瞭如何在Fusion 360中創建一個簡單的拉伸體：

import adsk.core, adsk.fusion, traceback

def run(context):
    ui = None
    try:
        app = adsk.core.Application.get()
        ui = app.userInterface
        design = app.activeProduct
        
        # 獲取當前組件
        component = design.rootComponent
        
        # 創建XY平面新草圖
        sketch = component.sketches.add(component.xYConstructionPlane)
        
        # 繪製矩形
        rectangle = sketch.sketchCurves.sketchLines.addTwoPointRectangle(
            adsk.core.Point3D.create(0, 0, 0),
            adsk.core.Point3D.create(10, 10, 0)
        )
        
        # 拉伸操作
        prof = sketch.profiles.item(0)
        extrude_input = component.features.extrudeFeatures.createInput(prof, adsk.fusion.FeatureOperations.NewBodyFeatureOperation)
        distance_input = adsk.core.ValueInput.createByReal(5)
        extrude_input.setDistanceExtent(False, distance_input)
        extrude = component.features.extrudeFeatures.add(extrude_input)
        
        ui.messageBox('操作完成')
    except:
        if ui:
            ui.messageBox(f'失敗:\n{traceback.format_exc()}')

📚 詳細文檔

項目結構

• tool_registry.json: 定義可用工具及其參數。
• script_generator.py: 根據工具調用生成Python腳本。
• 其他文件：日誌、模板等輔助文件。

工具擴展

添加新工具步驟

1. 在tool_registry.json中添加新工具的定義，包括名稱和參數。
2. 更新script_generator.py中的SCRIPT_TEMPLATES以支持新工具。
3. 實現新的參數處理邏輯在_process_parameters函數中。

未來增強

• 實現會話狀態跟蹤，支持上下文感知操作。
• 推動動態工具註冊功能。
• 開發自動化機制，通過套接字或文件輪詢實現。
• 擴展更多Fusion命令。

📄 許可證

項目遵循MIT許可證，詳細信息見LICENSE文件。