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

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

• Выполните команду

openupm add com.ivanmurzak.unity.mcp

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

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). Введите любой вопрос или задачу в чат. Что-то вроде:

Explain my scene hierarchy

Добавить пользовательский 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. Если вам это не нужно и запуск инструмента в фоновом потоке подходит для инструмента, не используйте главный поток в целях повышения эффективности.

[McpPluginToolType]
public class Tool_GameObject
{
    [McpPluginTool
    (
        "MyCustomTask",
        Title = "Create a new GameObject"
    )]
    [Description("Explain here to LLM what is this, when it should be called.")]
    public string CustomTask
    (
        [Description("Explain to LLM what is this.")]
        string inputData
    )
    {
        // do anything in background thread

        return MainThread.Run(() =>
        {
            // do something in main thread if needed

            return $"[Success] Operation completed.";
        });
    }
}

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

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

Вклад

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

1. Создайте ответвление проекта.

2. Реализуйте новый tool в вашем разветвленном репозитории.

3. Создайте запрос на извлечение в исходный репозиторий Unity-MCP .