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

Меняет и удаляет сцены, объекты и префабы, ставит пакеты из сети, выполняет пункты меню редактора. Делайте коммит перед работой, не включайте удалённые подключения к мосту без нужды, подтверждайте удаление и установку пакетов.

Настройка клиентов

codex
{
    "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.

~/.cursor/mcp.json
{
  "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.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

Pascal 3D Editor

Создание, проверка и сохранение редактируемых 3D-сцен зданий в редакторе Pascal.

Риск: high Лицензия: MIT ★ 25 446

Источники