3dsmax-mcp
MCP-сервер для Autodesk 3ds Max: агент читает сцену, моделирует, настраивает материалы и модификаторы
- 350 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент может исполнять произвольный MAXScript и менять сцену, материалы и библиотеку материалов
- Установщик ставит Python, нативные мосты и навыки в систему и в настройки клиентов
Установка
- Работает в
Ручная установка
git clone https://github.com/cl0nazepamm/3dsmax-mcp.git && cd 3dsmax-mcp && uv sync && uv run python install.pyУстановка из исходников, нужны Python 3.12 или новее, uv и Git. Выберите полный профиль инструментов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может исполнять произвольный MAXScript и менять сцену, материалы и библиотеку материалов
- Установщик ставит Python, нативные мосты и навыки в систему и в настройки клиентов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер соединяет ИИ-агента с Autodesk 3ds Max через Model Context Protocol. В нем 161 инструмент. Они читают сцену, строят геометрию и настраивают материалы, а еще работают с модификаторами, контроллерами и процедурными графиками. Нативный мост работает с версиями Max 2023–2027. В моделировании агент строит редактируемые меши (create_mesh, curve_model, loft_mesh, mesh_edit), затем проверяет топологию и пересечения (geometry_qa, contact_check). В материалах он собирает наборы PBR-текстур, сохраняет библиотеку материалов в файлы .mat и восстанавливает ее, а еще массово заменяет материалы по сцене. Для текстур, материалов и источников света FStorm есть отдельные инструменты. Отдельное направление — работа с ассетами. Инструмент smart_import раскладывает папку моделей в сетку и подбирает PBR-текстуры. С помощью search_max_files, inspect_max_file и merge_from_file агент находит в старых сценах нужные объекты и переносит только их. Форматы mesh, CAD, USD и glTF импортируются через установленные в Max импортеры. Для собственной автоматизации есть исполнение MAXScript, самоанализ классов Max и инструменты mcg_* для Max Creation Graph. В комплекте идет навык агента с документацией по MAXScript.
Для кого. Для 3D-художников и технических артистов, которые работают в 3ds Max на Windows и хотят отдавать агенту рутину со сценой и материалами.
Подходит, если
- Нужно разложить папку текстур PBR по материалам и посмотреть палитру в Material Editor
- Требуется найти в старых файлах .max нужный объект и перенести его в текущую сцену
- Хотите массово заменить материалы в сцене по правилам
- Нужно проверить построенную геометрию: топологию и касания объектов
- Надо написать скрипт MAXScript или граф Max Creation Graph с проверкой результата
Не подходит, если
- У вас macOS или Linux: сервер требует Windows
- Нужна работа в Blender: для него есть отдельный сервер
- Сцена без резервной копии: агент может выполнять MAXScript и менять объекты, материалы и библиотеку
Пример запроса к агенту
Возьми папку с текстурами PBR, собери из них материалы и применяй каждый к объекту с подходящим названием в текущей сцене.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Работает только в Windows с Autodesk 3ds Max 2023–2027 и MCP-клиентом вроде Claude Desktop, Codex или Cursor. Готовый установщик включает Python, зависимости, нативные мосты и навыки агента. Для установки из исходников нужны Python 3.12 или новее, uv и Git. Перед установкой и обновлением закройте Max и клиент. Профили инструментов и ручная настройка клиентов собраны в docs/ADVANCED.md. Сервер написан на Python, а нативные мосты работают внутри Max, поэтому при зависании Max инструменты сцены не отвечают.
Как отключить. Закройте Max и клиент, затем удалите сервер из конфигурации клиента и деинсталлируйте программу через установщик Windows. При установке из исходников удалите папку проекта и запись сервера в настройках клиента.
Частые вопросы
Как поставить 3dsmax-mcp?
Закройте Max и клиент, запустите установщик из релизов и выберите свои клиенты, затем откройте Max и перезапустите клиент. Из исходников: git clone, uv sync и uv run python install.py.
Какие клиенты подходят для 3dsmax-mcp?
Подходят Claude Desktop, Codex и Cursor. Установщик предлагает выбрать клиентов, а ручная настройка и профили инструментов собраны в docs/ADVANCED.md.
Что делать, если Max завис?
Вызовите get_bridge_status: он показывает, отвечает ли Max, занят он или завис, и что удерживает главный поток. Этот инструмент отвечает даже при зависшем Max.
Умеет ли сервер работать с рендерером FStorm?
Да. Сервер импортирует текстуры FStorm и FStormPBR, раскладывает палитру и создает плоские, дисковые и сферические источники света и солнце с нативными настройками.
Можно ли писать собственные инструменты для 3ds Max через сервер?
Да. Есть исполнение MAXScript, самоанализ классов Max и набор инструментов mcg_* для построения, компиляции и проверки графов Max Creation Graph. В комплекте идет навык агента с документацией по MAXScript.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыBlender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Blender MCP: агент в Cursor, Cline, Windsurf или Claude Desktop строит и правит 3D-сцены в Blender по описанию, сервер ставится командой uvx
Официальный MCP-сервер MiniMax: синтез речи, клонирование и дизайн голоса, генерация изображений и видео
MCP-сервер для Ableton Live: агент создает дорожки, расставляет клипы и собирает аранжировку прямо в открытом проекте
MCP-сервер для SideFX Houdini на 215 инструментов: агент строит сети узлов, настраивает симуляции и собирает USD-сцены
MCP-сервер для Adobe After Effects: создание композиций, слоев, ключевых кадров и выражений через агента
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| 3dsmax-mcp (эта запись) | нет | не нужна | 350 | |
| Blender MCP | нет | не нужна | 32 624 | тот же подход к 3D-пакету, но для Blender и его аддона |
| Unity MCP Server | нет | не нужна | 529 | управление сценой и компонентами в игровом движке Unity |
Коротко о README
Идеи рабочих процессов автор группирует по моделированию, материалам, ассетам и собственным инструментам, к каждой идее приложен список вызовов. Полный каталог инструментов идет отдельной таблицей.