Blender MCP: как подключить ИИ-агента к Blender и не потерять сцену

Blender MCP соединяет Blender с языковой моделью. Агент видит сцену, создаёт и меняет объекты, назначает материалы и, что самое мощное, выполняет Python-код через API Blender. За лето запросов о нём в Яндексе стало в два с лишним раза больше, и в выдаче в основном пересказы README.

Ниже про то, как это устроено, как подключить к десктопному агенту и почему первым делом стоит сохранить файл.

Как это устроено

Проект состоит из двух частей.

Внутри Blender работает аддон. Он открывает сокет на localhost:9876 и принимает команды. Снаружи работает MCP-сервер: его запускает агент, сервер получает вызовы инструментов и передаёт их аддону.

Отсюда первое правило: Blender должен быть открыт, а сервер в аддоне запущен. Без этого агент увидит инструменты, но каждый вызов закончится ошибкой соединения.

Что умеет

• смотреть сцену и выделенные объекты;
• создавать, менять и удалять объекты;
• назначать материалы;
• выполнять произвольный Python через инструмент execute_blender_code;
• подтягивать ассеты из Poly Haven, Sketchfab, Poly Pizza, а также генерировать модели через Hyper3D Rodin и Hunyuan3D;
• экспортировать сцену или выделение в GLB и FBX;
• подсказывать схему нод и API bpy.

Лицензия MIT. Нужны Blender 3.0+, Python 3.10+ и менеджер пакетов uv.

Установка

1. Поставь uv официальным установщиком, не через pip.
2. Установи аддон командой uvx mcp-for-blender install-addon.
3. В Blender открой Edit → Preferences → Add-ons и включи «Interface: MCP for Blender».
4. В 3D-вьюпорте нажми N, открой вкладку MCP for Blender и нажми «Start MCP Server».

В старых гайдах пакет называется blender-mcp. Если инструкция не сходится с тем, что видишь, сверяйся с README репозитория ahujasid/blender-mcp.

Подключение к Доке

Дока запускает MCP-серверы как локальные процессы. На вкладке MCP-серверов добавь:

• команда: uvx;
• аргумент: mcp-for-blender.

Если Blender слушает не стандартный порт, передай переменные окружения BLENDER_HOST и BLENDER_PORT. Общая инструкция по форме есть в статье как подключить MCP-сервер.

Проверка: при запущенном сервере в аддоне попроси агента перечислить объекты на сцене.

Про безопасность: читаем README буквально

execute_blender_code выполняет любой Python внутри Blender. Авторы прямо пишут: это мощно, но может быть опасно, всегда сохраняй работу перед использованием. Python в Blender умеет не только двигать вершины, но и писать файлы на диск.

Что из этого следует:

• Сохраняй .blend перед каждой задачей, а лучше держи инкрементальные копии.
• Включи безопасный режим переменной BLENDER_MCP_SAFE_MODE=1. Тогда скрипты проверяются перед запуском.
• Не открывай порт 9876 наружу. У сокета нет аутентификации.
• Телеметрия у проекта включена по умолчанию. Выключается в настройках аддона или переменной DISABLE_TELEMETRY=true.

Ещё одна мелочь: Poly Pizza блокирует загрузки через Cloudflare с IP дата-центров, VPN и облаков. Если ассеты оттуда не качаются, дело может быть в этом.

Где агент в Blender полезен

«Сделай красивую сцену с домиком» — слабая задача. Модель не видит картинку так, как видишь её ты, и результат будет средним.

Хорошо работают задачи, которые проще описать правилом, чем сделать руками:

• «Переименуй все объекты в коллекции Props по схеме prop_<тип>_<номер>»;
• «Для всех мешей примени масштаб и поставь origin в центр нижней грани»;
• «Экспортируй каждый объект из Export в отдельный FBX в папку game/assets»;
• «Найди объекты без материала и повесь на них заглушку».

Это обычная подготовка ассетов для движка: скучная, повторяемая, с понятным результатом.

Последняя задача показывает, зачем агенту кроме MCP нужны файлы. Blender MCP экспортирует модель, а дальше её надо положить в проект Godot или Unity, переименовать и проверить импорт. В Доке файловые инструменты и терминал встроены, поэтому цепочку от Blender до папки игры можно отдать одной задачей. Про связку с движками: Godot MCP и Unity MCP.

Какая модель

Инструменты Blender MCP вызываются корректно, только если модель уверенно пишет Python и знает bpy. Маленькие локальные модели часто путают API разных версий Blender. Если видишь ошибки вида «у объекта нет атрибута», укажи версию Blender в задаче или возьми модель посильнее.

Модель в Доке можно держать локальной, а для сложных сцен подключать облачную по своему ключу.

С чего начать

Поставь uv и аддон, запусти сервер в Blender, сохрани файл и подключи mcp-for-blender в Доке. Первая задача пусть будет безобидной, например переименовать объекты по правилу. Посмотри, какие вызовы делает агент, и только потом давай ему что-то серьёзнее.