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Два компонента:
MCP Server (этот репозиторий) — процесс Python, который общается по протоколу MCP с Claude и пересылает команды по TCP.
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}, значит, всё подключено.
Удаление
Удалите запись
fusion360из конфигурации вашего MCP-клиента.Остановите надстройку во Fusion (Shift+S → Add-Ins → Fusion360MCP → Stop).
Удалите папку надстройки из каталога AddIns во Fusion.
Доступные инструменты (84)
Сцена и запросы
Инструмент | Описание |
| Проверка работоспособности (мгновенно, без Fusion API) |
| Имя проекта, тела, эскизы, элементы, камера |
| Подробная информация об именованном теле или эскизе |
| Список всех компонентов в проекте |
Безопасность типов проекта
Инструмент | Описание |
| Проверка, находится ли проект в параметрическом или прямом режиме |
| Переключение типа проекта (параметрический/прямой) |
Эскизы
Инструмент | Описание |
| Новый эскиз на плоскости xy/yz/xz, опциональное смещение |
| Прямоугольник в последнем эскизе |
| Окружность в последнем эскизе |
| Линия в последнем эскизе |
| Дуга (центр + начало + угол развертки) |
| Сплайн по точкам или контрольным точкам |
| Правильный многоугольник (3–64 стороны) |
| Геометрическое ограничение (совпадение, параллельность, касательность и т. д.) |
| Управляющий размер (расстояние, угол, радиус, диаметр) |
| Смещение связанных кривых эскиза |
| Обрезка на пересечениях |
| Удлинение до ближайшего пересечения |
| Проецирование ребер/тел на плоскость эскиза |
Элементы
Инструмент | Описание |
| Выдавливание профиля эскиза |
| Вращение профиля вокруг оси |
| Сдвиг профиля вдоль пути |
| Лофтинг между двумя или более профилями |
| Скругление ребер (все/верх/низ/вертикальные) |
| Фаска на ребрах |
| Создание оболочки тела |
| Зеркальное отражение тела относительно плоскости |
| Элемент отверстия на грани тела |
| Массив в строках и столбцах |
| Массив вокруг оси |
| Добавление резьбы (косметическая или моделируемая) |
| Уклон граней для литейной формы |
| Разделение тела с помощью плоскости |
| Разделение граней тела |
| Смещение граней на расстояние |
| Масштабирование равномерно или неравномерно |
| Подавление элемента на временной шкале |
| Восстановление подавленного элемента |
Операции с телами
Инструмент | Описание |
| Перемещение тела на (x, y, z) |
| Переименование тела (поиск в корне и всех компонентах) |
| Объединение/вычитание/пересечение двух тел |
| Очистка проекта |
| Отмена последней операции (с защитой типа проекта) |
Прямые примитивы
Инструмент | Описание |
| Параллелепипед (через TemporaryBRepManager) |
| Цилиндр |
| Сфера |
| Тор |
Операции с поверхностями
Инструмент | Описание |
| Создание заплатки из граничных ребер |
| Сшивание поверхностных тел в одно |
| Утолщение поверхности в твердое тело |
| Линейчатая поверхность из ребра |
| Обрезка поверхности другим телом |
Листовой металл
Инструмент | Описание |
| Создание фланца на ребре |
| Добавление сгиба |
| Создание развертки |
| Развертывание определенных сгибов |
Конструкционная геометрия
Инструмент | Описание |
| Смещение, угол, средняя плоскость, по 3 точкам, касательная |
| По двум точкам, пересечение, ребро, перпендикуляр |
Сборка
Инструмент | Описание |
| Создание компонента сборки |
| Соединение между двумя компонентами |
| Соединение из текущих положений |
| Жесткая фиксация компонентов |
Инспекция и анализ
Инструмент | Описание |
| Минимальное расстояние между объектами |
| Угол между объектами |
| Масса, объем, площадь, центр масс |
| Плоскость сечения через модель |
| Обнаружение столкновений между компонентами |
Внешний вид
Инструмент | Описание |
| Назначение материала из библиотеки |
Параметры
Инструмент | Описание |
| Список всех пользовательских параметров |
| Создание нового параметра |
| Обновление значения параметра |
| Удаление параметра |
Экспорт
Инструмент | Описание |
| Экспорт тела в STL (поддерживает тела внутри компонентов) |
| Экспорт тела в STEP (поддерживает тела внутри компонентов) |
| Экспорт проекта в архив Fusion |
CAM / Производство
Инструмент | Описание |
| Создание производственной настройки (фрезерование/точение/резка) |
| Добавление операции обработки (торцевание, контур, адаптивная, сверление и т. д.) |
| Генерация траекторий для операций |
| Постпроцессирование в G-код (fanuc, grbl, haas и т. д.) |
| Список всех производственных настроек |
| Список операций в настройке |
| Получение деталей операции (стратегия, инструмент, параметры) |
Выполнение кода
Инструмент | Описание |
| Выполнение произвольного 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
Maintenance
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
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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
