fusion-reconstruct-mcp

MCP-сервер, который позволяет LLM превратить STL/3MF-сетку (или эталонное фото) в параметрическую модель Fusion 360 — перестроенную по фичам (эскизы, выдавливания, скругления, массивы...), а не импортированную как «тупая» mesh-модель.

Зачем

Слайсеры (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_* (создать эскиз, добавить линию/окружность/прямоугольник/дугу, выдавить, вращать, скруглить, фаска, массив, зеркало, объединить, задать/вывести параметры, экспорт, скриншот, ...) — общение с сопутствующим аддином Fusion 360 через http://127.0.0.1:6172, который выполняет их через реальный API adsk.fusion внутри запущенного сеанса Fusion.

См. docs/ARCHITECTURE.md о том, почему выбрано такое разделение (кратко: API Fusion работает только внутри процесса самого Fusion, в его главном потоке, без доступа к 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/ в папку AddIns Fusion и запустите его через 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) имел реальный баг, который был исправлен (setByThreePoints требует точечные сущности, а не сырые Point3D — см. историю git), но после этого так и не был подтверждён рабочим: при следующей попытке появилась вторая, другая ошибка («Environment is not supported» от ConstructionPoints.add), которая исчезла после перезапуска аддина — похоже, это временное состояние Fusion, а не баг кода, но этот путь был обойдён, а не перепроверен. Считайте его непроверенным, пока кто-нибудь не подтвердит его вживую.

• Собран и дымово протестирован против API MCPServer из mcp>=2.0.0. Действия на стороне Fusion были опробованы на реальном запущенном сеансе Fusion 360 (а не просто написаны по документации) — см. tests/smoke_test_fusion_live.py (эскиз → выдавливание → вырез/объединение → экспорт, проверено по исходной сетке с точностью до 0,01 мм) и tests/smoke_test_fusion_live_features.py (скругление, фаска, зеркало, круговой массив, вращение, явное объединение). sketch_add_line, sketch_add_arc_three_point и pattern_rectangular используют общие пути кода с протестированными собратьями, но пока не имеют собственного отдельного живого теста. Ничто из этого не запускается в CI (нет headless Fusion) — вопросы и PR по fusion_addin/ приветствуются в любом случае.

Лицензия

MIT — см. LICENSE.