Skip to main content
Glama
5nail000

fusion-cad-ai

by 5nail000
README.md
# 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`.

## Цикл

`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` | рычаг и упор |

```powershell
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, а не зашиваются в код.

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

ActivityMaintained
ResponsivenessNo issues