Repolode
CoderGamester

CoderGamester/mcp-unity

Плагин Model Context Protocol (MCP), с помощью которого AI-ассистенты для программирования, например Cursor, Claude Code и Codex, могут управлять Unity Editor и получать из него данные.

Звёзды
1,943
Форки
247
Открытые issues
7
Последний коммит
8 дней назад

Что это?

MCP Unity связывает Unity Editor с сервером Node.js, реализующим Model Context Protocol. Внутри Editor работает WebSocket-сервер, а сторона Node.js передаёт в Unity запросы от AI-клиентов, таких как Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot и OpenCode.

После подключения AI-ассистент может запускать пункты меню, создавать и обновлять GameObjects и компоненты, перемещать и вращать объекты, управлять сценами и префабами, редактировать материалы, устанавливать пакеты, запускать тесты через Unity Test Runner и читать логи консоли. Также доступны ресурсы со списками иерархии сцены, ассетов, пакетов и тестов, а ещё batch-инструмент для выполнения нескольких операций в одном запросе.

Пакет устанавливается через Unity Package Manager по git URL. Создать конфигурацию можно в окне Server Window в Editor, выбрав настройки для проекта или глобальные. Установка пакетов и запуск в batch mode по умолчанию отключены в целях безопасности, а соединение защищено токеном аутентификации для каждого проекта.

Ключевые возможности

  • 01Предоставляет AI-ассистентам операции с GameObject, компонентами, Transform и материалами.
  • 02Запускает пункты меню Unity и тесты EditMode/PlayMode через Test Runner.
  • 03Предоставляет логи консоли, иерархию сцены, ассеты и установленные пакеты в виде ресурсов MCP.
  • 04Управляет загрузкой, сохранением и выгрузкой сцен, а также состоянием Play Mode.
  • 05Поддерживает пакетное выполнение нескольких операций в одном запросе.
  • 06Создаёт конфигурации клиентов для Cursor, Claude Code, Codex CLI, Copilot и OpenCode.

Сценарии использования

  • Поручить AI-ассистенту настроить объекты сцены, префабы и материалы, описав задачу обычным языком.
  • Запускать тесты Unity из чата с AI и читать сообщения об ошибках в консоли.
  • Пакетно создавать или переименовывать множество GameObjects без ручных действий в Editor.
  • Помогать новым участникам освоиться в незнакомом проекте Unity, запрашивая иерархию сцены и список ассетов.

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

  1. 1

    Установите Node.js 18 или более поздней версии со страницы загрузки Node.js

  2. 2

    Установите пакет Unity MCP Server через Unity Package Manager (Window > Package Manager)

  3. 3

    Убедитесь, что Node.js установлен

    node --version

Что важно знать

  • Требуются Unity 6 или более поздней версии и Node.js 18 или более поздней версии.
  • Пути к проектам с пробелами могут вызывать проблемы с подключением.

Темы

Частые вопросы

Что такое mcp-unity?
Плагин Model Context Protocol (MCP), с помощью которого AI-ассистенты для программирования, например Cursor, Claude Code и Codex, могут управлять Unity Editor и получать из него данные. MCP Unity связывает Unity Editor с сервером Node.js, реализующим Model Context Protocol. Внутри Editor работает WebSocket-сервер, а сторона Node.js передаёт в Unity запросы от AI-клиентов, таких как Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot и OpenCode.
mcp-unity можно использовать бесплатно? Какая у него лицензия?
mcp-unity распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mcp-unity всё ещё поддерживается?
Активно поддерживается. Последний коммит в mcp-unity — 11 окт. 2026 г..
Для чего можно использовать mcp-unity?
Поручить AI-ассистенту настроить объекты сцены, префабы и материалы, описав задачу обычным языком. Запускать тесты Unity из чата с AI и читать сообщения об ошибках в консоли. Пакетно создавать или переименовывать множество GameObjects без ручных действий в Editor. Помогать новым участникам освоиться в незнакомом проекте Unity, запрашивая иерархию сцены и список ассетов.
Как установить mcp-unity?
Установите Node.js 18 или более поздней версии со страницы загрузки Node.js Установите пакет Unity MCP Server через Unity Package Manager (Window > Package Manager) Убедитесь, что Node.js установлен: node --version
Где скачать mcp-unity?
Исходный код и инструкции по установке — на GitHub: https://github.com/CoderGamester/mcp-unity

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты