Fusion360 Agentic Cad

Fusion 360 Agent CAD和MCP服务器

Fusion MCP Integration通过模型上下文协议（MCP）将AI助手连接到Autodesk Fusion 360，从而实现：

✨ 对话式CAD --使用自然语言创建和编辑3D模型\ 🤖 人工智能驱动的自动化 --自动化重复的建模步骤和工作流\ 🔧 参数控制 --通过参数更新尺寸、特征和图案\ 🎓 更易于使用的CAD --减少非CAD用户的学习曲线

轻量级 代理/程序化CAD 工作流程 Autodesk Fusion 360:

• A. Fusion插件 在Fusion中暴露了一个小型HTTP“桥”（工具服务器）。
• A. Python CLI客户端 与该网桥进行通信，并将LLM工具调用路由到Fusion。
• 您可以创建参数化零件（法兰、孔、填充图案），并随着时间的推移扩展工具集。

✅ 在Windows上本地运行。\ ⚠️ 此回购确实 不 搭载Autodesk Fusion 360。您必须安装并运行Fusion。

______________________________________________________________________

目录

• 建筑
• 仓库的规划
• 先决条件
• 快速开始
• 安装Fusion插件
• 配置环境变量
• 运行客户端
• 示例提示
• 融合桥API
• 添加新工具
• 故障排除
• 安全说明
• 路线图
• 许可证

______________________________________________________________________

建筑

您键入 CAD请求→ Python客户端 调用LLM→ LLM返回结构化JSON工具调用→ 客户端 向本地发送工具请求 FusionBridge → Fusion插件 在Fusion内部执行操作。

User Prompt
   │
   ▼
client/chat_cli.py  ──(LLM tool JSON)──▶  FusionBridge HTTP (inside Fusion)
   │                                      │
   └──────────────(tool_result JSON)◀─────┘

______________________________________________________________________

仓库的规划

典型结构：

FusionAgenticCAD/
  client/                 # Python CLI client (LLM + tool router)
  fusion_addin/            # Fusion 360 add-in: HTTP bridge + tools
  mcp_server/              # Future integrations 
  Recordings-Example/      # demo recordings, screenshots, examples
  .env.example             # environment template
  README.md
  LICENSE

______________________________________________________________________

先决条件

必需的

• Autodesk Fusion 360 已安装并正在运行
• Python 3.10+
• 终端（建议在Windows上使用PowerShell）
• OpenAI API密钥（或您配置的任何模型提供程序）

Python包

• httpx
• python-dotenv
• openai

（推荐：包括 client/requirements.txt 在您的repo中。)

______________________________________________________________________

快速开始

1） 克隆存储库

git clone https://github.com//FusionAgenticCAD.git
cd FusionAgenticCAD

2） 创建Python虚拟环境

Windows（PowerShell）：

python -m venv .venv
.\.venv\Scripts\Activate.ps1

3） 安装Python依赖项

pip install -r client\requirements.txt

4） 复制 .env.example → .env

copy .env.example .env

然后编辑 .env 与你的价值观（见下文）。

5） 安装并运行Fusion加载项

按照中的步骤进行操作 安装Fusion插件.

6） 启动客户端

python client\chat_cli.py

______________________________________________________________________

安装Fusion插件

Fusion加载项从Fusion的add-ins目录加载。

选项A（推荐）：使用Fusion的“加载项”对话框

1. 打开 Fusion 360
2. 首选 公用事业→ 加载项
3. 点击 + （添加）或转到 加载项 标签
4. 选择此仓库中的文件夹：

- fusion_addin/ （或其中的特定外接程序文件夹）

1. 点击 跑
2. 可选启用 启动时运行

✅ 当网桥成功启动时，您应该看到以下消息：

“FusionBridge HTTP正在运行http://127.0.0.1:18080”

选项B：复制到Fusion Add-ins文件夹（手动）

将加载项文件夹复制到Fusion的加载项目录中（因安装/用户而异）。

Windows上的常见位置：

• %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns

然后从以下位置加载 公用事业→ 加载项.

______________________________________________________________________

配置环境变量

创建 .env 从 .env.example 并填写：

OPENAI_API_KEY=your_api_key_here
FUSION_BRIDGE_URL=http://127.0.0.1:18080
FUSION_BRIDGE_TOKEN=your_shared_token_here

重要

• FUSION_BRIDGE_TOKEN 必须匹配 Fusion插件服务器脚本中的令牌(AUTH_TOKEN).
• 永不承诺 .env 添加到GitHub（添加到 .gitignore).

______________________________________________________________________

运行客户端

从repo根目录：

python client\chat_cli.py

您应该看到：

• CLI横幅
• 示例提示
• 然后a You: 提示

______________________________________________________________________

示例提示

请在Fusion打开且加载项运行后尝试这些操作。

______________________________________________________________________

1） 长方体（参数化实体）

提示

• Create a box: length 80 mm, width 50 mm, height 30 mm. Add 4 corner fillets (R=3 mm). \[可以指定草图平面\]

预览

______________________________________________________________________

2） 圆柱体（基本旋转/拉伸）

提示

• Create a cylinder: diameter 40 mm, height 60 mm.
• 创建半径为40毫米的圆，并拉伸10毫米高。\[可以指定草图平面\]

预览

______________________________________________________________________

3） 带螺栓图案+埋头孔的法兰

提示

• Create a flange: disc OD 120 mm, thickness 12 mm; hub OD 70 mm, hub height 20 mm; bore 35 mm. \[可以指定草图平面\]
• Add 6 bolt holes: BCD 90 mm, hole dia 8 mm.

预览

______________________________________________________________________

4） 清理（重置工作区）

提示

• Delete everything and reset the design to an empty state.

______________________________________________________________________

融合桥API

Fusion插件公开了以下工具：

• GET /ping
• GET /state
• POST /tool 使用JSON：

  { "tool": "", "args": { ... } }

工具命名

客户端工具路由器必须与外接程序匹配 _TOOL_MAP 钥匙准确。

______________________________________________________________________

添加新工具

添加新Fusion工具时：

1. 熔合侧（附加）

- 实现一个功能： def _my_tool(payload): ... - 在中注册 _TOOL_MAP:

     _TOOL_MAP["my_tool"] = _my_tool

1. 客户端（Python CLI）

- 向添加条目 TOOL_ROUTER:

     "fusion_my_tool": ("POST", "my_tool")

- 在中添加/描述工具架构 SYSTEM 提示，以便模型使用正确的参数。

1. 重新启动Fusion加载项+重新启动客户端。

______________________________________________________________________

路线图

潜在改进：

• 更强大的面部/身体选择助手（按角色选择）
• 轴、壳体、齿轮的参数化模板
• 草图/轮廓创建的自动重试策略
• 单元测试+黄金几何示例

______________________________________________________________________

许可证

麻省理工学院许可证-版权所有（c）2026 Avez Shaikh 看 LICENSE.