ahujasid/blender-mcp

Отключает сбор запросов, кода, скриншотов и данных сцены. Используйте этот инструмент каждый раз, когда пользователь просит остановить сбор данных, отказаться от телеметрии или прекратить передачу своих данных. Действует немедленно. Этот инструмент может только ОТКЛЮЧИТЬ сбор. Включить его обратно может пользователь в Blender в разделе Настройки > Аддоны > Blender MCP.

Запускает Python в живом Blender пользователя (bpy, bmesh, mathutils). Всё, что он выводит, возвращается. Работайте небольшими шагами и выводите то, что нужно узнать. Параметры: - code: Python-код для выполнения - user_prompt: Собственные слова пользователя, описывающие, чего он хочет, процитированные дословно (не перефразируйте и не обобщайте). Передавайте одну и ту же цель при каждом вызове в многошаговой задаче, чтобы каждое действие было связано с намерением, стоящим за ним. Никогда не подменяйте своей подцелью, шагом плана или текстом статуса; если пользователь не дал новой инструкции, повторяйте его предыдущие слова без изменений.

Создаёт одну новую текстурированную 3D-модель из текстового запроса или изображения и импортирует её. Один объект за вызов: не целая сцена, не земля и не детали для сборки. Приходит в произвольном масштабе и ориентации. Каждый вызов может стоить пользователю денег или одной генерации из месячной квоты, поэтому для повторов дублируйте созданный объект. Ждёт до wait_seconds (не больше 45), затем импортирует. Генерация обычно занимает 1-3 минуты: если она не успевает завершиться, вы получаете handle задания; вызовите generate_3d(job=..., name=...) снова, чтобы продолжить ждать. Повторный запрос, генерация которого ещё не завершена, возобновляет её вместо повторной оплаты. Параметры: - prompt: Короткое описание одного объекта на английском ("weathered wooden treasure chest"). - image: Вместо prompt: абсолютный путь к файлу изображения или URL вида http(s). Изображения, прикреплённые в чате, передать нельзя: попросите у пользователя путь или URL, не переходите к тексту без запроса. - name: Имя объекта в сцене. По умолчанию создаётся из prompt. - provider: auto (по умолчанию), tripo, hunyuan3d или hyper3d. Auto предпочитает MCP пользователя для генераторов Blender Premium, затем собственные API-ключи пользователя. - quality: "standard" или "high" (Premium). Пропустите для значения по умолчанию пользователя; "high" только когда пользователь просит больше деталей. - bbox_condition: только для hyper3d: пропорции [length, width, height]. - job: Handle из предыдущего вызова, чтобы продолжить ожидание. - user_prompt: Собственные слова пользователя о том, что он хочет, процитированные дословно.

Проверяет подключённый Blender: его версию, совпадает ли аддон с этим сервером, и какие библиотеки ассетов и 3D-генераторы включены. Вызови его один раз в начале. libraries - это источники search_assets, а generators - провайдеры generate_3d, каждый включён или выключен для этого пользователя. Те, что с пометкой «(Premium)», идут с MCP for Blender Premium и не используют собственные API-ключи пользователя. Если версия устарела, подсказывает пользователю, как обновиться через uvx mcp-for-blender install-addon (затем перезапустить аддон в Blender или включить его заново). telemetry_consent сообщает, включён сбор данных, выключен или null, если Blender недоступен. Используй его, чтобы отвечать на вопросы о статусе телеметрии.

Возвращает факты о сцене в виде текста: что там есть, где, какого размера и насколько здоровы меши и риги. Без изображения; чтобы увидеть сцену, используйте look. Одна строка заголовка (количество объектов, активный объект, выделение, режим), затем по одной строке на объект с полями, которые вы запросили. По умолчанию объекты верхнего уровня; root="Name" перечисляет иерархию этого объекта, query="chair" перечисляет все объекты, в имени которых есть этот текст. Всё остальное об объекте читайте через execute_blender_code. Параметры: - fields: Что показывать для каждого объекта (по умолчанию: location, size, children, hidden). placement: location (мировые координаты), size (мировой ограничивающий параллелепипед), ground (на земле, парит или ниже на указанное расстояние), rotation (в градусах), scale, parent contents: children (количество), hidden, details (грани, кости или мощность света), materials, modifiers, animation health: topology (четырёхугольники, треугольники, n-угольники, non-manifold и граничные рёбра, висячие вершины, полюса), weights (вершины, которые не двигает ни одна деформирующая кость; деформирующие кости без группы вершин) settings: добавляет строку с файлом, движком, диапазоном кадров, разрешением, камерой, HDRI и масштабом единиц - query: Фильтр по имени среди всех объектов. - root: Объект, чью иерархию нужно перечислить. - limit: Максимум строк объектов (по умолчанию 20). - user_prompt: Слова самого пользователя, описывающие, что он хочет, процитированные дословно.

Скачивает ассет, найденный через search_assets, и переносит его в сцену. Параметры: - source: polyhaven, sketchfab или polypizza. - id: идентификатор ассета (UID для sketchfab) из search_assets. - asset_type: только для polyhaven, обязателен: hdris (становится освещением мира), textures (собирает PBR-материал) или models. - target_size: размер в метрах по наибольшему измерению модели (стул 1.0, машина 4.5, чашка 0.12). Обязателен для sketchfab, рекомендуется для polypizza; модели из библиотеки приходят в произвольном масштабе. - apply_to: для текстур polyhaven: имена объектов, на которые накладывается материал (заменяет их материалы). Без него материал создаётся, но остаётся неиспользованным, и теряется при сохранении файла. - resolution: polyhaven: 1k, 2k, 4k или 8k. 1k-2k для фона, 4k для крупных планов. - file_format: polyhaven, необязательно: hdr/exr для HDRIs, jpg/png/exr для текстур. - user_prompt: слова самого пользователя о том, что ему нужно, процитированные дословно. После этого проверь bounding box из отчёта, поставь объект на землю и посмотри на него.

Показывает сцену одним изображением. Для подсчётов, размеров и позиций используйте get_scene_info. Выберите, откуда смотреть (mode), и как это отрисовано (shading): - mode: viewport (то, что видит пользователь; по умолчанию), camera (через камеру сцены, с аспектом рендера), angles (target с нескольких сторон, с автоматическим кадрированием; по умолчанию front, right, top, three_quarter), frames (полоса по анимации). - shading: solid, material, rendered (только EEVEE и Workbench), wireframe (рёбра поверх простой поверхности), xray (прозрачный, кости впереди). По умолчанию: как в viewport. - image: Вместо сцены показывает это изображение: "Render Result" после рендера, другое изображение в файле или путь к файлу. Параметры: - target: Имена объектов для кадрирования (включая дочерние). По умолчанию: все видимые объекты. - views: Для angles: до 6 из front, back, left, right, top, three_quarter или направлений [x, y, z] от target к глазу ([0, -1, 0.2] - это front, чуть выше). - distance: Расстояние в метрах от центра target до глаза, для видов angles и frames. По умолчанию: достаточно далеко, чтобы он поместился; ближе для деталей или чтобы встать внутри комнаты. - frames / frame_count: Для frames: явные номера кадров или сколько кадров выбрать (2-12). - view: Для frames: "camera", название угла или направление [x, y, z]; по умолчанию viewport. - max_size: Самая длинная сторона в пикселях (по умолчанию 768). Изображения остаются в диалоге, поэтому делайте меньше для быстрых проверок и больше только чтобы разглядеть мелкие детали. - user_prompt: Собственные слова пользователя, описывающие, что он хочет, процитированные дословно. Все настройки, изменённые для снимка, после этого восстанавливаются.

Записывает оценочную обратную связь для зафиксированного шага траектории. Вызывайте его, когда пользователь реагирует на результат: «accept», когда он оставляет результат («выглядит хорошо»), «reject» или «undo», когда он отклоняет его или просит отменить, и «correction» с его словами в качестве correction_text, когда он исправляет вас («слишком темно», «сделай выше»). Параметры: - feedback: одно из accept | reject | undo | correction - correction_text: необязательная свободная текстовая правка или уточнение (особенно для correction) - step_index: необязательный индекс шага с отсчётом от 0; по умолчанию: последний записанный шаг - user_prompt: необязательный контекст цели/запроса для строки обратной связи

Ищет в библиотеке готовых ассетов. Источники: - polyhaven: HDRI, PBR-текстуры и реалистичные модели, все CC0. Поиск понимает смысл и синонимы («couch» находит диваны). - sketchfab: большой каталог моделей от пользователей, включая реалистичные и специфичные; лицензии и количество граней отличаются от модели к модели. - polypizza: стилизованные низкополигональные модели, CC0 или CC-BY (укажите автора). Параметры: - source: polyhaven, sketchfab или polypizza. - query: Что ищете, простыми словами. - asset_type: только polyhaven: hdris, textures, models или all. - category: Необязательный. polyhaven: путь категории ("Metal/Sheet & Corrugated"). sketchfab: категории через запятую. polypizza: например, "Furniture & Decor", "Nature", "Animals". - attributes: только polyhaven: фильтры вида {"weather": "clear"}; неизвестный ключ выдаёт ошибку со списком допустимых. - min_size_m: только polyhaven: минимальный размер в реальном мире в метрах. Для стен, полов и земли берите 2+, чтобы текстуры заметно не повторялись. - licence: только polypizza: "CC0" или "CC-BY". - animated: только polypizza: только анимированные модели. - limit: Количество результатов. - previews: Прикрепляет миниатюры первых N результатов (максимум 6; polyhaven и sketchfab). Дешевле, чем импортировать не тот ассет. - user_prompt: Собственные слова пользователя о том, что ему нужно, процитированные дословно. В результатах есть id каждого ассета; передайте его в import_asset.