MCP Unity
MCP Unity — плагин сообщества для Unity 6 с MCP-сервером на Node.js. Он даёт ассистенту в Cursor, Claude Code, Codex и других клиентах менять объекты и компоненты, создавать сцены и префабы, запускать тесты и читать логи консоли.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- CoderGamester
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- windows, macos, linux
- Языки
- csharp, typescript
Уровень риска: high
Меняет и удаляет сцены, объекты и префабы, ставит пакеты из сети, выполняет пункты меню редактора. Делайте коммит перед работой, не включайте удалённые подключения к мосту без нужды, подтверждайте удаление и установку пакетов.
Настройка клиентов
{
"code": "[mcp_servers.mcp-unity]\ncommand = \"node\"\nargs = [\"ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js\"]",
"file": "~/.codex/config.toml",
"lang": "toml",
"verified": "docs"
}
Что умеет
MCP Unity — проект сообщества, плагин для редактора Unity с MCP-сервером на Node.js. Он даёт ассистенту в Cursor, Claude Code, Codex и других клиентах управлять сценой и проектом.
- Выбирает и меняет игровые объекты: имя, тег, слой, активность, компоненты и их поля.
- Создаёт, загружает и удаляет сцены, создаёт префабы и добавляет ассеты в сцену.
- Запускает пункты меню редактора и тесты через Unity Test Runner.
- Читает логи консоли Unity и пишет в неё сообщения.
- Ставит пакеты через Package Manager.
- Даёт IDE доступ к кешу пакетов, чтобы ассистент лучше понимал код зависимостей.
Кому подойдёт
- Разработчику на Unity 6, который хочет настроить клиент одной кнопкой из окна плагина.
- Команде, которая хранит конфиг MCP в репозитории проекта: плагин умеет писать конфиг с относительным путём.
- Пользователям Codex: для него в README есть готовый TOML.
Не подойдёт для версий Unity старше Unity 6.
Установка
Нужны Unity 6 или новее и Node.js 18 или новее. Плагин ставится через Package Manager: Window → Package Manager → + → Add package from git URL и адрес:
https://github.com/CoderGamester/mcp-unity.gitЗатем откройте Tools → MCP Unity → Server Window и нажмите Configure напротив нужного клиента. Вариант с пометкой (Project) пишет конфиг в папку проекта с относительным путём, его можно хранить в git.
Подключение к клиентам
Если удобнее вручную, замените ABSOLUTE/PATH/TO на путь к установленному плагину или скопируйте готовый текст из Server Window. Конфиги — из README проекта. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": [
"ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
]
}
}
}Для конфига в проекте (.cursor/mcp.json в корне Unity-проекта) используйте относительный путь, как во вкладке Claude Code.
Проверка
Запустите сервер в Unity (Server Window), затем откройте клиент и попросите показать логи консоли Unity. Ассистент должен вызвать get_console_logs. Если связи нет, проверьте порт WebSocket в настройках плагина и путь к index.js в конфиге.
Частые ошибки: Node.js не установлен или старше 18, неверный путь к Server~/build/index.js, пробелы в пути к проекту (поддерживаются, но при проблемах со связью README советует путь без пробелов). Для WSL2 в README есть отдельный раздел про сеть.
Инструменты
| Инструмент | Что делает | Доступ |
|---|---|---|
execute_menu_item |
Выполняет пункт меню редактора | запись |
select_gameobject |
Выбирает объект в иерархии | чтение |
update_gameobject |
Меняет свойства объекта или создаёт его | запись |
update_component |
Меняет или добавляет компонент | запись |
add_package |
Ставит пакет через Package Manager | запись |
run_tests |
Запускает тесты Unity Test Runner | запись |
create_prefab |
Создаёт префаб | запись |
create_scene, load_scene, delete_scene |
Создаёт, загружает и удаляет сцены | запись |
get_gameobject |
Подробности об объекте и его компонентах | чтение |
get_console_logs |
Логи консоли Unity | чтение |
Примеры задач
Добавь объекту Player компонент Rigidbody и поставь массу 5.Создай сцену Level1 в папке Scenes и добавь в неё префаб Player.Запусти все EditMode-тесты и покажи, какие упали.Риски
Плагин меняет сцены, объекты и префабы, может удалять сцены, ставить пакеты и запускать любые пункты меню редактора. Пакеты скачиваются из сети. Мост между сервером и Unity работает через WebSocket; удалённые подключения к нему по README включаются отдельной настройкой.
Как снизить риски: делайте коммит перед работой с ассистентом, не включайте удалённые подключения без нужды, подтверждайте в клиенте вызовы, которые что-то удаляют или ставят.
Частые вопросы
Какие версии Unity поддерживаются?
По README нужен Unity 6 или новее.
Можно ли хранить конфиг в репозитории проекта?
Да. Кнопки с пометкой (Project) пишут конфиг с путём относительно проекта, его можно коммитить.
Под какой лицензией проект?
MIT, это подтверждает файл LICENSE.md в репозитории.
Сравнение серверов для Unity — на странице MCP для Unity, категория — 3D и геймдев. Основы протокола — на странице что такое MCP-сервер.
Инструменты
- execute_menu_item
- select_gameobject
- update_gameobject
- update_component
- add_package
- run_tests
- create_prefab
- create_scene
- delete_scene
- get_gameobject
- get_console_logs
Похожие MCP-серверы
MCP for Blender
MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
Pascal 3D Editor
Создание, проверка и сохранение редактируемых 3D-сцен зданий в редакторе Pascal.