Skip to main content
Glama
fusion-cad-ai

fusion-cad-ai

by 5nail000

MCP_Fusion360

Среда Cursor → MCP → Autodesk Fusion. Агент задаёт параметры в миллиметрах, сервер fusion-cad-ai собирает деталь в живом Fusion, проверяет её и только потом копирует STEP, STL, 3MF и F3D в exports/.

Два сервера

.cursor/mcp.json поднимает оба:

  • fusion-official — официальный MCP Fusion на http://127.0.0.1:27182/mcp;

  • fusion-cad-ai — этот репозиторий, stdio через tools/run-fusion-cad-ai.cmd.

По умолчанию агент видит 33 инструмента групп core и assembly. CAM, листовой металл, рендер, объёмные решётки, конфигурации, чертежи и облако включаются переменной FCA_TOOL_GROUPS.

Related MCP server: Fusion MCP para Codex

Цикл

BUILD → VALIDATE → INSPECT → preview → временный файл в .runtime/verify → VERIFY → exports/.

STEP — мастер. STL и 3MF — сетки для печати. Принтеры по умолчанию: Bambu Lab A1 (256 мм, сопло 0.4) и A1 mini (180 мм, сопло 0.4).

Модели

Файл

Что это

models/parts/flange.py

фланец Ø40, 4 отверстия по окружности

models/parts/enclosure.py

корпус 80×40×25, открытый верх

models/parts/print_bracket.py

кронштейн под печать

models/parts/plate_e2e.py

пластина 60×40×6 с двумя Ø5

models/assemblies/pin_joint.py

палец и крышка, зазор 0.2 мм

models/assemblies/motion_stop.py

рычаг и упор

uv run python scripts/run_pipeline.py plate_e2e
uv run pytest
uv run pytest -m fusion

Второй набор тестов требует запущенный Fusion. Окно не сворачивай и не закрывай уже открытые документы: сервер создаёт только FCA_<имя>.

Лицензия кода

MIT. Ограничения лицензии Fusion описаны в docs/license-limits.md и читаются с живого API, а не зашиваются в код.

Available Tools

33 tools
analyze_printabilityC
Read-onlyIdempotent

Влезает ли деталь в Bambu A1 или A1 mini.

Inputs: printer, nozzle_mm, support_angle_deg.

assembly_add_partC

Компонент сборки и, если задан source, модель из models/.

Inputs: name (required), source (required), role, placement_mm, +1 more.

compareC
Read-onlyIdempotent

Сравнение shape, fit, align или snapshot.

Inputs: a (required), b, kind.

cross_sectionsC
Read-onlyIdempotent

Площади сечений вдоль оси.

Inputs: axis, num_slices.

design_auditD

Шевелит параметры на ±ε и откатывает.

Inputs: epsilon, max_params.

executeC

Python в песочнице Fusion. Хелперы: make_box_mm, mm, show, measure.

Inputs: code (required), timeout_s.

execute_fileC

Собрать models/*.py. При ошибке откатывает снимок.

Inputs: path (required), snapshot, params_json, result_name.

exportD
Idempotent

Проверочный файл, затем копия в exports/. STEP — мастер.

Inputs: filename (required), force, formats, object_name.

find_featuresD
Read-onlyIdempotent

Отверстия и окружности болтов.

Inputs: family (required).

health_checkB
Read-onlyIdempotent

Связь с Fusion, лицензия, билд и хеш runtime.

Inputs: no named parameters.

import_cad_fileC

STEP, F3D, SMT или сетка в активный FCA-документ.

Inputs: path (required), name.

inspect_partC
Read-onlyIdempotent

Сверка с expected_json: PASS или FAIL.

Inputs: object_name, expected_json.

interferenceB
Read-onlyIdempotent

Пересечения тел. Пустой список — все тела документа.

Inputs: objects, include_coincident.

job_statusC
Read-onlyIdempotent

Состояние долгой задачи CAM или рендера.

Inputs: job_id (required).

joint_createD

Шарнир rigid, revolute, slider, cylindrical, pin-slot, planar или ball.

Inputs: a (required), b (required), kind (required), limits.

last_errorC
Read-onlyIdempotent

Последняя ошибка runtime и Application.getLastError.

Inputs: no named parameters.

locate_defectsC
Read-onlyIdempotent

Ошибки таймлайна.

Inputs: no named parameters.

measureD
Read-onlyIdempotent

Объём мм³, bbox мм, площадь мм², масса г.

Inputs: material, object_name, density_g_cm3.

motion_sweepC

Прогон шарнира по углу. В конце положение возвращается.

Inputs: stop (required), joint (required), start (required), steps.

new_designC

Документ FCA_<имя>, Parametric, Hybrid, миллиметры.

Inputs: name (required), design_intent.

params_getD
Read-onlyIdempotent

User parameters и diff с dataclass модели.

Inputs: model.

params_setC
Idempotent

Меняет параметры. Каждое значение — {value, unit}.

Inputs: values (required).

render_viewD
Read-onlyIdempotent

PNG в renders/ и base64 в ответе.

Inputs: colors, objects, save_to, width_px, +7 more.

repair_hintsC
Read-onlyIdempotent

Подсказка по тексту ошибки Fusion.

Inputs: error_text (required), goal.

resetB
Destructive

Очищает таймлайн только FCA-документа. Нужен confirm=true.

Inputs: confirm (required).

resolveD
Idempotent

Селектор, атрибут и entityToken.

Inputs: selector (required), object_name (required), label.

restore_snapshotC
Idempotent

Откат к снимку.

Inputs: name (required).

save_snapshotC
Idempotent

Снимок выражений, маркера таймлайна и метрик.

Inputs: name (required).

scriptC
Read-onlyIdempotent

Журнал выполненных блоков execute.

Inputs: no named parameters.

session_stateC
Read-onlyIdempotent

Активный FCA-документ, тела и пространство execute.

Inputs: no named parameters.

validateD
Read-onlyIdempotent

Здоровье таймлайна, solid, объём. deep проверяет STEP.

Inputs: deep, object_name.

versionB
Read-onlyIdempotent

Версия пакета fusion-cad-ai и конверта.

Inputs: no named parameters.

workflow_hintsC
Read-onlyIdempotent

Цикл BUILD → VERIFY и правила единиц.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.2/5.0

    Scored across 33 tools

    Disambiguation3/5

    Most tools target distinct CAD operations, but several clusters overlap: execute/execute_file/script for code execution and logging, validate/locate_defects/inspect_part/compare/design_audit for validation and comparison, and last_error/repair_hints for diagnostics. Descriptions help, but an agent could still misselect among these related tools.

    Naming Consistency3/5

    The set is mostly lower snake_case, but ordering is inconsistent: some are verb_noun (save_snapshot, locate_defects), some noun_verb (params_get, params_set, assembly_add_part, joint_create, motion_sweep), and others are bare nouns (script, session_state, job_status). It remains readable but lacks a predictable convention.

    Tool Count2/5

    With 33 tools, the surface is heavy for a single MCP server and likely exceeds what an agent can hold coherently. Several validation, diagnostics, and execution tools could be consolidated or grouped to reduce selection burden.

    Completeness4/5

    The surface covers a broad CAD lifecycle: document creation, execution, parameters, snapshots, measurement, validation, import/export, rendering, assembly, joints, motion, and printability. Minor gaps exist, such as delete/remove operations for bodies, components, or joints, and listing existing documents or snapshots.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to inspect and automate Autodesk Fusion 360 through MCP, providing tools for CAD modeling, CAM manufacturing, and document management.
      -
    • A
      license
      C
      quality
      C
      maintenance
      Enables MCP-compatible assistants to control Autodesk Fusion for mechanical modeling, assembly editing, CAM workflows, inspection, and model export through Fusion's native MCP endpoint.
      39
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables controlling Autodesk Fusion 360 from any MCP-compatible AI client through natural language. Exposes tools for creating sketches, drawing rectangles and circles, extruding, revolving, filleting, shelling, drilling holes and bolt-circle patterns, managing user parameters, and exporting STEP/STL files, plus batch generation of parametric variants.
      15
      MIT