Unity-MCP

Unity-MCP

IvanMurzakApache-2.0
3k звёзд282 форков
Unity-MCP — это связка MCP-сервера и плагина для Unity Editor. Она даёт AI-ассистентам прямой доступ к редактору: управлять сценой, объектами, кодом и ассетами. Разработчику достаточно описать задачу текстом, а нейросеть выполняет рутинные операции — создаёт примитивы, меняет компоненты, пишет скрипты. Сервер работает через транспорт stdio и подключается к любому MCP-клиенту: Claude Desktop, Continue.dev, Cline. Плагин работает в двух режимах — Editor (управление из окна редактора) и Runtime (управление запущенной игрой). Это ускоряет прототипирование в 5–10 раз и снижает порог входа в разработку на Unity.
Ai-mlUnityGaming
Открыть на GitHub

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

Общее

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

Технологии

  • Языки
    C#
  • Транспорт
    stdio

Описание

Возможности

  • Создание и удаление объектов на сцене: 3D-примитивы (кубы, сферы, капсулы), источники света, камеры, пустые объекты
  • Изменение трансформаций: перемещение с точными координатами, поворот по осям, равномерное масштабирование
  • Добавление, удаление и редактирование любых компонентов: скрипты, Rigidbody, Collider, MeshRenderer, Material
  • Работа с материалами: замена цвета, наложение текстур, изменение параметров шейдеров
  • Выполнение произвольного C#-кода в контексте Unity Editor — для реализации уникальной игровой логики
  • Управление ассетами: создание префабов, импорт моделей и текстур, работа с папками проекта
  • Управление режимом Play: запуск, пауза, остановка, перезапуск сцены
  • Чтение консоли редактора: получение логов, ошибок, предупреждений в реальном времени
  • Снятие скриншотов сцены и игрового окна для наглядной отдачи результатов
  • Поиск по иерархии: получение списка объектов, фильтрация по имени, тегу или типу компонента

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

Установите сервер Unity-MCP через npm. Для этого потребуется Node.js версии 18 или выше:

npm install -g unity-mcp-server

Установите Unity-пакет в ваш проект. Рекомендуемый способ — через OpenUPM:

openpm add com.ivanmurzak.unity.mcp

Если OpenUPM не установлен, добавьте пакет через Git URL в окне Package Manager. После установки настройте MCP-клиент. Пример конфигурации для Claude Desktop (claude_desktop_config.json):

{ "mcpServers": { "unity-mcp": { "command": "npx", "args": ["-y", "@ivanmurzak/unity-mcp-server"] } } }

Перезапустите MCP-клиент. Откройте Unity Editor, запустите плагин через меню Window → Unity MCP. Убедитесь, что в логах появилось сообщение об успешном подключении. Сервер готов к работе.

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

  • «Создай на сцене красный куб размером 3x3x3 на координатах (0, 1, 0) и добавь ему компонент Rigidbody»
  • «Напиши C# скрипт для вращения объекта вокруг оси Y со скоростью 90 градусов в секунду и прикрепи его к выбранному кубу»
  • «Переключись в режим Play, подожди 3 секунды и сделай скриншот игрового окна, сохрани его в папку Screenshots»
  • «Найди все объекты с тегом Enemy на сцене, замени их текущий материал на новый красный материал из папки Materials/Enemies»

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

  • Язык разработки: C# (плагин для Unity Editor), TypeScript (MCP-сервер)
  • Транспорт: stdio
  • Лицензия: Apache-2.0
  • Совместимость: Claude Desktop, Cline, Continue.dev, другие MCP-клиенты; Unity Editor 2020.3 и выше
  • Репозиторий: github.com/IvanMurzak/Unity-MCP

Поделиться