Blender MCP (bpy.dev)

Установка

Работает в

• Codex
• SourceCraft
• Koda
• Coddy

Ручная установка

{"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "/absolute/path/to/blender_mcp/mcp", "run", "blender-mcp"], "env": {"BLENDER_MCP_CLI_BACKEND": "bpy", "BLENDER_MCP_BPY_PYTHON": "/absolute/path/to/python-with-bpy"}}}}

Что делает

Репозиторий bpy.dev — независимая расширенная сборка проекта Blender MCP от Blender Lab. Она сохраняет исходную схему: аддон Blender и отдельный MCP-сервер обмениваются данными по TCP-сокету, а клиент общается с сервером по stdio. Сверху добавлены режимы, которых нет в базовом варианте. Инструменты с суффиксом _for_cli открывают сохраненный файл .blend в новом процессе и не требуют запущенного интерфейса Blender. Бэкенд выбирают переменной BLENDER_MCP_CLI_BACKEND: исполняемый файл Blender или отдельный Python с модулем bpy. Живые инструменты вроде execute_blender_code по-прежнему работают через аддон в открытой сессии. Агент может запрашивать у рантайма Blender точные сигнатуры, перечисления, значения по умолчанию и доступность функций вместо того, чтобы полагаться только на встроенную документацию. Для командной строки заданы лимиты по времени и объему вывода, а перед записью проверяется перезапись исходного файла. Это изоляция процесса, а не песочница уровня ОС.

Для кого. Для разработчиков и технических художников, которым нужен blender mcp с обработкой сохраненных .blend без интерфейса и с точной справкой по Python API Blender.

Пример запроса к агенту

Открой сохраненный файл scene.blend без интерфейса, перечисли объекты и материалы, затем проверь по API Blender, какие параметры принимает оператор отражения.

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

Это модифицированная распространяемая сборка проекта Blender Lab, и происхождение описано в файле NOTICE.md. Репозиторий сам называет себя предварительной версией: перед публикацией осталось закрыть чек-лист, в том числе имя пакета, проверку установки с нуля и поиск секретов. Лицензия GPL-3.0. Для автономного режима нужен путь к Python с установленным bpy, для живой сцены нужен аддон в Blender. Выполнение кода в Blender не защищено песочницей ОС, подробности об угрозах собраны в SECURITY.md.

Как отключить. Удалите запись blender из конфигурации MCP-клиента и отключите аддон blender_mcp_addon в настройках Blender. Файлы .blend сервер не меняет без вашего запроса.

Коротко о README

Описание делит проект на аддон Blender и MCP-сервер. Аддон принимает запросы по TCP и поддерживает настройку хоста, порта и автозапуска. Сервер собран как Python-пакет с точкой входа blender-mcp и грузит инструменты автоматически из папки tools. Рядом лежат справка по Python API и фрагменты руководства Blender в формате RST. Инструменты перечислены в отдельном файле readme_tools.rst.