Unity MCP

CoplayDev/unity-mcp· Проверено 12.11.2026· 15,9 тыс.на GitHub

Даёт агенту управлять редактором Unity: создавать сцены и объекты, писать и проверять C#-скрипты, ставить пакеты, запускать тесты и сборку. Работает через пакет-плагин в проекте.

2 реализации:

50 инструментов по группам: сцены, скрипты, материалы, физика, профайлер, VFX, генерация ассетов; сам настраивает найденные клиенты.

Как подключить

Что сделать до подключения

Unity 2021.3 LTS или новее, Python 3.10 или новее с uv, git в PATH

В Unity: Window → Package Manager → + → Add package from git URL и вставить https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Пройти мастер настройки, который откроется после импорта: проверить Python и uv, выбрать клиенты и нажать Configure Selected

Проверить статус в Window → MCP for Unity: там должно стоять Connected

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio unity \
  -- uvx --from mcpforunityserver mcp-for-unity --transport stdio

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.unity]
command = "uvx"
args = ["--from", "mcpforunityserver", "mcp-for-unity", "--transport", "stdio"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "unity": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "unity": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "unity": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "unity": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "unity": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "mcpforunityserver",
          "mcp-for-unity",
          "--transport",
          "stdio"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "unity": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "unity": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpforunityserver",
        "mcp-for-unity",
        "--transport",
        "stdio"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

manage_sceneсоздаёт, открывает и сохраняет сцены

manage_gameobjectсоздаёт и меняет объекты

find_gameobjectsищет объекты по имени и компонентам

manage_componentsдобавляет компоненты и свойства

create_scriptсоздаёт C#-скрипт

script_apply_editsправит методы и классы

validate_scriptпроверяет скрипт на ошибки

read_consoleчитает консоль редактора

manage_assetимпортирует и меняет ассеты

manage_materialнастраивает материалы и шейдеры

manage_prefabsработает с префабами

manage_packagesставит и удаляет пакеты

manage_buildзапускает сборку под платформу

run_testsзапускает тесты

manage_profilerснимает замеры профайлера

manage_uiправит UI Toolkit

execute_codeвыполняет C# в редакторе

generate_modelгенерирует 3D-модель через Tripo или Meshy

blender_bridgeсвязывается с запущенным Blender

unity_docsищет в документации Unity

Показано 20 из 50.

Мало инструментов на виду: основная работа идёт через язык запросов RQL к содержимому редактора, плюс навыки для агента и запуск внутри собранной игры.

Как подключить

Что сделать до подключения

Проект Unity по пути без пробелов

Поставить плагин: открыть в проекте AI-Game-Dev-Installer.unitypackage, выполнить openupm add com.ivanmurzak.unity.mcp или unity-mcp-cli install-plugin

В Unity открыть Window/AI Game Dev и нажать Configure для MCP или Auto-generate для навыков

Взять порт и готовый JSON для клиента в окне AI Game Developer

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio unity-mcp \
  -- '<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server' 'port=<порт>' client-transport=stdio

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.unity-mcp]
command = "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server"
args = ["port=<порт>", "client-transport=stdio"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "unity-mcp": {
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "unity-mcp": {
      "type": "stdio",
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "unity-mcp": {
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "unity-mcp": {
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "unity-mcp": {
        "type": "local",
        "command": [
          "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
          "port=<порт>",
          "client-transport=stdio"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "unity-mcp": {
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "unity-mcp": {
      "command": "<папка проекта>/Library/mcp-server/<платформа>/gamedev-mcp-server",
      "args": ["port=<порт>", "client-transport=stdio"]
    }
  }
}

Инструменты сервера

rql-queryчитает редактор запросом RQL

rql-mutateменяет объекты и вызывает операции

rql-schemaописывает источники и вызовы RQL

screenshot-isolatedснимает объект с выбранного ракурса

screenshot-scene-viewснимает окно Scene

script-executeкомпилирует и выполняет C#

script-update-or-createсоздаёт или правит скрипт

tests-runзапускает тесты EditMode и PlayMode

package-addставит пакет Unity

assetstore-addимпортирует ваш пакет Asset Store

unity-tool-listпоказывает все инструменты

tool-set-visibilityпоказывает или прячет инструменты

Что попросить агента

«Создай куб в начале координат и добавь ему Rigidbody»Агент вызовет manage_gameobject для куба и manage_components для Rigidbody

«Объясни иерархию моей сцены»В MCP for Unity агент вызовет find_gameobjects, в AI Game Developer — rql-query

«Поставь 3 сферы одну на другую»Агент создаст объекты через manage_gameobject и выставит позиции

«Создай металлический золотой материал и повесь его на новую сферу»Агент вызовет manage_material, затем manage_gameobject и назначит материал

«Напиши контроллер игрока: движение на WASD и двойной прыжок»Агент вызовет create_script, проверит код validate_script и посмотрит ошибки в read_console

Для каких задач

Собрать сцену по словам: «создай куб в начале координат и добавь Rigidbody»

Написать контроллер игрока с движением на WASD и двойным прыжком

Найти скрипты, которые ссылаются на Rigidbody, и разобрать иерархию сцены

Создать материал и повесить его на новый объект

Запустить тесты и сборку под нужную платформу

Отдать языковой модели решения бота в собранной игре, например в шахматах

Ограничения

MCP for Unity по умолчанию слушает HTTP на localhost:8080: сервер должен быть запущен из окна Window → MCP for Unity, а в Cursor и Antigravity его ещё надо включить в настройках

AI Game Developer требует путь к проекту без пробелов и клиент, который умеет работать с навыками или обновлять список инструментов на лету

AI Game Developer по умолчанию подключается к облаку ai-game.dev; для локального сервера выберите режим Custom в окне AI Game Dev

Оба сервера выполняют произвольный C# в редакторе: execute_code в MCP for Unity и script-execute в AI Game Developer

Если не работает

Клиент пишет No Unity Instances Found

Перезапустите клиент: он путается, если сменить транспорт посреди сессии. Если не помогло, проверьте статус Connected в окне MCP for Unity и нажмите Window → MCP for Unity → Restart Server.

Package Manager пишет Error when executing git command или fatal: not in a git directory

Поставьте git и перезапустите Unity. Если папка проекта принадлежит другому пользователю, добавьте её в доверенные: git config --global --add safe.directory "<путь к проекту>".

Unity не находит claude, хотя в терминале команда работает

Приложения на macOS, запущенные из Finder или Hub, не видят PATH оболочки. В окне MCP for Unity нажмите Choose Claude Location и укажите полный путь к claude.

В VS Code при первом запуске сервера ответ Canceled: Canceled

Начните новый чат: старый не подхватил настройки MCP-сервера.

На Windows клиент не может запустить сервер, хотя uv установлен

На машине несколько копий uv.exe. В окне MCP for Unity нажмите Choose UV Install Location и выберите %LOCALAPPDATA%\Microsoft\WinGet\Links\uv.exe.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP for Unity	Coplay (Aura)	15,9 тыс.	локально	не нужен	50	30 октября 2026
AI Game Developer (Unity-MCP)	Ivan Murzak	4,6 тыс.	локально	не нужен	12	12 ноября 2026

Частые вопросы

Какой из двух серверов выбрать?

MCP for Unity даёт агенту 50 инструментов по группам и сам прописывает себя в найденные клиенты. AI Game Developer держит на виду 7 инструментов и работает через запросы RQL, зато умеет генерировать навыки под проект и работать внутри собранной игры.

Какие версии Unity поддерживаются?

MCP for Unity работает с Unity от 2021.3 LTS до 6.x. Для AI Game Developer есть установщик .unitypackage и пакет OpenUPM com.ivanmurzak.unity.mcp.

Как подключить Claude Desktop к MCP for Unity?

Claude Desktop работает только через stdio: пропишите команду uvx с аргументами --from mcpforunityserver mcp-for-unity --transport stdio. Мастер настройки делает это сам, даже если глобально выбран HTTP.

Где взять команду запуска для AI Game Developer?

Сервер лежит в папке проекта Library/mcp-server/ под вашу платформу: win-x64, osx-arm64, linux-x64 и другие. Подставьте полный путь к проекту и порт из окна AI Game Developer; готовый JSON показывается там же.

Агент может сгенерировать модели и звуки?

В MCP for Unity есть группа asset_gen: модели через Tripo, Meshy и fal, картинки через fal.ai и OpenRouter, звуки через fal.ai. Ключи провайдеров нужны свои.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере; облачный режим AI Game Developer требует входа на ai-game.dev, а генерация моделей в MCP for Unity идёт через Tripo, Meshy и fal.ai по вашим ключам.

Unity MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы