MaxForge MCP

Позволяет ИИ-агенту (Claude или любому другому, кто говорит на MCP) управлять живым сеансом 3ds Max — не генерируя скрипты для вставки человеком, а фактически создавая, редактируя и анимируя объекты в реальном времени, пока Max открыт.

Обычно получение помощи ИИ в 3ds Max означает, что он пишет скрипт, а вы запускаете его сами, не зная, сработал ли он. Это замыкает цикл: агент может запрашивать реальное состояние сцены до и после каждого действия, замечать свои ошибки и итерироваться вживую, а не гадать.

Что он умеет

Каждая мутация обёрнута в настоящий блок отмены — всё, что делает агент, можно отменить обычным Ctrl+Z.

Related MCP server: Maya MCP Server

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

AI agent (MCP client) --stdio--> server/max_mcp_server.py --TCP, localhost only--> max_side/bridge.py (inside 3ds Max)

Небольшой Python-мост запускается внутри 3ds Max, загружается через стартовый скрипт и открывает сокет, привязанный только к 127.0.0.1. MCP-сервер вне Max подключается к нему и предоставляет описанные выше инструменты. Каждая команда выполняется в главном потоке Max через Qt-таймер — SDK 3ds Max не потокобезопасен, поэтому команды, поступающие в поток сокета, ставятся в очередь и обрабатываются в главном цикле, а не выполняются напрямую.

max_side/
  bridge.py      socket + main-thread queue (the only place pymxs is touched)
  commands.py    one function per tool, each wrapped in an undo block
  serialize.py   converts pymxs values (Point3, Matrix3, nodes, ...) to JSON
  startup_stub.ms   drop into Max's startup scripts folder
server/
  client.py         TCP client, newline-delimited JSON
  tools.py           MCP tool definitions
  max_mcp_server.py  the MCP server itself (stdio transport)

Установка

Требования: 3ds Max 2022+ (pymxs), Python 3.10+ на машине, где работает MCP-сервер, uv.

1. Установите зависимости

uv sync

2. Загрузите мост в 3ds Max

Скопируйте max_side/startup_stub.ms в папку стартовых скриптов Max — обычно:

%LOCALAPPDATA%\Autodesk\3dsMax\<version>\ENU\scripts\startup\

Откройте скопированный startup_stub.ms и установите MAXFORGE_REPO_PATH в место, куда вы клонировали этот репозиторий. Он автоматически запускает мост на порту 47823 при следующем запуске Max. Также регистрируются три макроскрипта (категория "MaxForge MCP") для ручного управления — Start / Stop / Reload — чтобы вы могли подхватывать изменения кода без перезапуска Max.

3. Направьте на него MCP-клиент

Для Claude Code:

claude mcp add maxforge -- <repo>\.venv\Scripts\python.exe <repo>\server\max_mcp_server.py

Или подключите server/max_mcp_server.py в конфиг любого другого MCP-совместимого клиента аналогичным образом.

Безопасность

Сокет всегда привязывается только к 127.0.0.1 — никогда к сети. Это конечная точка выполнения кода внутри приложения для моделирования; она предназначена для доступа только с той же машины, на которой работает.

Статус

Протестировано вживую на работающем сеансе Max 2025 с полным набором проверок на основе утверждений (29/29 проверок), охватывающим каждый инструмент, каждый путь ошибок и цикл отмены/повтора.

create_collision_proxy в настоящее время создаёт только универсальный прямоугольник, выровненный по осям — он ещё не настроен под формат коллизий какого-либо конкретного игрового движка.

Добавление нового инструмента

1. Добавьте обработчик в max_side/commands.py, обёрнутый в undoable("MCP: ..."), зарегистрированный в словаре COMMANDS.

2. Добавьте соответствующий враппер в server/tools.py — его docstring видит агент.

3. Зарегистрируйте его в цикле в верхней части server/max_mcp_server.py.

4. Запустите макроскрипт "Reload MaxForge Bridge" в Max вместо перезапуска.

Лицензия

Авторское право (c) 2026 .bluntman420. — см. LICENSE.md. Бесплатно для использования как есть; модификация и распространение изменённых версий не разрешены.