Blender MCP — Сценарии использования, Установка & Живое демо

Name: Blender MCP MCP Server
Author: ahujasid

Зачем использовать

Ключевые функции

Прямое выполнение bpy — всё, что можно написать в скрипте, Claude может выполнить
Интроспекция сцены: список объектов, получение свойств, просмотр материалов
Интеграция с PolyHaven: поиск и импорт HDRI, текстур, моделей
Hyper3D Rodin: AI-генерация 3D-моделей из текста или изображения
Встроенный поиск по Sketchfab для бесплатного просмотра моделей

Живое демо

Как выглядит на практике

blender-mcp-ahujasid.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Blender MCP

Создайте 3D-сцену из текстовой подсказки без прикосновения к интерфейсу Blender

👤 Дизайнеры, инди-разработчики, любители, которые не умеют моделировать ⏱ ~30 min beginner

Когда использовать: Вам нужен быстрый 3D-макет сцены, но вы не хотите учить горячие клавиши Blender.

Предварительные требования

Blender 3.0+ установлен — Скачать с blender.org
Аддон Blender MCP включён — Edit > Preferences > Add-ons > Install from disk

Поток

Подключение Claude к Blender

Open Blender. In the N-panel, click 'Connect to Claude'. Verify connection in chat by listing scene objects.✓ Скопировано

→ Список пустой сцены (Cube, Camera, Light) подтверждает живое соединение
Компоновка сцены

Build a low-poly forest clearing: 5 trees in a circle, a campfire in the center, a sleeping bag nearby. Use simple geometry.✓ Скопировано

→ Объекты появляются во вьюпорте в реальном времени
Добавление атмосферы

Search PolyHaven for a sunset HDRI. Apply it. Then add a small fog volume above the ground.✓ Скопировано

→ Сцена теперь имеет подсвеченную атмосферу; туман виден на рендере

Итог: Прототип 3D-сцены, созданный полностью через чат и готовый к доработке.

Подводные камни

Blender отключается посреди сессии — Переподключитесь через N-панель; аддон слушает локальный сокет

Генерируйте 3D-ресурсы с Hyper3D Rodin и импортируйте напрямую

👤 Геймдевы и прототиперы, которым нужна быстрая итерация по ресурсам ⏱ ~20 min intermediate

Когда использовать: Вам нужен уникальный пропс, но вы не хотите моделировать с нуля или платить за маркетплейс-ресурсы.

Предварительные требования

API-ключ Hyper3D Rodin (есть бесплатный тариф) — Зарегистрируйтесь на hyper3d.ai; задайте HYPER3D_RODIN_API_KEY

Поток

Генерация из текста

Generate a stylized treasure chest with iron bands using Hyper3D rodin. Import it at origin.✓ Скопировано

→ Задача генерации запущена; меш импортируется по завершении (~30s)
Доработка и повторный импорт при необходимости

The mesh is too dense. Decimate to 5k tris and reimport.✓ Скопировано

→ Децимированный меш заменяет оригинал

Итог: Кастомный 3D-пропс в сцене, сгенерированный и настроенный без выхода из Claude.

Подводные камни

Очередь генерации загружена на бесплатном тарифе — Повторите попытку с экспоненциальной задержкой или перейдите на платный тариф

Выполняйте пакетные операции над множеством объектов через bpy

👤 Технические директора и инженеры пайплайна ⏱ ~25 min advanced

Когда использовать: Вам нужно выполнить рутинную массовую операцию — переименование иерархии, переназначение материалов, пакетная UV-развёртка.

Поток

Описание операции

Every object starting with 'prop_' should be moved into a 'Props' collection and have its origin set to geometry center.✓ Скопировано

→ Claude пишет bpy-сниппет и просит подтверждение перед запуском
Запуск со страховкой

Show me the script first. If it looks safe, execute. Otherwise revise.✓ Скопировано

→ Скрипт виден; выполнение применено; отчёт о количестве затронутых объектов

Итог: Массовые операции со сценой выполнены за секунды с полным журналом аудита.

Подводные камни

Плохой скрипт крашит Blender — Сохраняйтесь перед любым выполнением bpy; аддон не изолирует выполнение

Комбинации

Сочетайте с другими MCP — эффект x10

blender-mcp-ahujasid + filesystem

Сохранение рендеров и экспортов на диск

After rendering, save the PNG to ~/Renders/today.png via filesystem MCP.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
execute_blender_code	code: str	Любая прямая bpy-операция	0
get_scene_info	()	Первый вызов для понимания состава сцены	0
get_object_info	name: str	Инспекция конкретного объекта перед редактированием	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	Поиск бесплатных PBR-ресурсов	0
polyhaven_download_asset	asset_id, resolution	Загрузка и применение HDRI/текстуры	0
generate_hyper3d_model_via_text	prompt: str	AI-генерация 3D-модели	1 кредит генерации

Стоимость и лимиты

Во что обходится

Квота API: PolyHaven: безлимитно бесплатно. Hyper3D: бесплатный тариф ~20 генераций/день
Токенов на вызов: 100–800 на вызов (состояние сцены может быть многословным)
Деньги: Аддон бесплатный. Платные тарифы Hyper3D от $10/мес
Совет: Используйте Sketchfab и PolyHaven перед тем, как платить за генерации Hyper3D

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: blender-bpy-exec filesystem-write (for downloads)

Хранение учётных данных: Ключ Hyper3D в переменной среды

Исходящий трафик: CDN PolyHaven, API Hyper3D

execute_blender_code выполняет произвольный Python в вашем Blender — проверяйте скрипты перед запуском

Устранение неполадок

Частые ошибки и исправления

Connection refused

Убедитесь, что Blender открыт и функция «Connect to Claude» аддона включена; порт по умолчанию 9876

Hyper3D generation hangs

Проверьте переменную среды HYPER3D_RODIN_API_KEY; проверьте квоту тарифа на hyper3d.ai

Object not found after edit

Имя объекта может иметь числовой суффикс (.001) — используйте get_scene_info для обновления

Альтернативы

Blender MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Unity MCP / Unreal MCP	Ваш пайплайн строится вокруг игрового движка, а не DCC	Engine MCP нацелены на runtime/сцены; Blender MCP — на авторинг
Cesium MCP	Вам нужна геопространственная/мировая 3D-сцена	Cesium для геореференсированных сцен; Blender для свободного моделирования

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills