Union

Union подключает ИИ-агентов к редактору Unity и проектам через сервер Model Context Protocol (MCP). Наделите свой ИИ мультимодальным зрением, мощным поиском и точным анализом кода для оптимизации разработки игр.

Разработка игр Инструменты разработчика Data Science и ML ★ 25 GitHub (25 ★)

Union — это сервер Model Context Protocol (MCP), специально разработанный для Unity, выступающий в роли моста, позволяющего AI-агентам напрямую взаимодействовать с редактором Unity. Он наделяет AI-модели такими возможностями, как мультимодальное зрение для наблюдения за сценой и ассетами, выполнение расширенного поиска по иерархии проекта и использование компилятора Unity для точного анализа кода. Сервер поддерживает широкий набор инструментов для управления ассетами, манипуляции сценой, создания и выполнения скриптов, а также проверки состояния редактора, что делает задачи разработки Unity автоматизируемыми и доступными для AI-агентов.

Ключевые особенности

01Мультимодальное зрение для агентов, позволяющее просматривать сцены, камеры и ассеты Unity.

0225 звезд на GitHub

03Превосходный анализ кода с использованием собственного компилятора Unity.

04Расширяемая архитектура для добавления инструментов под конкретный проект.

05Мощный поиск по иерархии и ассетам проекта.

06Быстрая настройка с помощью одного файла mcp.json.

Варианты использования

01Предоставление AI-моделям возможности программно анализировать, изменять и тестировать проекты Unity.

02Автоматизация рабочих процессов разработки Unity с помощью AI-агентов.

03Содействие созданию контента и генерации сценариев на основе AI в редакторе Unity.

Union ♾️ - The Unity MCP Server

A Model Context Protocol server for Unity

Key Features

🖼️ Multimodal Vision: Your agent can see what you see. It can view the scene, look through any camera, watch play mode, and inspect asset thumbnails.
🔎 Powerful Search: Go beyond the project panel with simultaneous search across the hierarchy and project assets.
✔️ Superior Code Analysis: Leverage Unity's own compiler for code analysis that is more accurate than your agent's linter.
⏩ Quick Start: Get running in seconds with a single mcp.json configuration file.
🛠️ Extensible: Add your own project-specific tools with minimal boilerplate.
📅 Always Current: Kept up-to-date with the latest MCP protocol version — currently 2025-06-18 via the Official MCP C# SDK.

Compatibility

Name	Compatible	Notes
Models
GPT-4.1	✅
Claude 4 Sonnet	✅
Claude 4 Opus	✅
Gemini 2.5 Pro	✅
Gemini 2.5 Flash	✅
o3	✅	No image understanding
o4-mini	✅
Unity Versions
Unity 6000.0.x	✅	Higher versions should be fine. Lower versions may work but untested.
Agents
Cursor	✅
Rider AI	✅
Claude Desktop	✅
Claude Code	✅	Terminal requires Screen & System Audio Recording permissions on Mac
Operating Systems
Windows	✅
Mac	✅
Ubuntu	❔	Untested

Setup

1. Install node.js

2. Configure `mcp.json`

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

This will automatically install the is.nurture.mcp package in your unity project. Feel free to commit those changes to source control.

About the Tools

Meet your Unity AI toolbox.

Tool	Description
Assets
`get_asset_contents`	Get the full contents of an asset or sub-asset.
`copy_asset`	Copy an asset to a new path.
`import_asset`	Import an asset from the filesystem into Unity.
`get_asset_importer`	Get the importer settings for an asset.
Prefabs
`open_prefab`	Open a Unity prefab in isolation mode so that it can be edited.
Scenes
`open_scene`	Open a scene
`close_scene`	Close an open scene
`save_scene`	Save the current scene. If the scene is not dirty, this will do nothing.
`get_game_object`	Get the details of a game object in a loaded scene or prefab by its hierarchy path.
`test_active_scene`	Test the active scene by entering play mode and running for a given number of seconds.
Scripting
`create_script`	Create or replace a C# code file at the given path. This also checks to make sure the script compiles.
`execute_code`	Execute code inside the Unity editor.
`get_type_info`	Get public fields and methods on a Unity fully qualified type name, including the assembly.
Search
`search`	Search project assets and scene objects.
Editor State
`get_state`	Get the state of the Unity Editor.
`get_selection`	Get the objects the user has currently selected in the editor.
Vision
`focus_game_object`	Focus on a game object in the scene view.
`screenshot`	Retrieve a preview of what is focused in the scene view.

Known Issues

The Google External Dependency Manager (EDMU) causes Unity to hang forever on startup when launched via Cursor on Windows. This is under investigation.
The test_active_scene tool sometimes fails with the error message Maximum call stack size exceeded.
The search tool occasionally fails with the error message Search index is not ready yet. Please try again later.

Adding Project-Specific Tools

Union uses the official C# MCP SDK.

Create a static class to hold your tools. Add the [McpServerToolType] annotation to the class.
Declare static methods to implement each tool. Add the [McpServerTool] annotation to each method.
Reference the Services directory for examples.
You will likely need to quit unity and restart your agent in order for it to see the new tools.

Usage Tips

Here are some tips to get the most out of Union:

🚀 Launch through your agent: Always launch Unity through your AI agent's MCP integration. Launching Unity from the Hub will prevent the MCP server from connecting.
📂 Per-project setup: If your agent supports it, configure the MCP server in your per-project settings. This allows you to seamlessly switch between Unity projects.

⚙️ Command-line arguments: You can pass additional arguments to Unity for advanced scenarios like running in -batchmode or -nographics for CI/CD pipelines. Add a -- separator before the Unity-specific arguments:

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

⚠️ Important: Do not use the -logFile command-line argument. The MCP server relies on Unity's standard output for communication.
🖥️ Split screen for vision: For tools like screenshot, ensure the Unity editor is visible on your screen otherwise it will end up screenshotting the foreground window.

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

Union — это сервер протокола контекста модели (MCP) для Unity, позволяющий AI-агентам (например, Claude, GPT, Gemini) напрямую взаимодействовать с редактором Unity: просматривать сцену, выполнять код, искать ассеты и многое другое.

Возможности

Мультимодальное зрение — агент видит то же, что и вы: сцену, камеры, режим play, превью ассетов.
Мощный поиск — одновременный поиск по иерархии и проекту.
Точный анализ кода — использует собственный компилятор Unity, а не внешний линтер.
Быстрый старт — запуск за секунды с одним конфигурационным файлом mcp.json.
Расширяемость — добавляйте свои инструменты с минимальным шаблонным кодом.
Всегда актуален — поддерживает последнюю версию протокола MCP (2025-06-18) через официальный C# SDK.

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

Модели	Совместимость	Примечания
GPT-4.1	✅
Claude 4 Sonnet / Opus	✅
Gemini 2.5 Pro / Flash	✅
o3	✅	Не понимает изображения
o4-mini	✅

Версии Unity	Совместимость	Примечания
Unity 6000.0.x	✅	Более новые версии должны работать; старые — не тестировались

Агенты	Совместимость	Примечания
Cursor	✅
Rider AI	✅
Claude Desktop	✅
Claude Code	✅	На Mac требуется разрешение на запись экрана и звука

ОС	Совместимость
Windows	✅
Mac	✅
Ubuntu	❔ (не тестировалось)

Установка

Установите Node.js, если ещё не установлен.
Настройте mcp.json для вашего AI-агента (см. ниже).

Настройка mcp.json

Пример конфигурации для запуска Union:

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": [
        "-y",
        "@nurture-tech/unity-mcp-runner",
        "-unityPath", "<путь к редактору Unity>",
        "-projectPath", "<путь к проекту Unity>"
      ]
    }
  }
}

При первом запуске пакет is.nurture.mcp будет автоматически установлен в ваш проект. Рекомендуется закоммитить эти изменения в систему контроля версий.

Важно: Запускайте Unity только через AI-агента. Запуск из Unity Hub приведёт к тому, что MCP-сервер не подключится.

Инструменты

Union предоставляет набор инструментов, разделённых по категориям:

Ассеты

get_asset_contents — получить полное содержимое ассета.
copy_asset — скопировать ассет.
import_asset — импортировать ассет из файловой системы.
get_asset_importer — получить настройки импортёра.

Префабы

open_prefab — открыть префаб в режиме изоляции.

Сцены

open_scene / close_scene / save_scene — открытие, закрытие, сохранение сцены.
get_game_object — получить детали объекта по пути в иерархии.
test_active_scene — запустить play mode на заданное количество секунд.

Скриптинг

create_script — создать или заменить C#-файл с проверкой компиляции.
execute_code — выполнить произвольный код в редакторе.
get_type_info — получить поля и методы типа по полному квалифицированному имени.

Поиск

search — искать по ассетам проекта и объектам сцены.

Состояние редактора

get_state — получить состояние редактора.
get_selection — получить выбранные объекты.

Зрение

focus_game_object — сфокусироваться на объекте в сцене.
screenshot — получить скриншот области, на которой фокус в Scene View.

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

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 использует официальный MCP C# SDK. Чтобы добавить свой инструмент:

Создайте статический класс с атрибутом [McpServerToolType].
Добавьте статические методы с атрибутом [McpServerTool].
Примеры можно найти в директории Services.
После добавления может потребоваться перезапустить Unity и агента, чтобы новые инструменты стали доступны.

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

Всегда запускайте Unity через агента — иначе MCP-сервер не подключится.
Настройка для каждого проекта — если агент поддерживает, настройте MCP-сервер в per-project settings, чтобы легко переключаться между проектами.
Дополнительные аргументы Unity — можно передать аргументы командной строки, например -batchmode и -nographics для CI/CD. Используйте -- перед аргументами Unity:

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": [
        "-y",
        "@nurture-tech/unity-mcp-runner",
        "-unityPath", "<путь к Unity>",
        "-projectPath", ".",
        "--",
        "-batchmode",
        "-nographics"
      ]
    }
  }
}

Не используйте -logFile — MCP-сервер полагается на стандартный вывод Unity.
Для работы с инструментом screenshot убедитесь, что окно редактора Unity видно на экране, иначе скриншот сделается с активного окна.

Union — проект с открытым исходным кодом. Подробнее на GitHub.

Что такое Union и какова его основная цель?

Union — это сервер Model Context Protocol (MCP), специально разработанный для Unity. Он позволяет AI-агентам беспрепятственно взаимодействовать с редактором Unity и его проектами, устраняя разрыв между ИИ и процессами разработки игр.

Легко ли настроить и кастомизировать Union?

Да, Union предлагает быстрый старт с простым конфигурационным файлом mcp.json. Его архитектура является расширяемой, что позволяет разработчикам легко добавлять собственные инструменты для конкретных проектов с минимальным шаблонным кодом с помощью C# MCP SDK.

Каковы требования совместимости Union?

Union совместим с Unity 6000.0.x и выше, поддерживает основные модели ИИ, такие как GPT-4.1, Claude 4 и Gemini 2.5, а также агенты Cursor и Rider AI, работающие на Windows и Mac.

Какие задачи может выполнять AI-агент в Unity с помощью Union?

AI-агенты могут выполнять широкий спектр задач: открывать/сохранять сцены, управлять ассетами и префабами, создавать и выполнять C# скрипты, получать детали объектов, тестировать сцены, делать скриншоты и выполнять расширенный поиск в среде Unity.

Как Union расширяет возможности AI-агентов в Unity?

Union наделяет AI-агентов мультимодальным зрением для 'видения' сцен Unity, камер и ассетов, мощным поиском по иерархии и ассетам проекта, а также превосходным анализом кода с использованием собственного компилятора Unity для получения высокоточных данных.

Источник: https://mcpmarket.com/server/union-1