Blender MCP

ahujasid/mcp-for-blender· Проверено 12.11.2026· 34,1 тыс.на GitHub

Связывает агента с запущенным Blender: агент пишет Python для модели, света и материалов, сам смотрит на сцену с разных ракурсов и подтягивает ассеты из Poly Haven, Sketchfab и Poly Pizza.

Раньше назывался blender-mcp; старая команда uvx blender-mcp тоже запускает сервер.

Как подключить

Что сделать до подключения

1

Blender 3.0 или новее, Python 3.10 или новее и менеджер пакетов uv

2

Поставить аддон командой uvx mcp-for-blender install-addon или вручную: Edit → Preferences → Add-ons → Install… и выбрать addon.py

3

Включить аддон Interface: MCP for Blender в Edit → Preferences → Add-ons

4

В 3D-окне нажать N, открыть вкладку MCP for Blender и нажать Start MCP Server, если сервер не запустился сам

5
BLENDERMCP_POLYPIZZA_API_KEY

необязательно: бесплатный ключ на poly.pizza/settings/api для low-poly моделей

6
BLENDERMCP_MESHY_API_KEY

необязательно: ключ Meshy для генерации моделей, нужен платный тариф Meshy

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio blender \
  -- uvx mcp-for-blender

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

execute_blender_codeвыполняет Python в Blender
lookпоказывает сцену с выбранного ракурса
get_scene_infoкратко описывает объекты сцены
generate_3dгенерирует и импортирует 3D-модель
search_assetsищет HDRI, текстуры и модели
import_assetзагружает ассет в сцену
get_addon_statusпоказывает версии и включённые источники
disable_telemetryотключает сбор данных
record_trajectory_feedbackзаписывает отзыв о сессии

Что попросить агента

«Создай низкополигональную сцену в подземелье: дракон охраняет горшок с золотом»Соберёт сцену Python-кодом через execute_blender_code и проверит вид через look
«Сделай пляжную атмосферу: HDRI, текстуры, камни и растения с Poly Haven»Найдёт ассеты через search_assets и загрузит их в сцену через import_asset
«Сгенерируй керамический чайник через <Tripo>»Вызовет generate_3d с выбранным сервисом и импортирует модель в сцену
«Опиши текущую сцену и сделай из неё набросок на three.js»Получит список объектов через get_scene_info и напишет код по этим данным
«Сделай машину красной и металлической, а камеру поставь изометрично»Поменяет материал и камеру через execute_blender_code, результат покажет через look

Для каких задач

Собрать сцену по текстовому описанию или по картинке-референсу
Поменять материал объекта, например сделать машину красной и металлической
Поставить студийный свет или HDRI из Poly Haven и наложить текстуру на стену
Заполнить комнату low-poly мебелью из Poly Pizza
Сгенерировать модель через Meshy, Tripo, Hyper3D Rodin или Hunyuan3D и сразу импортировать её
Описать текущую сцену и сделать по ней набросок на three.js

Ограничения

!

execute_blender_code выполняет любой Python внутри Blender: сохраняйте файл перед работой или включите проверку скриптов BLENDER_MCP_SAFE_MODE=1

!

Сокет аддона работает без пароля и шифрования: кто достучится до порта, тот выполнит код в Blender, поэтому держите его на localhost

!

Запускайте только один экземпляр сервера: два клиента сразу, например Cursor и Claude Desktop, мешают друг другу

!

Без настройки сервер отправляет анонимную статистику вызовов; отключается переменной DISABLE_TELEMETRY=true

Если не работает

Агент не подключается к Blender
Проверьте, что сервер аддона в Blender запущен и сервер прописан в клиенте; команду uvx в терминале сами не запускайте. Первая команда иногда не проходит, дальше работает; если ошибки остаются, перезапустите клиент и сервер в Blender.
Ошибки таймаута
Упростите запрос или разбейте его на шаги поменьше.
Blender зависает во время загрузки с Poly Haven
Ассеты качаются в основном потоке Blender, интерфейс оживёт после загрузки; просите разрешение 1k или 2k, если ассет стоит далеко от камеры.
Загрузка с Poly Pizza падает на проверке Cloudflare
static.poly.pizza блокирует IP дата-центров, VPN и облаков: повторите с обычного подключения или скачайте .glb вручную и импортируйте через File → Import → glTF 2.0.

Частые вопросы

Нужно ли запускать сервер в терминале?
Нет, команду uvx в терминале запускать не надо: сервер стартует сам, когда его вызывает клиент. В Blender должен работать аддон, его сервер включается при открытии программы.
Клиент пишет spawn uvx ENOENT. Что делать?
Клиенты, открытые из меню или Dock, не видят PATH терминала. Узнайте полный путь командой which uvx или where uvx и впишите его в command. На Windows можно указать command cmd и args /c uvx mcp-for-blender.
Как подключить два Blender одновременно?
Добавьте в клиент вторую запись с аргументами mcp-for-blender --port 9877 и выставьте тот же порт в панели аддона во втором Blender. Порт по умолчанию 9876.
Агент видит, что у него получилось?
Да, инструмент look показывает вьюпорт, вид из камеры, сетку ракурсов или кадры анимации в режимах solid, material, rendered, wireframe и xray. Так агент проверяет свою работу без вас.
Откуда берутся модели и текстуры?
Poly Haven даёт около 2 400 HDRI, текстур и моделей под CC0 без ключа. Poly Pizza даёт около 10 600 low-poly моделей по бесплатному ключу; около 69% из них под CC-BY, автора нужно указывать, строка с атрибуцией записывается в объект.
Работает ли сервер из России?
Сервер и аддон работают на вашем компьютере; Poly Haven открыт без ключа и аккаунта, а генерация моделей идёт через внешние сервисы Meshy, Tripo, Hyper3D и Hunyuan3D по их ключам.

Похожие серверы