Skip to main content
Glama
shiguangzhe666

Fusion360 MCP Server

Fusion360 MCP Server

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

MCP-сервер, который подключает AI-агентов кодирования к 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-процесс, который общается с Claude по протоколу MCP и пересылает команды через TCP

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

Related MCP server: Fusion360 MCP Server

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

  • 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)

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

Tool

Description

ping

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

get_scene_info

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

get_object_info

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

list_components

Список всех компонентов в дизайне

Безопасность типа дизайна

Tool

Description

get_design_type

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

set_design_type

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

Эскизы

Tool

Description

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

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

Конструктивные элементы

Tool

Description

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

Возобновление ранее подавленного элемента

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

Tool

Description

move_body

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

rename_body

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

boolean_operation

Объединение/вырезание/объединение двух тел

delete_all

Очистка дизайна

undo

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

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

Tool

Description

create_box

Куб (через TemporaryBRepManager)

create_cylinder

Цилиндр

create_sphere

Сфера

create_torus

Тор

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

Tool

Description

patch_surface

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

stitch_surfaces

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

thicken_surface

Придание толщины поверхности для создания тела

ruled_surface

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

trim_surface

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

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

Tool

Description

create_flange

Фланец на ребре

create_bend

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

flat_pattern

Создание плоской развёртки

unfold

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

Вспомогательная геометрия

Tool

Description

create_construction_plane

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

create_construction_axis

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

Сборка

Tool

Description

create_component

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

add_joint

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

create_as_built_joint

Соединение на основе текущих позиций

create_rigid_group

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

Проверка и анализ

Tool

Description

measure_distance

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

measure_angle

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

get_physical_properties

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

create_section_analysis

Секущая плоскость через модель

check_interference

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

Внешний вид

Tool

Description

set_appearance

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

Параметры

Tool

Description

get_parameters

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

create_parameter

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

set_parameter

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

delete_parameter

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

Экспорт

Tool

Description

export_stl

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

export_step

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

export_f3d

Экспорт дизайна в архив Fusion

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

Tool

Description

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

Сведения об операции (стратегия, инструмент, параметры)

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

Tool

Description

execute_code

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

Возможности MCP Protocol

  • Аннотации инструментов — каждый инструмент помечен 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, если адд-ин сообщает о сбоях

  • Mock-режим--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

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language 3D modeling in Fusion 360 through an MCP server that translates user commands into Fusion 360 API calls. Supports creating, editing, and managing 3D objects, executing Python code, and capturing model views through conversational interactions.
    1
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Connects AI coding agents to Autodesk Fusion 360 for CAD automation, enabling natural language control over sketching, 3D modeling, and CAM operations. It uses a Python-based bridge and a custom add-in to execute over 80 tools ranging from simple geometry creation to complex assembly and parameter management.
    80
    77
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Open-source MCP server for controlling Autodesk Fusion 360 from any AI agent, enabling 3D modeling operations via natural language.
    2
    MIT

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/shiguangzhe666/Fusion360-MCP-AICAD'

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