Unity MCP

English	简体中文

При поддержке и обслуживании Coplay — лучшего AI-ассистента для Unity.

Создавайте Unity-приложения с помощью LLM! MCP for Unity соединяет AI-ассистентов (Claude, Claude Code, Cursor, VS Code и др.) с Unity Editor через Model Context Protocol. Предоставьте LLM инструменты для управления ассетами, сценами, скриптами и автоматизации задач.

• v9.6.3 (beta) — Новый инструмент manage_profiler (14 действий): управление сессиями профилировщика (start/stop/status/set areas), чтение тайминга кадров и счётчиков, запросы памяти объектов, снимки памяти (take/list/compare через com.unity.memoryprofiler), Frame Debugger (enable/disable/get events). Группа: profiling.
• v9.6.2 — Новый инструмент manage_physics (21 действие): настройки физики, матрица коллизий слоёв, физические материалы, джоинты (5 типов 3D + 9 типов 2D), запросы (raycast, raycast_all, linecast, shapecast, overlap), применение сил (AddForce/AddTorque/AddExplosionForce), конфигурация rigidbody, валидация сцены и симуляция в режиме редактора. Полная поддержка 3D и 2D.
• v9.6.1 — Улучшения качества жизни: manage_editor получил действия undo/redo. manage_scene получил редактирование нескольких сцен (аддитивная загрузка, закрытие, установка активной, перемещение GO между сценами), шаблоны сцен (3d_basic, 2d_basic и др.) и валидацию сцен с автоисправлением. Новый инструмент manage_build: запуск сборок, переключение платформ, настройка параметров плеера, управление сценами и профилями сборки (Unity 6+), пакетные сборки для нескольких платформ, асинхронное отслеживание задач с поллингом. Новая инфраструктура MaxPollSeconds для длительных операций.
• v9.5.4 — Новые инструменты unity_reflect и unity_docs для верификации API: инспекция живых C# API через рефлексию и получение официальной документации Unity (ScriptReference, Manual, документация пакетов). Новый инструмент manage_packages: установка, удаление, поиск и управление пакетами Unity и scoped-реестрами. Включает валидацию входных данных, проверку зависимостей при удалении и предупреждения о git URL.
• v9.5.3 — Новый инструмент manage_graphics (33 действия): volume/post-processing, запекание освещения, статистика рендеринга, настройки пайплайна, функции URP renderer. 3 новых ресурса: volumes, rendering_stats, renderer_features.
• v9.5.2 — Новый инструмент manage_camera с поддержкой Cinemachine (пресеты, приоритет, шум, блендинг, расширения), ресурс cameras, исправление сохранения приоритета через SerializedProperty.

• v9.4.8 — Новый UI редактора, переключение инструментов в реальном времени через manage_tools, окно синхронизации навыков, скриншот с нескольких видов, установщик Roslyn в один клик, клиенты Qwen Code и Gemini CLI, редактирование ProBuilder-мешей через manage_probuilder.
• v9.4.7 — Маршрутизация вызовов по экземплярам Unity, исправление PATH для macOS pyenv, устойчивость инструментов скриптов к перезагрузке домена.
• v9.4.6 — Новый инструмент manage_animation, поддержка клиента Cline, обнаружение устаревших соединений, сохранение состояния инструментов между перезагрузками.
• v9.4.4 — Настраиваемые лимиты batch_execute, фильтрация инструментов по состоянию сессии, исправления loopback для IPv6/IPv4.

---

Быстрый старт

Требования

• Unity 2021.3 LTS+ — Скачать Unity
• Python 3.10+ и uv — Установить uv
• MCP-клиент — Claude Desktop | Claude Code | Cursor | VS Code Copilot | GitHub Copilot CLI | OpenClaw

1. Установка Unity-пакета

В Unity: Window > Package Manager > + > Add package from git URL...

[!TIP]

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Хотите последнюю бета-версию? Используйте ветку beta:

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta

Unity Asset Store:

1. Перейдите на страницу MCP for Unity в Asset Store
2. Нажмите Add to My Assets, затем импортируйте через Window > Package Manager

OpenUPM:

openupm add com.coplaydev.unity-mcp

2. Запуск сервера и подключение

1. В Unity: Window > MCP for Unity
2. Нажмите Start Server (запускает HTTP-сервер на localhost:8080)
3. Выберите MCP-клиент из выпадающего списка и нажмите Configure
4. Дождитесь появления 🟢 «Connected ✓»
5. Подключите клиент: для некоторых клиентов (Cursor, Antigravity, OpenClaw) требуется дополнительная активация