Blender MCP Server

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

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

✨ Функции

🚀 50+ инструментов - Полный контроль над функциями Blender:
- Создание, манипуляция и трансформация объектов
- Управление системой материалов и шейдеров
- Управление анимацией и ключевыми кадрами
- Настройка камеры и освещения
- Модификаторы и ограничения
- Физические симуляции (твердые тела, ткань, жидкости)
- Геометрические ноды и процедурная генерация
- Операции импорта/экспорта файлов
- Оптимизация сцены и пакетные операции
🔒 Потокобезопасное выполнение - Очередь корпоративного уровня для безопасных параллельных операций
📦 Автоматическая установка зависимостей - Автоматически устанавливает необходимые пакеты при первом запуске
🎮 Простая панель пользовательского интерфейса - Запуск/остановка сервера одним кликом с N-панели Blender
📊 Мониторинг в реальном времени - Отслеживание операций, статистики и состояния сервера
🔧 Готовность к работе - Комплексная обработка ошибок, логирование и кэширование

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

Установка

Скачайте blender_mcp.py
Откройте Blender
Перейдите в Edit → Preferences → Add-ons
Нажмите на стрелку выпадающего списка (⌄) рядом с панелью поиска
Выберите Install from Disk...
Выберите скачанный файл blender_mcp.py
Включите аддон, установив флажок рядом с "MCP Complete Server for Blender"

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

Нажмите N в 3D Viewport, чтобы открыть боковую панель
Перейдите на вкладку MCP Server
Нажмите Start Server
Сервер запустится по адресу 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 позволяет создавать инструменты на базе ИИ. Всего за несколько строк кода вы можете: