Ivan Murzak

Unity MCP (сервер + плагин)

Версия Unity	Режим редактирования	Режим игры	Автономный
2022.3.61f1
2023.2.20f1
6000.0.46f1

Unity-MCP — это мост между LLM и Unity. Он раскрывает и объясняет LLM инструменты Unity. LLM понимает интерфейс и использует инструменты так, как просит пользователь.

Подключите Unity-MCP к клиенту LLM, такому как Claude или Cursor, используя интегрированное окно AI Connector . Также поддерживаются пользовательские клиенты.

Проект разработан, чтобы позволить разработчикам добавлять пользовательские инструменты в ближайшее время. После этого следующая цель — включить те же функции в сборку игрока. Для не это работает только в редакторе Unity.

Система расширяема: вы можете определять пользовательские tool непосредственно в кодовой базе проекта Unity, предоставляя новые возможности клиентам ИИ или автоматизации. Это делает Unity-MCP гибкой основой для создания расширенных рабочих процессов, быстрого прототипирования или интеграции функций, управляемых ИИ, в процесс разработки.

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

GameObject

• ✅ Создать
• ✅ Уничтожить
• ✅ Найти
• ✅ Изменить (тег, слой, имя, статика)
• ✅ Установить родителя
• ✅ Дубликат

GameObject.Компоненты

• ✅ Добавить компонент
• ✅ Получить компоненты
• ✅ Изменить компонент
• • ✅ Значение набора Field
• • ✅ Стоимость набора Property
• • ✅ Набор ссылок Reference
• ✅ Уничтожить компонент
• 🔲 Удалить недостающие компоненты

Редактор

• ✅ Состояние (режим игры)
  • ✅ Получить
  • ✅ Набор
• ✅ Получить Windows
• ✅ Слой
  • ✅ Получить все
  • ✅ Добавить
  • ✅ Удалить
• ✅ Тег
  • ✅ Получить все
  • ✅ Добавить
  • ✅ Удалить
• ✅ Выполнить MenuItem
• 🔲 Проведение тестов

Редактор.Выбор

• ✅ Получить выбор
• ✅ Выбор набора

Сборные

• ✅ Создать экземпляр
• 🔲 Создать
• ✅ Открыть
• ✅ Изменить (GameObject.Modify)
• ✅ Сохранить
• ✅ Закрыть

Упаковка

• 🔲 Установить
• 🔲 Установить
• 🔲 Удалить
• 🔲 Обновление

Ресурсы

• ✅ Создать
• ✅ Найти
• ✅ Обновить
• ✅ Читать
• ✅ Изменить
• ✅ Переименовать
• ✅ Удалить
• ✅ Двигаться
• ✅ Создать папку

Сцена

• ✅ Создать
• ✅ Сохранить
• ✅ Загрузить
• ✅ Выгрузить
• ✅ Зарядись
• ✅ Получить иерархию
• 🔲 Поиск (редактор)
• 🔲 Raycast (понимание громкости)

Материалы

• ✅ Создать
• ✅ Изменить (Активы.Изменить)
• ✅ Читать (Активы.Читать)
• ✅ Назначить компоненту на игровом объекте

Шейдер

• ✅ Список всех

Скрипты

• ✅ Читать
• ✅ Обновить или создать
• ✅ Удалить

Скриптируемый объект

• 🔲 Создать
• 🔲 Читать
• 🔲 Изменить
• 🔲 Удалить

Отлаживать

• 🔲 Чтение журналов (консоль)

Компонент

• ✅ Получить все

Легенда: ✅ = Реализовано и доступно, 🔲 = Планируется / Еще не реализовано

Установка

1. Установить .NET 9.0
2. Установить OpenUPM-CLI

• Откройте командную строку в папке проекта Unity
• Выполните команду

Использование

1. Убедитесь, что путь к вашему проекту не содержит символа пробела « ».

• ✅ C:/MyProjects/Project
• ❌ C:/My Projects/Project

2. Откройте проект Unity, перейдите 👉 Window/AI Connector (Unity-MCP) .

3. Установить MCP-клиент

• Установить курсор (рекомендуется)
• Установить Клода

4. Войдите в клиент MCP
5. Нажмите Configure на клиенте MCP.

6. Перезапустите клиент MCP.
7. Убедитесь, что AI Connector находится в состоянии «Подключен» или «Подключается...» после перезапуска.
8. Тестовое подключение ИИ в вашем Клиенте (Курсор, Claude Desktop). Введите любой вопрос или задачу в чат. Что-то вроде:

Добавить пользовательский tool

⚠️ Работает только с клиентом MCP, который поддерживает динамическое обновление списка инструментов.

Unity-MCP предназначен для поддержки разработки пользовательских tool владельцем проекта. Сервер MCP берет данные из плагина Unity и предоставляет их Клиенту. Таким образом, любой в цепочке связи MCP получит информацию о новом tool . Который LLM может решить вызвать в какой-то момент.

Чтобы добавить пользовательский tool , вам необходимо:

1. Иметь класс с атрибутом McpPluginToolType .
2. Иметь метод в классе с атрибутом McpPluginTool .
3. [необязательно] Добавьте атрибут Description к каждому аргументу метода, чтобы LLM мог его понять.
4. [необязательно] Используйте свойства string? optional = null с ? и значением по умолчанию, чтобы пометить их как optional для LLM.

Обратите внимание, что строка MainThread.Run(() => позволяет запустить код в главном потоке, который необходим для взаимодействия с API Unity. Если вам это не нужно и запуск инструмента в фоновом потоке подходит для инструмента, не используйте главный поток в целях повышения эффективности.

Добавить пользовательский внутриигровой tool

⚠️ Пока не поддерживается. Работа в процессе

Вклад

Не стесняйтесь добавлять новые tool в проект.

1. Создайте ответвление проекта.
2. Реализуйте новый tool в вашем разветвленном репозитории.
3. Создайте запрос на извлечение в исходный репозиторий Unity-MCP .