fusion-reconstruct-mcp

一个 MCP 服务器，让 LLM 将 STL/3MF 网格（或参考照片）转换为参数化 Fusion 360 模型——逐个特征重建（草图、拉伸、圆角、阵列...），而不是作为无法参数化编辑的网格实体导入。

为什么

切片器（Bambu Studio、PrusaSlicer 等）只理解 STL/3MF：固化的三角网格。Fusion 360 只理解参数化特征树。将 STL 导入 Fusion 会得到一个可以看但无法有意义编辑的实体——没有参数化尺寸，没有可编辑草图，没有任何可以拖动滑块的内容。本项目通过让 LLM 查看网格、弄清楚它由什么构成（板、孔、凸台、加强筋...），并将其重建为真正的 Fusion 特征来弥合这一差距——这样你就能得到一个实际上可以调整大小、添加孔，或者像修改手工制作的模型那样进行其他修改的模型。

Related MCP server: Fusion360 LLM Assistant

范围（先读这个）

这针对机械/功能零件——支架、外壳、安装座、带螺栓孔的板、凸台——从基本特征（拉伸、旋转、圆角、倒角、阵列、镜像、布尔运算）重建。它不尝试自由形态/有机曲面重建；这是一个困难得多、可靠性更低的问题，本项目不会尝试解决。预期工作流程见 docs/RECONSTRUCTION_STRATEGY.md。

工作原理

flowchart LR
    LLM["LLM client"] -- MCP --> Server["MCP server<br/>(mesh analysis + Fusion bridge client)"]
    Server -- HTTP, localhost --> Addin["Fusion 360 add-in<br/>(runs inside Fusion)"]
    Addin --> Fusion[("Your live Fusion design")]

MCP 服务器公开两类工具：

• mesh_summary、find_circular_holes、find_circular_faces、list_planar_facets、get_cross_section、render_orthographic_views、compare_meshes - 纯粹的网格分析（trimesh），不需要 Fusion。用于理解输入文件，并在之后对照它检查重建的精度。

• fusion_*（创建草图、添加直线/圆/矩形/圆弧、拉伸、旋转、圆角、倒角、阵列、镜像、合并、设置/列出参数、导出、截图...）- 通过 http://127.0.0.1:6172 与配套的 Fusion 360 附加模块通信，该模块在正在运行的 Fusion 会话中针对真实的 adsk.fusion API 执行这些操作。

参见 docs/ARCHITECTURE.md 了解为何这样拆分（简而言之：Fusion 的 API 只能在其自身进程的主线程内运行，且无法访问 pip——因此附加模块必须是一个仅使用标准库的小型 HTTP 桥）。

设置

完整说明参见 docs/SETUP.md。简而言之：

git clone https://github.com/<your-username>/fusion-reconstruct-mcp.git
cd fusion-reconstruct-mcp
python -m venv .venv && source .venv/bin/activate  # .venv\Scripts\activate on Windows
pip install -r requirements.txt

然后将 fusion_addin/FusionReconstructBridge/ 复制到 Fusion 的 AddIns 文件夹，从 Utilities > Add-Ins > Scripts and Add-Ins 启动它，并将你的 MCP 客户端（claude mcp add ... 或你的 mcp.json）指向此仓库中的 python -m server.mcp_server。

用法

在 Fusion 运行且附加模块已启动的情况下，向你的 LLM 客户端发出类似这样的请求：

将 ~/Downloads/bracket.stl 重建为参数化 Fusion 360 模型，然后导出 并检查它与原始模型的接近程度。

它会检查网格、查看渲染视图、定位孔/凸台、在 Fusion 中逐个特征重建零件，并通过导出与源网格进行差异比较来验证结果。如果输入是照片而非网格，它会根据你的描述/图像构建第一版，然后与你交互式地完善它——单张照片中没有真实尺寸数据，因此请将这条路径视为“辅助建模”，而非“扫描到 CAD”。

状态 / 限制

• 圆/孔检测是一种网格细分启发式方法（面片轮廓圆拟合）

  • 它在典型的可打印零件上效果良好，但不是通用的特征识别引擎。

  • 基于照片的重建估算比例；它无法从单张图像测量真实世界尺寸。

• render_orthographic_views 使用普通的 matplotlib 线框/实体渲染器（无 GPU 依赖）——足以查看整体形状，不是照片级真实感，并且可能在复杂零件上显示轻微的 z 排序伪影。

• 一次只能有一个 Fusion 文档/桥接连接。

• fusion_create_sketch 的命名基准平面路径（plane="XY"/"XZ"/"YZ"，可选 offset_mm）已通过现场充分验证。其任意平面路径（origin+normal）曾修复过一个真实 bug（setByThreePoints 需要点 实体，而不是原始 Point3D——参见 git 历史），但之后再未确认可用：下一次尝试时出现了第二个不同错误（来自 ConstructionPoints.add 的 “Environment is not supported”），重启附加模块后消失，这看起来像是 Fusion 的瞬时状态而非代码 bug，但该路径被绕过而不是重新测试。在有人现场确认之前，请将其视为未经验证。

• 针对 mcp>=2.0.0 的 MCPServer API 构建并进行了冒烟测试。Fusion 端操作都已在真实运行中的 Fusion 360 会话中演练过（不仅仅是根据文档编写）——参见 tests/smoke_test_fusion_live.py（草图 → 拉伸 → 剪切/合并 → 导出，与原始网格对照验证，误差在 0.01mm 以内）和 tests/smoke_test_fusion_live_features.py（圆角、倒角、镜像、环形阵列、旋转、显式合并）。sketch_add_line、sketch_add_arc_three_point 和 pattern_rectangular 与已测试的同类功能共享代码路径，但还没有各自的专门现场测试。这些都不会在 CI 中运行（因为没有无头 Fusion）——无论如何，非常欢迎针对 fusion_addin/ 提交 issue/PR。

许可证

MIT - 见 LICENSE。