Об этом проекте

MCP для Blender — это плагин, созданный сообществом, который подключает Blender 3D к любой LLM (например, Claude, Codex или Cursor) через протокол Model Context Protocol (MCP). Он позволяет создавать, изменять и манипулировать 3D-сценами с помощью подсказок на естественном языке. ## Основные возможности - **Двусторонняя связь**: Подключение AI-ассистентов к Blender через сервер на основе сокетов - **Управление объектами**: Создание, изменение и удаление 3D-объектов - **Управление материалами**: Применение и изменение материалов и цветов - **Выполнение кода**: Запуск произвольного Python-кода в Blender из AI - **Генерация ассетов и моделей**: Импорт из Poly Haven, Sketchfab, Poly Pizza, а также AI-сгенерированных моделей через Hyper3D Rodin и Hunyuan3D ## Как это работает Плагин состоит из двух основных частей: 1. **MCP-сервер** (`src/blender_mcp/server.py`) — Python-сервер, реализующий Model Context Protocol 2. **Аддон Blender** — боковая панель в 3D-вьюпорте Blender, которая запускает соединение ## Настройка 1. Установите `uv` (менеджер Python-пакетов) с помощью официального установщика 2. Установите аддон Blender (через командную строку или вручную через настройки Blender) 3. Настройте ваш MCP-клиент (Claude Desktop, Claude Code, Codex, Cursor, VS Code и т. д.) 4. В Blender нажмите `N`, чтобы открыть боковую панель, найдите вкладку **MCP for Blender** и нажмите **Start MCP Server** ## Возможности - Выполнение любого Python-кода в Blender - Загрузка моделей, ассетов и HDRI с Poly Haven - Поиск и загрузка моделей со Sketchfab - Поиск и загрузка low-poly моделей с Poly Pizza - Генерация 3D-моделей через Hyper3D Rodin и Hunyuan3D (Tencent Cloud) ## Примеры команд - "Создай low poly сцену в подземелье, где дракон охраняет горшок с золотом" - "Дай референсное изображение и создай сцену Blender на его основе" - "Сгенерируй 3D-модель садового гнома через Hyper3D" - "Заполни эту комнату low-poly мебелью с Poly Pizza" ## Конфигурация Переменные окружения позволяют настройку: - `BLENDER_HOST` (по умолчанию: `localhost`) - `BLENDER_PORT` (по умолчанию: `9876`) - `BLENDER_MCP_SAFE_MODE` — установите `1` для проверки скриптов перед выполнением ## Вопросы безопасности - Сокет-сервер аддона не имеет аутентификации или шифрования - По умолчанию AI может выполнять любой Python-код в Blender - Безопасный режим (`BLENDER_MCP_SAFE_MODE=1`) блокирует опасные операции, такие как файловый ввод/вывод, сетевой доступ или установка постоянного кода ## Постоянные учетные данные API Храните API-ключи для Sketchfab, Poly Pizza, Hyper3D и Hunyuan3D в настройках Blender или через переменные окружения для headless/CI-сред. ## Поддержка Docker MCP-сервер может работать в контейнере вместо локальной установки. Blender по-прежнему работает на вашей машине; контейнер только размещает MCP-сервер и подключается к аддону Blender. ## Отказ от ответственности Это сторонняя интеграция и не создана Blender.