Fusion360 Cam Assistant

🚀 Autodesk Fusion MCP Server 插件

用人工智能控制 Fusion ！

这款适用于 Autodesk Fusion 的插件可连接到 Aura Friday MCP-Link 服务器，使 Fusion 成为可供 AI 代理控制的远程工具。官方商店链接

点击上方观看 AI 以 3D 形式创建 “Fusion Rocks!”

🚀 快速开始

本插件可让 AI 通过三种强大功能对 Fusion 实现无限制访问，以下为你详细介绍其使用方法、新特性、功能示例等内容。

✨ 主要特性

最新特性：增强 Python 集成（2026 年 1 月）

• 🔥 预注入快捷方式 - 在 Python 中可立即使用 app、ui、design、rootComponent。
• 🔥 跨操作上下文 - 可通过 fusion_context 在 Python 中访问通过 store_as 存储的对象。
• 🔥 ValueInput 支持 - 通用 API 现在可自动构造 ValueInput 对象。
• 🔥 三重文档来源 - 内省 + 在线文档 + 最佳实践。
• 🔥 附带示例的丰富 API 文档 - 从 Autodesk 的云帮助中获取带代码示例的文档。
• 🔥 自动更新 - 安全、经过签名验证的更新，无需重新安装。

线程安全架构（2025 年 11 月）

• ✅ 坚如磐石的稳定性 - 所有 Fusion API 调用现在都在主线程上执行。
• ✅ 零崩溃 - 工作队列系统可防止线程问题。
• ✅ 集中日志记录 - 所有组件都能进行线程安全的诊断。
• ✅ 适合生产环境 - 可处理高负载而不会出现不稳定情况。

Python 执行 + MCP 工具集成

现在，AI 可以直接在 Fusion 内部运行任意 Python 代码，并可完全访问以下内容：

• ✅ 整个 Fusion API（adsk.core、adsk.fusion、adsk.cam）
• ✅ 所有已加载的插件（可自动访问自定义插件！）
• ✅ SQLite 数据库（存储和查询设计数据）
• ✅ 浏览器自动化（打开文档、提取数据）
• ✅ 用户弹窗（显示结果、获取输入）
• ✅ 通过 OpenRouter 访问 500 多种 AI 模型
• ✅ 本地 AI 模型（离线推理）
• ✅ 桌面自动化（Windows 控制）

示例：AI 分析你的 AirfoilTools 插件，从 1538 个翼型轮廓中找到最佳翼型，将结果存储在 SQLite 中，并显示一个弹窗 —— 所有操作只需一个命令即可完成！

📦 安装指南

前提条件

1. 下载 MCP-Link 服务器
   获取最新版本：https://github.com/AuraFriday/mcp-link-server/releases/tag/latest

2. 安装插件 官方链接：https://apps.autodesk.com/FUSION/en/Detail/Index?id=7269770001970905100

可选的手动安装步骤

2b. 克隆此仓库

git clone https://github.com/AuraFriday/Fusion-360-MCP-Server.git

2c. 作为 Fusion 插件加载

• 打开 Fusion
• 按 Shift + S 打开“脚本和插件”
• 点击“插件”选项卡
• 点击“我的插件”旁边的绿色 “+” 按钮
• 导航到克隆的仓库文件夹
• 选择该文件夹并点击“确定”
• 点击“运行”以启动插件

配置

插件在启动时会自动连接到 MCP 服务器。在 Fusion 的“文本命令”窗口中查看连接日志。

💻 使用示例

基础用法

示例 1：获取 API 文档（新增功能）

# 按类名快速搜索
fusion360.execute({
  "operation": "get_api_documentation",
  "search_term": "Sketch",
  "category": "class_name",
  "max_results": 3
})

# 获取带代码示例的丰富文档
fusion360.execute({
  "operation": "get_online_documentation",
  "class_name": "ExtrudeFeatures",
  "member_name": "createInput"
})
# 返回：完整的参数描述、返回类型和 8 个工作示例！

# 获取最佳实践指南
fusion360.execute({
  "operation": "get_best_practices"
})
# 返回：坐标系、实体命名、构造平面、PTransaction 模式

示例 2：简单草图（通用 API）

# 创建草图
fusion360.execute({
  "api_path": "design.rootComponent.sketches.add",
  "args": ["design.rootComponent.xYConstructionPlane"],
  "store_as": "my_sketch"
})

# 添加矩形
fusion360.execute({
  "api_path": "$my_sketch.sketchCurves.sketchLines.addTwoPointRectangle",
  "args": [
    {"type": "Point3D", "x": 0, "y": 0, "z": 0},
    {"type": "Point3D", "x": 10, "y": 5, "z": 0}
  ]
})

高级用法

示例 3：结合数据库使用 Python（新增功能）

fusion360.execute({
  "operation": "execute_python",
  "code": """
import adsk.core, adsk.fusion

# 创建安装板
sketch = design.rootComponent.sketches.add(design.rootComponent.xYConstructionPlane)
lines = sketch.sketchCurves.sketchLines
lines.addTwoPointRectangle(
    adsk.core.Point3D.create(0, 0, 0),
    adsk.core.Point3D.create(10, 8, 0)
)

# 添加安装孔
circles = sketch.sketchCurves.sketchCircles
for x, y in [(1, 1), (9, 1), (1, 7), (9, 7)]:
    circles.addByCenterRadius(adsk.core.Point3D.create(x, y, 0), 0.25)

# 存储到数据库
mcp.call('sqlite', {
    'input': {
        'sql': 'INSERT INTO parts (name, holes) VALUES (?, ?)',
        'params': [sketch.name, 4],
        'database': 'designs.db',
        'tool_unlock_token': '29e63eb5'
    }
})

print(f'创建了带有 4 个安装孔的 {sketch.name}')
"""
})

示例 4：访问自定义插件（新增功能）

fusion360.execute({
  "operation": "execute_python",
  "code": """
import sys

# 查找已加载的插件
addins = [name for name in sys.modules.keys() if 'addin' in name.lower()]
print(f'找到 {len(addins)} 个插件')

# 访问 AirfoilTools（如果已加载）
if 'AirfoilTools' in str(addins):
    airfoil_main = sys.modules['...AirfoilTools_py']
    foildb = airfoil_main.foildb2020.Foildb2020()
    
    # 找到最佳翼型
    best = max(foildb, key=lambda x: x['clcd'])
    print(f'最佳升阻比: {best["clcd"]:.2f}')
    
    # 存储到数据库
    mcp.call('sqlite', {
        'input': {
            'sql': 'INSERT INTO airfoils (name, ld_ratio) VALUES (?, ?)',
            'params': [best['Foil_fn'], best['clcd']],
            'database': 'airfoils.db',
            'tool_unlock_token': '29e63eb5'
        }
    })
"""
})

📚 详细文档

• 快速入门指南 - 10 项全面测试
• Python 集成 - 完整功能
• 演示脚本 - 实际工作示例
• AirfoilTools 演示 - 实际集成案例

🔧 技术细节

核心架构

• 使用 Fusion 的原生 Python API 构建
• 使用服务器发送事件（SSE）进行 MCP 连接
• 使用 JSON - RPC 协议执行命令
• 真正的内联 Python 执行（无沙盒）
• 对 Fusion 性能零开销
• 所有操作均在本地运行（无云依赖）
• 具有指数退避的自动重新连接功能
• 使用原生消息协议进行服务器发现

线程安全与稳定性

• 主线程执行：所有 Fusion API 调用都在 Fusion 的主 UI 线程上执行
• 工作队列系统：后台线程将工作项排队，以便在主线程上安全处理
• 自定义事件处理程序：使用 Fusion 的 CustomEvent 系统安全触发 API 调用
• 集中日志记录：线程安全的日志缓冲区确保从任何线程进行可靠的诊断
• 防止崩溃：强大的架构即使在高负载下也能防止崩溃

文档系统（新增功能）

• 三层方法：内省 → 在线文档 → 最佳实践
• 内省：使用 Python 的 inspect 模块进行实时 API 搜索
• 在线文档：从 Autodesk 的云帮助中获取，URL 可预测
• 最佳实践：内置指南涵盖坐标系、实体命名、PTransaction 模式
• 丰富内容：参数表、返回类型和工作代码示例

自动更新系统（新增功能）

• 安全更新：RSA 签名验证确保更新的真实性
• 静态加载器：最小化的存根，自身从不更新
• 安全覆盖：在模块加载之前应用更新
• 后台下载：非阻塞的更新检查
• 版本跟踪：使用 VERSION.txt 进行可靠的版本比较
• 特定平台：为 Windows/Mac 提供单独的软件包

📄 许可证

专有许可 - 详情请参阅 LICENSE 文件。