Blender MCP Server

Сервер Model Context Protocol (MCP) для полного управления Blender через API

Этот аддон превращает Blender в MCP-сервер, предоставляя более 50 мощных инструментов, которыми могут управлять ИИ-агенты через HTTP-эндпоинты. Идеально подходит для рабочих процессов 3D с поддержкой ИИ, автоматизации и творческих экспериментов.

✨ Функции

• 🚀 50+ инструментов - Полный контроль над функциями Blender:

  • Создание, манипуляция и трансформация объектов

  • Управление системой материалов и шейдеров

  • Управление анимацией и ключевыми кадрами

  • Настройка камеры и освещения

  • Модификаторы и ограничения

  • Физические симуляции (твердые тела, ткань, жидкости)

  • Геометрические ноды и процедурная генерация

  • Операции импорта/экспорта файлов

  • Оптимизация сцены и пакетные операции

• 🔒 Потокобезопасное выполнение - Очередь корпоративного уровня для безопасных параллельных операций

• 📦 Автоматическая установка зависимостей - Автоматически устанавливает необходимые пакеты при первом запуске

• 🎮 Простая панель пользовательского интерфейса - Запуск/остановка сервера одним кликом с N-панели Blender

• 📊 Мониторинг в реальном времени - Отслеживание операций, статистики и состояния сервера

• 🔧 Готовность к работе - Комплексная обработка ошибок, логирование и кэширование

🚀 Быстрый старт

Установка

1. Скачайте blender_mcp.py

2. Откройте Blender

3. Перейдите в Edit → Preferences → Add-ons

4. Нажмите на стрелку выпадающего списка (⌄) рядом с панелью поиска

5. Выберите Install from Disk...

6. Выберите скачанный файл blender_mcp.py

7. Включите аддон, установив флажок рядом с "MCP Complete Server for Blender"

Запуск сервера

1. Нажмите N в 3D Viewport, чтобы открыть боковую панель

2. Перейдите на вкладку MCP Server

3. Нажмите Start Server

4. Сервер запустится по адресу http://localhost:8000

Аддон автоматически установит необходимые зависимости при первом запуске (FastAPI, Uvicorn, Pydantic и т.д.).

🤖 Использование с PolyMCP

Этот MCP-сервер разработан для бесшовной работы с PolyMCP — мощным фреймворком для оркестрации MCP-серверов с помощью ИИ-агентов.

Пример: Blender под управлением ИИ

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # Initialize your LLM provider
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # Connect to Blender MCP server
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP Server connected!\n")
        
        # Chat with your AI to control Blender
        while True:
            user_input = input("\n🎨 You: ")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender: {result}")

if __name__ == "__main__":
    asyncio.run(main())

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

После подключения вы можете попросить ИИ-агента:

• "Создай куб в позиции (0, 0, 0) размером 2"

• "Добавь красный металлический материал к выбранному объекту"

• "Создай камеру, направленную на начало координат"

• "Настрой простую сцену освещения с 3 источниками света"

• "Добавь симуляцию жидкости к кубу"

• "Экспортируй сцену как файл FBX"

• "Создай анимацию вращения объекта на 360 градусов за 100 кадров"

Вот и все! PolyMCP берет на себя всю сложность:

• Обнаружение и выбор инструментов

• Планирование многошаговых задач

• Обработка ошибок и повторные попытки

• Управление состоянием между операциями

Это делает создание инструментов автоматизации Blender на базе ИИ невероятно простым!

📡 API Эндпоинты

После запуска сервера вы можете получить доступ к:

• Документация API: http://localhost:8000/docs

• Список всех инструментов: http://localhost:8000/mcp/list_tools

• Вызов инструмента: POST http://localhost:8000/mcp/invoke/{tool_name}

🛠️ Доступные категории инструментов

• Операции с объектами: Создание, удаление, дублирование, выбор объектов

• Трансформации: Перемещение, вращение, масштабирование, применение трансформаций

• Материалы и шейдинг: Создание материалов, добавление текстур, настройка шейдерных нод

• Моделирование: Добавление модификаторов, булевы операции, редактирование мешей

• Анимация: Ключевые кадры, управление таймлайном, редактор NLA

• Камера и освещение: Настройка камеры, создание источников света, HDRI-окружение

• Рендеринг: Настройки рендера, конфигурация вывода, рендеринг

• Физика: Твердые тела, ткань, симуляции жидкости

• Геометрические ноды: Процедурная генерация, создание дерева нод

• Операции с файлами: Импорт/экспорт различных форматов (FBX, OBJ, USD и т.д.)

• Управление сценой: Информация о сцене, очистка, оптимизация

• Пакетные операции: Создание и трансформация нескольких объектов

• Дополнительно: Системы частиц, силовые поля, grease pencil

🔧 Конфигурация

Вы можете настроить сервер, отредактировав класс Config в blender_mcp.py:

class Config:
    HOST = "0.0.0.0"           # Server host
    PORT = 8000                # Server port
    AUTO_INSTALL_PACKAGES = True  # Auto-install dependencies
    THREAD_SAFE_OPERATIONS = True  # Enable thread-safe execution
    ENABLE_CACHING = True      # Enable result caching

📋 Требования

Аддон автоматически устанавливает следующие зависимости:

• FastAPI

• Uvicorn

• Pydantic

• docstring-parser

• NumPy

• PolyMCP

Версия Blender: 3.0.0 или выше

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

Сервер не запускается?

• Проверьте системную консоль Blender на наличие сообщений об ошибках (Window → Toggle System Console)

• Убедитесь, что порт 8000 не занят

• Попробуйте перезапустить Blender после установки

Зависимости не устанавливаются?

• Установите пакеты вручную, используя Python в Blender:

/path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy

Не можете найти панель MCP Server?

• Нажмите N в 3D Viewport

• Ищите вкладку "MCP Server" на боковой панели

• Убедитесь, что аддон включен в настройках (Preferences)

🤝 Участие в разработке

Вклад приветствуется! Этот проект демонстрирует, насколько просто создавать мощные MCP-серверы для PolyMCP.

📝 Лицензия

Лицензия MIT - подробности см. в файле LICENSE

🔗 Связанные проекты

• PolyMCP - Простой и эффективный способ взаимодействия с MCP-серверами с помощью пользовательских агентов

• Model Context Protocol - Открытый протокол для интеграции инструментов с LLM

💡 Почему этот проект?

Этот MCP-сервер был создан, чтобы показать, насколько невероятно просто PolyMCP позволяет создавать инструменты на базе ИИ. Всего за несколько строк кода вы можете:

1. Предоставить сложный функционал Blender в виде инструментов MCP

2. Позволить ИИ-агентам обнаруживать и управлять этими инструментами

3. Создавать интерфейсы на естественном языке для 3D-творчества

Никаких сложных промптов, никакого ручного выбора инструментов, никакого управления состоянием — PolyMCP берет все на себя!

Разработано для PolyMCP

Поставьте ⭐ этому репозиторию, если он оказался полезным!