Blockbench·jasonjgardner

Blockbench MCP — подключение и инструкция

Blockbench MCP позволяет агенту работать с моделями Blockbench и файлами .bbmodel: читать, редактировать и проверять структуру.

ДизайнЛокальноБез ключа

Что умеет этот сервер

01

Blockbench MCP позволяет агенту работать с моделями Blockbench и файлами .bbmodel: читать, редактировать и проверять структуру.

02

Есть два режима: desktop-плагин с HTTP и headless stdio-сервер для файлов без запущенного Blockbench.

03

Прочитай тестовую модель и перечисли элементы.

Задача для знакомства

Через Blockbench MCP прочитай тестовую .bbmodel и перечисли элементы и размеры. Пока не меняй геометрию и текстуры.

Уточнить результат

Сверь формат проекта, путь root и активную модель. Изменённый файл должен открываться в Blockbench; проверяй не только JSON, но и геометрию и текстуры.

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

Выберите подходящий способ

Подключить Blockbench MCP

Desktop: File → Plugins → Load Plugin from URL, вставь URL mcp.js из README и подключи локальный endpoint /bb-mcp. Headless: настрой npx с github:jasonjgardner/blockbench-mcp-plugin и --root с абсолютным путём к каталогу моделей. Выбери нужный режим вместо бездумного подключения обоих.

Что понадобится

  • Для desktop нужен Blockbench и установленный плагин; для headless — Node.js/npm и отдельная папка моделей.
  1. 01

    Подготовь окружение

    Для desktop нужен Blockbench и установленный плагин; для headless — Node.js/npm и отдельная папка моделей.

  2. 02

    Установи и настрой

    Desktop: File → Plugins → Load Plugin from URL, вставь URL mcp.js из README и подключи локальный endpoint /bb-mcp. Headless: настрой npx с github:jasonjgardner/blockbench-mcp-plugin и --root с абсолютным путём к каталогу моделей. Выбери нужный режим вместо бездумного подключения обоих.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Первый запрос — пример для чата агента

Через Blockbench MCP прочитай тестовую .bbmodel и перечисли элементы и размеры. Пока не меняй геометрию и текстуры.

Как проверить

Сверь формат проекта, путь root и активную модель. Изменённый файл должен открываться в Blockbench; проверяй не только JSON, но и геометрию и текстуры.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Blockbench

Blockbench MCP позволяет агенту работать с моделями Blockbench и файлами .bbmodel: читать, редактировать и проверять структуру.

Есть два режима: desktop-плагин с HTTP и headless stdio-сервер для файлов без запущенного Blockbench. Их требования различаются; --root ограничивает каталог моделей в headless-варианте.

Что подготовить перед подключением

Для desktop нужен Blockbench и установленный плагин; для headless — Node.js/npm и отдельная папка моделей.

Как установить и подключить

Desktop: File → Plugins → Load Plugin from URL, вставь URL mcp.js из README и подключи локальный endpoint /bb-mcp. Headless: настрой npx с github:jasonjgardner/blockbench-mcp-plugin и --root с абсолютным путём к каталогу моделей. Выбери нужный режим вместо бездумного подключения обоих.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Прочитай тестовую модель и перечисли элементы. Для правки задай точные размеры и имя элемента, затем открой .bbmodel в редакторе и проверь UV/текстуру, если они затронуты.

Как проверить результат и решить проблемы

Сверь формат проекта, путь root и активную модель. Изменённый файл должен открываться в Blockbench; проверяй не только JSON, но и геометрию и текстуры.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Режим desktop требует запущенного приложения, headless — не управляет его текущим окном. Нельзя считать любую конверсию формата безошибочной для всех плагинов и анимаций.

Исходники и документация

Репозиторий: jasonjgardner/blockbench-mcp-plugin. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Blockbench

Blockbench MCP позволяет агенту работать с моделями Blockbench и файлами .bbmodel: читать, редактировать и проверять структуру.
Вернуться в библиотеку