🚀 融合 360 MCP 服务器
本项目是 Autodesk Fusion 360 的主控制程序 (MCP) 服务器，可实现对 Fusion 360 操作的远程控制与自动化，为外部应用与 Fusion 360 的交互搭建了桥梁。
🚀 快速开始
本项目采用客户端 - 服务端架构，外部应用程序通过此架构与 Fusion 360 进行交互。服务器作为客户端与 Fusion 360 之间的桥梁，支持远程执行命令和检索模型信息。
✨ 主要特性
- 实现客户端 - 服务端架构，支持外部应用与 Fusion 360 交互。
- 支持远程执行命令和检索模型信息。
📦 安装指南
服务器和客户端
- 克隆此仓库或将文件复制到您所需的目录中。
- 确保安装了 Python 3.6+。
- 无需额外安装 Python 包，实现仅使用标准库模块。
Fusion 360 插件
- 在 Fusion 360 中，转到“脚本和插件”对话框（按 Shift + S 或在“设计”工作区下“工具”中找到）。
- 点击“插件”选项卡，然后点击“我的插件”旁边的“+”图标。
- 浏览到插件文件的位置并选择包含
fusion360_mcp_addon.py的文件夹。 - 点击“运行”以启动插件，或选择“在启动时运行”以便在 Fusion 360 启动时自动加载。
💻 使用示例
基础用法
启动服务器
- 打开命令提示符或终端。
- 切换到包含服务器文件的目录。
- 运行以下命令启动服务器：
python server.py
默认情况下，服务器将在 127.0.0.1:8080 监听。您可以在代码中修改主机和端口。
将 Fusion 360 连接到服务器
- 启动 Fusion 360 并确保 MCP 插件正在运行。
- 在 Fusion 360 中，找到“MCP 控制”面板。
- 点击“连接到 MCP 服务器”按钮。
- 输入服务器主机和端口，然后点击确定。
- 如果成功，您会看到确认消息。
使用客户端
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()
📚 详细文档
组件
项目主要包括三个主要组件：
- MCP 服务器 (
server.py)：一个独立的 Python 服务器，监听来自客户端的连接，并与 Fusion 360 进行通信。 - MCP 客户端 (
client.py)：一个 Python 客户端库，用于连接到 MCP 服务器，并提供发送命令和接收响应的方法。 - Fusion 360 插件 (
fusion360_mcp_addon.py)：一个 Fusion 360 插件，连接到 MCP 服务器，并实现与 Fusion 360 API 的实际集成。
协议
服务器和客户端通过一种简单的基于 JSON 的协议进行通信，涉及以下不同消息类型：
- 请求 (Request)：客户端发送给服务器的命令或数据。
- 响应 (Response)：服务器对客户端请求的反馈。
- 事件 (Event)：服务器向客户端通知发生的事件。
扩展
要扩展项目功能，可以按照以下步骤进行：
- 添加新消息类型：在协议中定义新的消息类型，并在服务器和客户端中实现处理逻辑。
- 扩展命令集：添加更多与 Fusion 360 API 对接的命令。
- 增强安全性：实现身份验证和加密机制，确保通信安全。
通过这些步骤，您可以根据需求灵活扩展项目功能。