VOOZH about

URL: https://glama.ai/mcp/servers/faust-machines/fusion360-mcp-server?locale=ru-RU

⇱ Fusion360 MCP Server by faust-machines | Glama


Fusion360 MCP Server

Бета-версия — проект находится в стадии активной разработки. API и поведение инструментов могут меняться от версии к версии. Используйте на свой страх и риск. Отзывы и сообщения об ошибках приветствуются через GitHub Issues.

MCP-сервер, который подключает ИИ-агентов для написания кода к Autodesk Fusion 360 для автоматизации CAD.

Протестировано с Claude Code. Работает с любым MCP-совместимым клиентом — OpenCode, Codex, Cursor или любым другим, поддерживающим Model Context Protocol.

Как это работает

Any MCP Client ←(stdio MCP)→ This Server ←(TCP :9876)→ Fusion360MCP Add-in ←(CustomEvent)→ Fusion Main Thread

Два компонента:

  1. MCP Server (этот репозиторий) — процесс Python, который общается по протоколу MCP с Claude и пересылает команды по TCP.

  2. Fusion360MCP Add-in (устанавливается в папку AddIns Fusion) — работает внутри Fusion 360, безопасно выполняя вызовы API в основном потоке.

Related MCP server: Fusion360 LLM Assistant

Предварительные требования

  • uv (менеджер пакетов Python)

  • Autodesk Fusion 360

  • MCP-совместимый клиент (Claude Code, OpenCode, Codex, Cursor и т. д.)

Установка

1. Установка надстройки Fusion 360

Быстрая установка (символическая ссылка для разработки):

./scripts/install-addon.sh

Ручная установка:

# macOS
cp -r addon ~/Library/Application\ Support/Autodesk/Autodesk\ Fusion\ 360/API/AddIns/Fusion360MCP

# Windows (PowerShell)
Copy-Item -Recurse addon "$env:APPDATA\Autodesk\Autodesk Fusion 360\API\AddIns\Fusion360MCP"

Затем запустите её во Fusion: Shift+S → Add-Ins → Fusion360MCP → Run

Вы должны увидеть [MCP] Server listening on localhost:9876 в окне TEXT COMMANDS.

2. Подключение вашего MCP-клиента

MCP-сервер опубликован на PyPI — клонировать этот репозиторий не нужно.

Claude Code

claude mcp add fusion360 -- uvx fusion360-mcp-server --mode socket

Другие MCP-клиенты

Сервер работает через stdio, поэтому любой MCP-совместимый клиент может его запустить. Команда:

uvx fusion360-mcp-server --mode socket
{
 "mcpServers": {
 "fusion360": {
 "command": "uvx",
 "args": [
 "fusion360-mcp-server",
 "--mode", "socket"
 ]
 }
 }
}

3. Проверка

Вызовите инструмент ping из вашего клиента. Если он вернет {"pong": true}, значит, всё подключено.

Удаление

  1. Удалите запись fusion360 из конфигурации вашего MCP-клиента.

  2. Остановите надстройку во Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop).

  3. Удалите папку надстройки из каталога AddIns во Fusion.

Доступные инструменты (84)

Сцена и запросы

Инструмент

Описание

ping

Проверка работоспособности (мгновенно, без Fusion API)

get_scene_info

Имя проекта, тела, эскизы, элементы, камера

get_object_info

Подробная информация об именованном теле или эскизе

list_components

Список всех компонентов в проекте

Безопасность типов проекта

Инструмент

Описание

get_design_type

Проверка, находится ли проект в параметрическом или прямом режиме

set_design_type

Переключение типа проекта (параметрический/прямой)

Эскизы

Инструмент

Описание

create_sketch

Новый эскиз на плоскости xy/yz/xz, опциональное смещение

draw_rectangle

Прямоугольник в последнем эскизе

draw_circle

Окружность в последнем эскизе

draw_line

Линия в последнем эскизе

draw_arc

Дуга (центр + начало + угол развертки)

draw_spline

Сплайн по точкам или контрольным точкам

create_polygon

Правильный многоугольник (3–64 стороны)

add_constraint

Геометрическое ограничение (совпадение, параллельность, касательность и т. д.)

add_dimension

Управляющий размер (расстояние, угол, радиус, диаметр)

offset_curve

Смещение связанных кривых эскиза

trim_curve

Обрезка на пересечениях

extend_curve

Удлинение до ближайшего пересечения

project_geometry

Проецирование ребер/тел на плоскость эскиза

Элементы

Инструмент

Описание

extrude

Выдавливание профиля эскиза

revolve

Вращение профиля вокруг оси

sweep

Сдвиг профиля вдоль пути

loft

Лофтинг между двумя или более профилями

fillet

Скругление ребер (все/верх/низ/вертикальные)

chamfer

Фаска на ребрах

shell

Создание оболочки тела

mirror

Зеркальное отражение тела относительно плоскости

create_hole

Элемент отверстия на грани тела

rectangular_pattern

Массив в строках и столбцах

circular_pattern

Массив вокруг оси

create_thread

Добавление резьбы (косметическая или моделируемая)

draft_faces

Уклон граней для литейной формы

split_body

Разделение тела с помощью плоскости

split_face

Разделение граней тела

offset_faces

Смещение граней на расстояние

scale_body

Масштабирование равномерно или неравномерно

suppress_feature

Подавление элемента на временной шкале

unsuppress_feature

Восстановление подавленного элемента

Операции с телами

Инструмент

Описание

move_body

Перемещение тела на (x, y, z)

rename_body

Переименование тела (поиск в корне и всех компонентах)

boolean_operation

Объединение/вычитание/пересечение двух тел

delete_all

Очистка проекта

undo

Отмена последней операции (с защитой типа проекта)

Прямые примитивы

Инструмент

Описание

create_box

Параллелепипед (через TemporaryBRepManager)

create_cylinder

Цилиндр

create_sphere

Сфера

create_torus

Тор

Операции с поверхностями

Инструмент

Описание

patch_surface

Создание заплатки из граничных ребер

stitch_surfaces

Сшивание поверхностных тел в одно

thicken_surface

Утолщение поверхности в твердое тело

ruled_surface

Линейчатая поверхность из ребра

trim_surface

Обрезка поверхности другим телом

Листовой металл

Инструмент

Описание

create_flange

Создание фланца на ребре

create_bend

Добавление сгиба

flat_pattern

Создание развертки

unfold

Развертывание определенных сгибов

Конструкционная геометрия

Инструмент

Описание

create_construction_plane

Смещение, угол, средняя плоскость, по 3 точкам, касательная

create_construction_axis

По двум точкам, пересечение, ребро, перпендикуляр

Сборка

Инструмент

Описание

create_component

Создание компонента сборки

add_joint

Соединение между двумя компонентами

create_as_built_joint

Соединение из текущих положений

create_rigid_group

Жесткая фиксация компонентов

Инспекция и анализ

Инструмент

Описание

measure_distance

Минимальное расстояние между объектами

measure_angle

Угол между объектами

get_physical_properties

Масса, объем, площадь, центр масс

create_section_analysis

Плоскость сечения через модель

check_interference

Обнаружение столкновений между компонентами

Внешний вид

Инструмент

Описание

set_appearance

Назначение материала из библиотеки

Параметры

Инструмент

Описание

get_parameters

Список всех пользовательских параметров

create_parameter

Создание нового параметра

set_parameter

Обновление значения параметра

delete_parameter

Удаление параметра

Экспорт

Инструмент

Описание

export_stl

Экспорт тела в STL (поддерживает тела внутри компонентов)

export_step

Экспорт тела в STEP (поддерживает тела внутри компонентов)

export_f3d

Экспорт проекта в архив Fusion

CAM / Производство

Инструмент

Описание

cam_create_setup

Создание производственной настройки (фрезерование/точение/резка)

cam_create_operation

Добавление операции обработки (торцевание, контур, адаптивная, сверление и т. д.)

cam_generate_toolpath

Генерация траекторий для операций

cam_post_process

Постпроцессирование в G-код (fanuc, grbl, haas и т. д.)

cam_list_setups

Список всех производственных настроек

cam_list_operations

Список операций в настройке

cam_get_operation_info

Получение деталей операции (стратегия, инструмент, параметры)

Выполнение кода

Инструмент

Описание

execute_code

Выполнение произвольного Python во Fusion (в стиле REPL)

Особенности протокола MCP

  • Аннотации инструментов — каждый инструмент помечен readOnlyHint, destructiveHint и idempotentHint, чтобы MCP-клиенты могли автоматически одобрять безопасные операции.

  • Ресурсыfusion360://status, fusion360://design, fusion360://parameters для пассивного контроля состояния.

  • Шаблоны ресурсовfusion360://body/{name}, fusion360://component/{name} для динамического поиска сущностей.

  • Промпты — шаблоны рабочих процессов create-box, model-threaded-bolt, sheet-metal-enclosure.

  • Структурированные ошибки — результаты инструментов включают isError=True, когда надстройка сообщает о сбоях.

  • Режим имитации--mode mock возвращает правдоподобные тестовые данные без запуска Fusion (все ответы включают "mode": "mock").

Разработка

uv sync --dev # install deps
uv run pytest -v # run tests (171 tests)
uv run ruff check # lint

Примечания

  • Все единицы измерения Fusion API — сантиметры (внутренняя единица Fusion).

  • Одна операция на вызов инструмента. Пакетная обработка нескольких операций приводит к сбою надстройки.

  • Время ожидания команд — 30 секунд.

  • Логи надстройки записываются в ~/fusion360mcp.log.

  • Инструмент undo включает защиту типа проекта — он проверяет состояние до/после и автоматически повторяет действие, если отмена привела бы к переключению из параметрического режима в прямой.

Благодарности

Вдохновлено BlenderMCP — архитектура сокетного моста заимствована оттуда.

Также основано на идеях из существующей экосистемы Fusion 360 MCP:

Лицензия

MIT

A
license - permissive license
B
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/faust-machines/fusion360-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server