Настройка Blender MCP с помощью Gemini CLI

Введение

Gemini CLI - это мощный интерфейс командной строки, позволяющий взаимодействовать с моделью Gemini AI компании Google непосредственно из терминала. Интегрируя Blender MCP с Gemini CLI, вы можете использовать возможности ИИ для улучшения рабочего процесса 3D-моделирования в Blender.

Это руководство пошагово проведет вас через весь процесс настройки, от установки Node.js до проверки работы вашего MCP-сервиса с Gemini CLI.

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

• Система Windows, macOS или Linux
• Права администратора для установки программного обеспечения
• Учётная запись Google с доступом к Gemini
• Базовое понимание интерфейсов командной строки
• Blender установлен в системе (опционально, но рекомендуется)

Шаг 1: Установка Node.js

Gemini CLI и сервер Blender MCP требуют Node.js для работы. Следуйте этим шагам для установки:

Для Windows:

1. Посетите nodejs.org
2. Загрузите версию LTS (долгосрочная поддержка)
3. Запустите установщик и следуйте мастеру установки
4. Примите все параметры по умолчанию (включая конфигурацию npm и PATH)
5. Нажмите "Завершить" для завершения установки

Для macOS:

1. Используя Homebrew: brew install node
2. Или загрузите с nodejs.org и запустите установщик

Для Linux:

Используйте менеджер пакетов. Например, на Ubuntu/Debian:

sudo apt update
sudo apt install nodejs npm

Проверка установки Node.js

Откройте терминал или командную строку и запустите:

node --version
npm --version

Если Node.js установлен правильно, обе команды вернут номера версий.

Шаг 2: Загрузка и установка Gemini CLI

Теперь, когда Node.js установлен, вы можете загрузить и настроить Gemini CLI:

Шаги установки

1. Откройте терминал или командную строку
2. Перейдите в директорию, где вы хотите сохранить проект Gemini CLI, или создайте её (назовём её gmcp)
3. Создайте директорию:

   mkdir gmcp
   cd gmcp

4. Загрузите Gemini CLI, используя npm:

   npm install -g @google/generative-ai-cli

5. Или используйте npx для прямого запуска без глобальной установки:

   npx @google/generative-ai-cli

Шаг 3: Конфигурация сервиса Blender MCP

Конфигурация сервиса MCP (Model Context Protocol) - это ключевой шаг, который связывает Blender MCP с Gemini CLI.

Поиск файла конфигурации

Gemini CLI хранит свою конфигурацию в файле settings, расположенном по адресу:

D:\seocode\tmp\gmcp\.gemini\settings.json

Добавление конфигурации

Откройте файл settings.json в вашем любимом текстовом редакторе (например, Visual Studio Code, Notepad++ или даже Notepad).

Добавьте или обновите следующую конфигурацию для включения сервиса Blender MCP:

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

Объяснение конфигурации

• mcpServers: объект, содержащий все определения MCP-сервисов
• blender: имя вашего MCP-сервиса (используется для идентификации в Gemini CLI)
• command: команда для выполнения (uvx - это запускатель пакетов для Python)
• args: аргументы, передаваемые команде (blender-mcp - это пакет Blender MCP)

Сохранение конфигурации

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

Шаг 4: Выход и повторный вход в Gemini CLI

Чтобы применить новую конфигурацию MCP-сервиса, вам нужно перезагрузить Gemini CLI:

Выход из Gemini CLI

Если Gemini CLI запущен, выйдите, введя:

exit

Повторный вход

Перезагрузите Gemini CLI в вашем терминале:

npx @google/generative-ai-cli

Или, если вы установили глобально:

gemini-cli

Шаг 5: Проверка конфигурации MCP-сервиса

После повторного входа в Gemini CLI проверьте, что сервис Blender MCP правильно настроен и доступен:

Проверка статуса сервиса

В Gemini CLI вы должны увидеть вывод, указывающий на то, что MCP-сервис был загружен. Найдите сообщения подобные:

[INFO] Loading MCP services...
[INFO] Blender MCP service loaded successfully
[INFO] Available tools: blender_create_object, blender_modify_object, ...

Тестирование интеграции

Попробуйте выполнить простую команду, которая использует сервис Blender MCP. Например:

Создай куб в Blender

Если Blender запущен с установленным MCP-плагином, куб должен появиться в вашей сцене Blender. Gemini обработает ваш запрос и отправит команды через протокол MCP в Blender.

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

Проблема: Settings.json не найден

Решение: вручную создайте папку .gemini в директории вашего проекта и создайте файл settings.json с конфигурацией, указанной выше.

Проблема: "команда uvx не найдена"

Решение: установите необходимый пакет инструментов Python:

pip install uv

Проблема: MCP-сервис не загружается

Решение: проверьте следующее:

• Убедитесь, что синтаксис JSON в settings.json правильный (при необходимости используйте валидатор JSON)
• Убедитесь, что путь к файлу правильный: D:\seocode\tmp\gmcp\.gemini\settings.json
• Проверьте, что Blender MCP установлен: uvx blender-mcp --version
• Проверьте логи Gemini CLI для подробных сообщений об ошибках

Проблема: Blender не реагирует на команды

Решение: убедитесь, что:

• Blender запущен с установленным MCP-плагином
• MCP-плагин включен в настройках Blender
• Gemini CLI и Blender подключены через правильный сетевой порт

Дальнейшие действия

Теперь, когда вы настроили Blender MCP с Gemini CLI, вы можете:

• Создавать сложные 3D-сцены, используя натуральные языковые подсказки
• Изменять объекты и материалы с помощью ИИ-ассистента
• Автоматизировать повторяющиеся задачи 3D-моделирования
• Комбинировать возможности ИИ Gemini с мощными инструментами Blender для 3D
• Изучать продвинутые функции MCP для пользовательских скриптов и автоматизации

Для получения дополнительной информации по использованию Blender MCP посетите официальный репозиторий GitHub.

Заключение

Настройка Blender MCP с помощью Gemini CLI открывает безграничные возможности для трёхмерного моделирования на базе ИИ. Хотя процесс конфигурации включает несколько шагов, следуя этому руководству, вы сможете быстро приступить к работе. Ключ к успеху - убедиться, что файлы конфигурации правильно отформатированы и все компоненты установлены корректно.

Если у вас возникли проблемы или у вас есть вопросы, обратитесь к разделу устранения неполадок или проверьте документацию Blender MCP.