Unity-MCP — MCP-сервер для Unity: ИИ-агент в редакторе и в игре
Подключает Claude, Codex, Cursor и другие ИИ-клиенты к Unity через MCP: агент управляет редактором, пишет код и работает внутри собранной игры.
claude mcp add --env UNITY_MCP_PORT=<UNITY_MCP_PORT> --env UNITY_MCP_PLUGIN_TIMEOUT=<UNITY_MCP_PLUGIN_TIMEOUT> --env UNITY_MCP_CLIENT_TRANSPORT=<UNITY_MCP_CLIENT_TRANSPORT> --transport stdio unity-mcp-server -- docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1Что делает Unity-MCP
Сервер связывает MCP-клиент с Unity Editor и с рантаймом собранной игры. Из агента можно вызывать инструменты редактора, генерировать механики и тесты, а в рантайме — подключать LLM прямо в игру, например для поведения NPC или отладки. Скиллы генерируются под вашу систему, версию Unity и плагины в проекте.
Внутри два компонента: MCP-сервер и плагин для Unity. Сервер запускается в Docker (docker.io/ivanmurzakdev/unity-mcp-server:0.17.1), транспорт — stdio локально или http удалённо. Плагин ставится в проект через установщик .unitypackage либо CLI: npm install -g unity-mcp-cli, затем unity-mcp-cli install-plugin ./MyUnityProject и unity-mcp-cli login (вход через браузер по OAuth device flow).
Перед запуском нужен Docker и три переменные окружения: UNITY_MCP_PORT, UNITY_MCP_PLUGIN_TIMEOUT, UNITY_MCP_CLIENT_TRANSPORT. Если Docker не поднят, сервер не стартует — это первое, что стоит проверить при ошибке подключения. Свои инструменты можно дописать в коде проекта.
Какие задачи решает
- управлять сценами и объектами Unity из чата с агентом
- сгенерировать игровую механику и тесты к ней
- подключить LLM внутрь собранной игры для NPC
- найти и починить ошибку в проекте силами агента
- собрать набор скиллов под версию Unity и плагины проекта
Примеры запросов агенту
- подключись к Unity и покажи список объектов в текущей сцене
- создай скрипт движения персонажа и добавь его на объект Player
- включи рантайм-режим и подключи LLM к поведению NPC
Как установить Unity-MCP
Командой платформы
claude mcp add --env UNITY_MCP_PORT=<UNITY_MCP_PORT> --env UNITY_MCP_PLUGIN_TIMEOUT=<UNITY_MCP_PLUGIN_TIMEOUT> --env UNITY_MCP_CLIENT_TRANSPORT=<UNITY_MCP_CLIENT_TRANSPORT> --transport stdio unity-mcp-server -- docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1Вместо <…> подставьте свои значения
Командой платформы
codex mcp add unity-mcp-server --env UNITY_MCP_PORT=<UNITY_MCP_PORT> --env UNITY_MCP_PLUGIN_TIMEOUT=<UNITY_MCP_PLUGIN_TIMEOUT> --env UNITY_MCP_CLIENT_TRANSPORT=<UNITY_MCP_CLIENT_TRANSPORT> -- docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"unity-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"UNITY_MCP_PORT",
"-e",
"UNITY_MCP_PLUGIN_TIMEOUT",
"-e",
"UNITY_MCP_CLIENT_TRANSPORT",
"docker.io/ivanmurzakdev/unity-mcp-server:0.17.1"
],
"env": {
"UNITY_MCP_PORT": "<UNITY_MCP_PORT>",
"UNITY_MCP_PLUGIN_TIMEOUT": "<UNITY_MCP_PLUGIN_TIMEOUT>",
"UNITY_MCP_CLIENT_TRANSPORT": "<UNITY_MCP_CLIENT_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"unity-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"UNITY_MCP_PORT",
"-e",
"UNITY_MCP_PLUGIN_TIMEOUT",
"-e",
"UNITY_MCP_CLIENT_TRANSPORT",
"docker.io/ivanmurzakdev/unity-mcp-server:0.17.1"
],
"env": {
"UNITY_MCP_PORT": "<UNITY_MCP_PORT>",
"UNITY_MCP_PLUGIN_TIMEOUT": "<UNITY_MCP_PLUGIN_TIMEOUT>",
"UNITY_MCP_CLIENT_TRANSPORT": "<UNITY_MCP_CLIENT_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e UNITY_MCP_PORT=<UNITY_MCP_PORT> -e UNITY_MCP_PLUGIN_TIMEOUT=<UNITY_MCP_PLUGIN_TIMEOUT> -e UNITY_MCP_CLIENT_TRANSPORT=<UNITY_MCP_CLIENT_TRANSPORT> unity-mcp-server docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Геймдев и 3D: Unity, Unreal, Godot, Blender»
Всё по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →Вопросы о Unity-MCP
Как установить Unity-MCP в Claude?
Добавьте сервер командой `claude mcp add --env UNITY_MCP_PORT=<UNITY_MCP_PORT> --env UNITY_MCP_PLUGIN_TIMEOUT=<UNITY_MCP_PLUGIN_TIMEOUT> --env UNITY_MCP_CLIENT_TRANSPORT=<UNITY_MCP_CLIENT_TRANSPORT> --transport stdio unity-mcp-server -- docker run -i --rm -e UNITY_MCP_PORT -e UNITY_MCP_PLUGIN_TIMEOUT -e UNITY_MCP_CLIENT_TRANSPORT docker.io/ivanmurzakdev/unity-mcp-server:0.17.1. Плагин в сам проект Unity ставится отдельно — установщиком или через unity-mcp-cli install-plugin`.
Что делает Unity-MCP?
Даёт ИИ-агенту доступ к Unity Editor и к рантайму игры по протоколу MCP. Агент вызывает инструменты редактора, пишет код и тесты, а в собранной игре может работать с LLM напрямую.
Что нужно для работы Unity-MCP?
Docker для запуска сервера и плагин, установленный в проект Unity. Серверу передаются переменные UNITY_MCP_PORT, UNITY_MCP_PLUGIN_TIMEOUT и UNITY_MCP_CLIENT_TRANSPORT.
