Fusion 360 MCP Server

Fusion 360 MCP Server

site icon
2025.03.26 13
Python远程控制自动化工具Fusion 360 集成开发效率
Fusion 360 MCP Server 是一个用于 Autodesk Fusion 360 的主控程序(MCP)服务器,支持远程控制和自动化 Fusion 360 操作。它采用客户端-服务器架构,作为外部应用程序与 Fusion 360 API 之间的桥梁,实现远程命令执行和模型信息检索。
View on GitHub

Overview

基本能力

产品定位

Fusion 360 MCP Server 是一个用于 Autodesk Fusion 360 的远程控制和自动化工具,旨在通过客户端-服务器架构扩展 Fusion 360 的功能,使其能够被外部应用程序控制和自动化操作。

核心功能

  1. 远程控制:通过 MCP Server 远程执行 Fusion 360 命令。
  2. 模型信息检索:获取当前模型的详细信息。
  3. 客户端-服务器通信:基于 JSON 的简单协议,通过 TCP 套接字进行通信。
  4. 扩展性:支持通过添加新消息类型和处理程序扩展功能。

适用场景

  1. 自动化设计流程:通过脚本或外部工具自动化 Fusion 360 操作。
  2. 远程协作:在团队中共享和控制 Fusion 360 模型。
  3. 集成开发:将 Fusion 360 功能集成到其他应用程序中。

工具列表

  1. MCP Server (server.py):独立的 Python 服务器,监听客户端连接并与 Fusion 360 通信。
  2. MCP Client (client.py):Python 客户端库,提供连接服务器、发送命令和接收响应的方法。
  3. Fusion 360 Add-in (fusion360_mcp_addon.py):Fusion 360 插件,提供与 Fusion 360 API 的实际集成。

常见问题解答

  1. 如何修改服务器的主机和端口?:可以在代码中修改 server.py 的主机和端口配置。
  2. 如何扩展功能?:通过添加新消息类型、实现服务器处理程序、扩展客户端方法和插件功能来实现。
  3. 是否需要额外的 Python 包?:不需要,仅使用标准库模块。

使用教程

使用依赖

  1. Python 3.6+:确保已安装 Python 3.6 或更高版本。

安装教程

  1. 服务器和客户端
  2. 克隆仓库或复制文件到目标位置。
  3. 确保已安装 Python 3.6+。

  4. Fusion 360 插件

  5. 在 Fusion 360 中打开 "Scripts and Add-ins" 对话框(按 Shift+S 或在 "Design" 工作空间的 "Utilities" 下找到)。
  6. 点击 "Add-ins" 标签,然后点击 "My Add-ins" 旁边的 "+" 图标。
  7. 导航到插件文件所在位置,选择包含 fusion360_mcp_addon.py 的文件夹。
  8. 点击 "Run" 启动插件,或点击 "Run on Startup" 使其在 Fusion 360 启动时自动加载。

调试方式

  1. 启动服务器bash python server.py
  2. 默认监听 127.0.0.1:8080,可在代码中修改主机和端口。

  3. 连接 Fusion 360 到服务器

  4. 启动 Fusion 360 并确保 MCP 插件正在运行。
  5. 在 Fusion 360 中找到 "MCP Controls" 面板。
  6. 点击 "Connect to MCP Server" 按钮,输入服务器主机和端口,点击 OK。
  7. 成功连接后将显示确认消息。

  8. 使用客户端: ```python 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()

```

许可证

None