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. 增强安全性：实现身份验证和加密机制，确保通信安全。

通过这些步骤，您可以根据需求灵活扩展项目功能。