Unity AI Bridge

Unity AI Bridge

butterlatte-zhangApache-2.0
14 звёзд4 форков
Unity AI Bridge — MCP-сервер, который даёт AI-ассистентам прямой доступ к Unity Editor. Вместо того чтобы только читать и писать файлы, нейросеть может управлять сценой, объектами, ассетами, профилировщиком и запускать тесты. В основе — файловый IPC (Inter-Process Communication) без портов и зависимостей. Сервер написан на чистом Python (стандартная библиотека) и работает со всеми популярными AI-средами: Cursor, Claude Desktop, GitHub Copilot, Windsurf. Инструментов — 65, категорий — 15. Покрытие полного цикла разработки игры или приложения на Unity. Для кого: разработчики Unity, которые используют AI-ассистентов для ускорения работы с редактором. Позволяет не выходя из чата создавать объекты, настраивать материалы, запускать билды, анализировать производительность.
Ai-mlDevelopmentFilesUnityGaming
Открыть на GitHubОфициальный сайт

Характеристики

Общее

  • СтатусСообщество
  • Разработчикbutterlatte-zhang
  • ЛицензияApache-2.0

Технологии

  • Языки
    C#

Описание

Возможности

  • Управление сценой: создание, удаление, перемещение и трансформация GameObject
  • Работа с ассетами: создание, импорт, настройка prefab, material, texture
  • Запуск режима Play и остановка, мониторинг игрового состояния
  • Профилирование: снятие снапшотов, анализ hot path, стриминг данных
  • LightProbe: генерация и настройка освещения для сцен
  • Управление пакетами: установка, удаление, обновление через Package Manager
  • Скриптинг: создание и изменение C# скриптов, добавление компонентов
  • Тестирование: запуск тестов (Edit Mode и Play Mode), получение результатов
  • Скриншоты: захват текущего вида редактора или камеры
  • Расширение функционала: добавление собственных инструментов атрибутом [BridgeTool] — без регистрации и лишнего кода

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

1. Установите Unity-пакет: в Package Manager добавьте Git-ссылку из репозитория проекта. Или скопируйте файлы в папку Packages вашего проекта.

2. Установите Python-сервер (не требует сторонних библиотек): скопируйте папку server из репозитория или выполните команду:

git clone https://github.com/butterlatte-zhang/unity-ai-bridge.git
cd unity-ai-bridge/server
python -m unity_ai_bridge.mcp

3. Настройте клиент MCP, например, для Claude Desktop добавьте в конфигурационный файл (обычно claude_desktop_config.json):

{"mcpServers": {"unity-ai-bridge": {"command": "python", "args": ["-m", "unity_ai_bridge.mcp"], "cwd": "/путь/к/папке/server"}}}

4. Перезапустите клиент AI-среды.

Готово — теперь нейросеть может управлять Unity Editor в реальном времени.

Примеры запросов

  • «Создай на сцене куб с материалом красного цвета и назови его TestCube»
  • «Запусти Play Mode, подожди 5 секунд, сделай скриншот и останови»
  • «Найди в проекте все prefab с тегом Enemy и выведи список имён»
  • «Запусти все тесты в Edit Mode и покажи результат — сколько пройдено, сколько упало»

Технические детали

  • Язык: C# (Unity-пакет) и Python (MCP-сервер)
  • Транспорт: файловый IPC (polling ~100 мс)
  • Лицензия: Apache 2.0
  • Совместимость: Unity 2022.3 LTS и новее
  • Клиенты: Claude Desktop (MCP), Cursor, GitHub Copilot, Windsurf, Claude Code (Skill)
  • Инструментов: 65, категорий: 15
  • Зависимости: нулевые — только стандартная библиотека Python

Поделиться