Unity MCP Server — MCP-сервер для Claude Code: как установить
Открывает ИИ-ассистентам доступ к файлам, сценам и настройкам Unity без запуска редактора. Пригодится для разбора структуры проекта через терминал или IDE.
claude mcp add unity-mcp-server -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-serverЧто делает Unity MCP Server
Сервер работает напрямую с диском и парсит файлы ассетов, манифесты пакетов и параметры движка через стандартный ввод-вывод stdio. Благодаря этому Claude Code, Cursor или другие клиенты видят порядок сцен в сборке, теги слоёв, настройки физики и список пакетов. Запускать сам Unity Editor не требуется.
Внутри заложены десятки инструментов для анализа структуры кода, поиска зависимостей между сборками asmdef и проверки матрицы коллизий. Инструмент умеет строить граф пакетов и читать глобальные настройки проекта.
Для работы серверу обязательно нужна переменная окружения UNITY_PROJECT_PATH с путём к корню проекта, иначе обращаться к файлам не получится.
Какие задачи решает
- проверить список сцен и порядок их сборки
- найти зависимости между сборками asmdef
- выяснить параметры слоёв и матрицы столкновений
- просмотреть установленные пакеты движка
Примеры запросов агенту
- Какие сцены включены в текущую сборку Unity?
- Покажи матрицу столкновений для физических слоёв
- Какие сборки ссылаются на
MyGame.Core?
Как установить Unity MCP Server
Командой платформы
claude mcp add unity-mcp-server -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add unity-mcp-server --env UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"unity-mcp-server": {
"command": "npx",
"args": [
"-y",
"unity-mcp-server"
],
"env": {
"UNITY_PROJECT_PATH": "<UNITY_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"unity-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"unity-mcp-server"
],
"env": {
"UNITY_PROJECT_PATH": "<UNITY_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> unity-mcp-server npx -y unity-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Unity MCP Server
Как установить Unity MCP Server в Claude Code?
Выполните команду claude mcp add unity-mcp-server -e UNITY_PROJECT_PATH=<UNITY_PROJECT_PATH> -- npx -y unity-mcp-server, подставив вместо плейсхолдера путь к папке проекта.
Зачем нужен Unity MCP Server?
Он позволяет ИИ-ассистентам читать конфигурации, зависимости скриптов и манифесты Unity без открытого окна редактора.
Нужен ли запущенный редактор Unity для работы?
Нет, сервер читает файлы проекта напрямую с диска, поэтому запуск Unity Editor не требуется.
