AI导哈

AI驱动的CAD自动化工具

Fusion 360 Agentic CAD和MCP服务器通过Model Context Protocol（MCP）将AI助手连接到Autodesk Fusion 360，实现自然语言创建和编辑3D模型、自动化重复建模步骤和参数化控制。

  • by avez1999
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 avez1999/Fusion360-AgenticCAD

使用说明

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。

目录

建筑

您键入 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/<your-username>/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/ （或其中的特定外接程序文件夹）
  5. 点击 跑
  6. 可选启用 启动时运行

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

“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": "<tool_name>", "args": { ... } }

工具命名

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

添加新工具

添加新Fusion工具时：

  1. 熔合侧（附加）

    • 实现一个功能： def _my_tool(payload): ...
    • 在中注册 _TOOL_MAP:
      _TOOL_MAP["my_tool"] = _my_tool

  2. 客户端（Python CLI）

    • 向添加条目 TOOL_ROUTER:
      "fusion_my_tool": ("POST", "my_tool")
    • 在中添加/描述工具架构 SYSTEM 提示，以便模型使用正确的参数。

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

路线图

潜在改进：

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

许可证

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

相关 MCP