Unity MCP — MCP-сервер для Claude Code: что делает и как установить
Встраивает протокол MCP прямо в Unity Editor. Через него агент считывает логи редактора и меняет сцены без переключения окон.
Открыть на GitHubЧто делает Unity MCP
В отличие от сторонних мостов, сервер поднимается внутри самого процесса Unity Editor и слушает локальный адрес http://127.0.0.1:<port>/mcp. Отдельный процесс для MCP не требуется. Для командной строки используется утилита isuzu-unity-cli, собранная в виде нативного бинарника без зависимостей от Node.js или рантайма .NET. Каждое действие по изменению ассетов или компонентов объединяется в одну операцию отмены Undo.
Для работы нужен Unity Editor 2022.3 или новее, а также установленный Git от версии 2.14.0 в переменной PATH, если пакет ставится через Package Manager. При установке через VPM в VCC или ALCOM клиент Git не требуется. Сервер слушает только локальный сетевой интерфейс и требует bearer token для вызовов, поэтому внешние сетевые подключения блокируются на корню.
Какие задачи решает
- читать диагностику консоли и ошибки компиляции Unity
- создавать игровые объекты, префабы и сцены с поддержкой Undo
- запускать тесты EditMode и собирать отчёты о падениях
- симулировать ввод мыши и клавиатуры в окне редактора
Примеры запросов агенту
- Проверь консоль Unity и исправь найденные ошибки компиляции в текущем скрипте.
- Создай префаб с компонентом Rigidbody и добавь его на открытую сцену.
- Запусти тесты проекта через Unity MCP и покажи упавшие проверки.
Как установить Unity MCP
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Unity MCP
Как установить Unity MCP в Claude Code?
В Unity Package Manager добавьте git URL https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp. Затем установите CLI через скрипт curl -fsSL https://raw.githubusercontent.com/isuzu-shiranui/UnityMCP/main/install.sh | sh (в Windows: irm https://raw.githubusercontent.com/isuzu-shiranui/UnityMCP/main/install.ps1 | iex) и выполните команду isuzu-unity-cli setup --mcp --agent claude-code.
Что делает Unity MCP?
Сервер даёт ИИ-агентам доступ к API редактора Unity. Модели могут инспектировать сцену, вызывать C#-методы, настраивать анимации и управлять компиляцией.
Нужен ли отдельный процесс MCP-сервера?
Нет, эндпоинт Streamable HTTP поднимается внутри самого редактора Unity при открытии проекта. CLI находит нужный порт через локальные дескрипторы без ручной настройки.
