[!IMPORTANT] Union устарел. Используйте официальный MCP-сервер Unity.

Union ♾️ — MCP-сервер для Unity

Сервер протокола контекста модели (MCP) для Unity

Основные возможности

• 🖼️ Мультимодальное зрение: Ваш агент может видеть то же, что и вы. Он может просматривать сцену, смотреть через любую камеру, наблюдать за режимом игры и изучать миниатюры ассетов.

• 🔎 Мощный поиск: Выйдите за рамки панели проекта с помощью одновременного поиска по иерархии и ассетам проекта.

• ✔️ Превосходный анализ кода: Используйте собственный компилятор Unity для анализа кода, который точнее, чем линтер вашего агента.

• ⏩ Быстрый старт: Начните работу за секунды с помощью одного файла конфигурации mcp.json.

• 🛠️ Расширяемость: Добавляйте свои собственные инструменты для конкретного проекта с минимальным количеством шаблонного кода.

• 📅 Всегда актуально: Поддерживается в актуальном состоянии с последней версией протокола MCP — в настоящее время 2025-06-18 через официальный C# SDK для MCP.

Related MCP server: Unity MCP Server

Совместимость

Установка

1. Установите node.js

2. Настройте mcp.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@nurture-tech/unity-mcp-runner", "-unityPath", "<path to unity editor>", "-projectPath", "<path to unity project>"]
    }
  }
}

Это автоматически установит пакет is.nurture.mcp в ваш проект Unity. Вы можете смело фиксировать эти изменения в системе контроля версий.

Об инструментах

Познакомьтесь с вашим набором инструментов Unity AI.

Известные проблемы

• Google External Dependency Manager (EDMU) вызывает зависание Unity при запуске через Cursor на Windows. Это изучается.

• Инструмент test_active_scene иногда завершается с ошибкой Maximum call stack size exceeded.

• Инструмент search иногда завершается с ошибкой Search index is not ready yet. Please try again later.

Добавление инструментов для конкретного проекта

Union использует официальный C# MCP SDK.

1. Создайте статический класс для хранения ваших инструментов. Добавьте аннотацию [McpServerToolType] к классу.

2. Объявите статические методы для реализации каждого инструмента. Добавьте аннотацию [McpServerTool] к каждому методу.

3. Обратитесь к каталогу Services для примеров.

4. Скорее всего, вам потребуется закрыть Unity и перезапустить агента, чтобы он увидел новые инструменты.

Советы по использованию

Вот несколько советов, как получить максимум от Union:

• 🚀 Запуск через агента: Всегда запускайте Unity через интеграцию MCP вашего ИИ-агента. Запуск Unity из Hub предотвратит подключение MCP-сервера.

• 📂 Настройка для каждого проекта: Если ваш агент поддерживает это, настройте MCP-сервер в настройках для каждого проекта. Это позволит вам легко переключаться между проектами Unity.

• ⚙️ Аргументы командной строки: Вы можете передавать дополнительные аргументы в Unity для продвинутых сценариев, таких как запуск в режиме -batchmode или -nographics для CI/CD конвейеров. Добавьте разделитель -- перед аргументами, специфичными для Unity:

  {
    "mcpServers": {
      "unity": {
        "command": "npx",
        "args": [
          "-y",
          "@nurture-tech/unity-mcp-runner"
          "-unityPath",
          "<path to unity editor>",
          "-projectPath",
          ".",
          "--",
          "-batchmode",
          "-nographics"
        ]
      }
    }
  }

• ⚠️ Важно: Не используйте аргумент командной строки -logFile. MCP-сервер полагается на стандартный вывод Unity для связи.

• 🖥️ Разделение экрана для зрения: Для таких инструментов, как screenshot, убедитесь, что редактор Unity виден на вашем экране, иначе он сделает скриншот окна, находящегося на переднем плане.