Fusion MCP Server

🚀 融合 360 MCP 服務器

本項目是 Autodesk Fusion 360 的主控制程序 (MCP) 服務器，可實現對 Fusion 360 操作的遠程控制與自動化，為外部應用與 Fusion 360 的交互提供了便利。

🚀 快速開始

該項目採用客戶端 - 服務端架構，藉助服務器作為橋樑，讓外部應用程序能夠與 Fusion 360 進行交互，支持遠程執行命令和檢索模型信息。

✨ 主要特性

• 實現客戶端 - 服務端架構，支持外部應用與 Fusion 360 的交互。
• 作為客戶端與 Fusion 360 之間的橋樑，可遠程執行命令和檢索模型信息。

📦 安裝指南

服務器和客戶端

1. 克隆此倉庫或將文件複製到您所需的目錄中。
2. 確保安裝了 Python 3.6+。
3. 無需額外的 Python 包，實現僅使用標準庫模塊。

Fusion 360 插件

1. 在 Fusion 360 中，轉到“腳本和插件”對話框（按 Shift + S 或在“設計”工作區下“工具”中找到）。
2. 點擊“插件”選項卡，然後點擊“我的插件”旁邊的“+”圖標。
3. 瀏覽到插件文件的位置並選擇包含 fusion360_mcp_addon.py 的文件夾。
4. 點擊“運行”以啟動插件，或“在啟動時運行”以便在 Fusion 360 啟動時自動加載。

💻 使用示例

基礎用法

啟動服務器

1. 打開命令提示符或終端。
2. 切換到包含服務器文件的目錄。
3. 運行以下命令啟動服務器：

python server.py

默認情況下，服務器將在 127.0.0.1:8080 監聽。您可以在代碼中修改主機和端口。

將 Fusion 360 連接到服務器

1. 啟動 Fusion 360 並確保 MCP 插件正在運行。
2. 在 Fusion 360 中，找到“MCP 控制”面板。
3. 點擊“連接到 MCP 服務器”按鈕。
4. 輸入服務器主機和端口，然後點擊確定。
5. 如果成功，您會看到確認消息。

使用客戶端

from client import MCPClient

# 創建並連接客戶端
client = MCPClient('127.0.0.1', 8080)
if client.connect():
    # 獲取模型信息
    client.get_model_info()
    
    # 執行 Fusion 360 命令
    client.execute_fusion_command('create_circle', {
        'center': [0, 0, 0],
        'radius': 10
    })
    
    # 完成時斷開連接
    client.disconnect()

📚 詳細文檔

組件

項目主要包括三個主要組件：

1. MCP 服務器 (server.py)：一個獨立的 Python 服務器，監聽來自客戶端的連接，並與 Fusion 360 進行通信。
2. MCP 客戶端 (client.py)：一個 Python 客戶端庫，用於連接到 MCP 服務器，並提供發送命令和接收響應的方法。
3. Fusion 360 插件 (fusion360_mcp_addon.py)：一個 Fusion 360 插件，連接到 MCP 服務器，並實現與 Fusion 360 API 的實際集成。

協議

服務器和客戶端通過一種簡單的基於 JSON 的協議進行通信，涉及以下不同消息類型：

• 請求 (Request)：客戶端發送給服務器的命令或數據。
• 響應 (Response)：服務器對客戶端請求的反饋。
• 事件 (Event)：服務器向客戶端通知發生的事件。

擴展

要擴展項目功能，可以按照以下步驟進行：

1. 添加新消息類型：在協議中定義新的消息類型，並在服務器和客戶端中實現處理邏輯。
2. 擴展命令集：添加更多與 Fusion 360 API 對接的命令。
3. 增強安全性：實現身份驗證和加密機制，確保通信安全。通過這些步驟，您可以根據需求靈活擴展項目功能。