Плагин и MCP-сервер для Unity Editor и игр, позволяющий AI-агентам управлять проектами Unity и запускать LLM внутри игр.
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
Установите Node.js 18 или более поздней версии со страницы загрузки Node.js
- 2
Установите пакет Unity MCP Server через Unity Package Manager (Window > Package Manager)
- 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 обновляется ежедневно.
Похожие проекты
MCP-сервер, который позволяет AI-агентам запускать редактор Godot и проекты, собирать отладочный вывод и управлять сценами.
Интеграция async/await без аллокаций для Unity: позволяет ожидать Unity AsyncOperations, корутины и события, выполняясь в PlayerLoop без потоков.
Внутриигровая консоль на uGUI для Unity: показывает логи во время выполнения и позволяет запускать зарегистрированные отладочные команды в сборках.
Плагин для Unreal Engine 5.8+ под лицензией MIT, который расширяет встроенный MCP-сервер Unreal и позволяет AI-агентам работать с редактором в разных областях.
Расширение Unity для генерации 2D-навигационных сеток и поиска пути в top-down-играх с Tilemap, спрайтами и Collider2D.