Unity

Интегрируйте ИИ бесшовно с Unity с помощью UnityMCP! Мониторинг редактора в реальном времени, удаленное выполнение кода и всестороннее логирование для эффективной разработки игр.

Избранные Инструменты разработчика Разработка API Разработка игр GitHub

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

Ключевые возможности

01Мониторинг состояния редактора Unity в реальном времени

02Удаленное выполнение C# кода в Unity

03Комплексные возможности логирования редактора Unity

04Связь на основе WebSocket для обновлений в реальном времени

05MCP-сервер предоставляет стандартизированные инструменты для взаимодействия с редактором Unity

060 звезд на GitHub

Сценарии использования

01Интеграция ИИ-ассистентов для интеллектуального управления сценами

02Удаленное управление и мониторинг проектов Unity

03Автоматизация задач редактора Unity с помощью ИИ

UnityMCP

UnityMCP is a powerful Unity Editor plugin that implements the Model Context Protocol (MCP), enabling seamless integration between Unity and AI assistants. It provides real-time editor state monitoring, remote command execution, and comprehensive logging capabilities.

Architecture

The project consists of two main components:

1. Unity Plugin (UnityMCPPlugin)

A Unity Editor plugin that provides:

Debug window for connection status and monitoring
WebSocket client for real-time communication
C# code execution engine
Comprehensive logging system
Editor state tracking and serialization

2. MCP Server (unity-mcp-server)

A TypeScript-based MCP server that exposes Unity Editor functionality through standardized tools:

Available Tools

get_editor_state
- Retrieves current Unity Editor state
- Includes active GameObjects, selection state, play mode status
- Provides scene hierarchy and project structure
- Supports different output formats (Raw, scripts only, no scripts)
execute_editor_command
- Executes C# code directly in the Unity Editor
- Full access to UnityEngine and UnityEditor APIs
- Real-time execution with comprehensive error handling
- Command timeout protection
get_logs
- Retrieves and filters Unity Editor logs
- Supports filtering by type, content, and timestamp
- Customizable output fields
- Buffer management for optimal performance

Installation

Installing via Smithery

To install UnityMCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Arodoid/unitymcp --client claude

Prerequisites

Unity 2022.3 or later
Node.js 18 or later
npm 9 or later

Unity Plugin Setup

Copy the UnityMCPPlugin folder to your Unity project's Assets directory
Open Unity Editor
Access the plugin through Unity's top menu bar > UnityMCP > Debug Window

MCP Server Setup

cd unity-mcp-server
npm install
npm run build

Usage

Starting the Server

cd unity-mcp-server
node build/index.js

Connecting from Unity

Open your Unity project
Open the UnityMCP Debug Window (Window > UnityMCP > Debug Window)
The plugin will automatically attempt to connect to the MCP server
Monitor connection status and logs in the debug window

Example: Executing Commands

// Center the selected object
Selection.activeGameObject.transform.position = Vector3.zero;

// Toggle play mode
EditorApplication.isPlaying = !EditorApplication.isPlaying;

// Create a new cube
GameObject.CreatePrimitive(PrimitiveType.Cube);

Development

Building the Server

cd unity-mcp-server
npm run build

Watching for Changes

npm run watch

Inspecting MCP Communication

npm run inspector

Technical Details

Communication Protocol

WebSocket-based communication on port 8080
Bidirectional real-time updates
JSON message format for all communications
Automatic reconnection handling

Security Features

Command execution timeout protection
Error handling and validation
Log buffer management
Connection state monitoring

Error Handling

The system provides comprehensive error handling for:

Connection issues
Command execution failures
Compilation errors
Runtime exceptions
Timeout scenarios

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

UnityMCP

UnityMCP — это плагин для редактора Unity, реализующий протокол Model Context Protocol (MCP). Он позволяет ИИ-ассистентам (например, Claude) напрямую взаимодействовать с Unity: отслеживать состояние редактора в реальном времени, выполнять C#-команды и получать логи. Репозиторий проекта: UnityMCP на GitHub.

Проект состоит из двух частей:

Unity Plugin (UnityMCPPlugin) — подключается к вашему Unity-проекту, предоставляет отладочное окно, веб-сокет-клиент, движок выполнения C# и систему логирования.
MCP Server (unity-mcp-server) — TypeScript-сервер, который через стандартные MCP-инструменты открывает доступ к функциям редактора.

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

Предварительные требования

Unity 2022.3 или новее
Node.js 18+
npm 9+

Установка плагина Unity

Скопируйте папку UnityMCPPlugin в Assets/ вашего Unity-проекта.
Откройте проект в Unity.
В верхнем меню выберите UnityMCP > Debug Window, чтобы открыть отладочное окно.

Установка MCP-сервера

cd unity-mcp-server
npm install
npm run build

Запуск

cd unity-mcp-server
node build/index.js

После запуска сервера откройте Unity и перейдите в UnityMCP > Debug Window — плагин автоматически подключится к серверу.

Автоматическая установка через Smithery (для Claude Desktop)

npx -y @smithery/cli install @Arodoid/unitymcp --client claude

Доступные инструменты MCP

get_editor_state — получает текущее состояние редактора (активные GameObject, выделенные объекты, режим Play, иерархию сцены, структуру проекта). Поддерживает форматы: Raw, только скрипты, без скриптов.
execute_editor_command — выполняет C#-код прямо в редакторе. Полный доступ к UnityEngine и UnityEditor. Есть защита от зависаний (timeout).
get_logs — получает и фильтрует логи редактора по типу, содержимому и времени. Настраиваемые поля вывода и управление буфером.

Примеры команд

// Центрировать камеру на выделенном объекте
Selection.activeGameObject.transform.position = Vector3.zero;

// Переключить режим Play
EditorApplication.isPlaying = !EditorApplication.isPlaying;

// Создать куб
GameObject.CreatePrimitive(PrimitiveType.Cube);

Разработка и отладка

Сборка сервера: npm run build (в папке unity-mcp-server)
Автоматическая пересборка при изменениях: npm run watch
Инспектирование MCP-трафика: npm run inspector

Технические детали

Протокол: WebSocket на порту 8080, двусторонняя связь, JSON-сообщения, автоматическое переподключение.
Безопасность: таймауты команд, валидация ошибок, управление буфером логов, мониторинг соединения.
Обработка ошибок: система обрабатывает проблемы соединения, ошибки выполнения команд, ошибки компиляции, исключения времени выполнения и таймауты.

Внесение вклада

Форкните репозиторий.
Создайте ветку: git checkout -b feature/amazing-feature.
Закоммитьте изменения: git commit -m 'Add amazing feature'.
Отправьте в свой форк: git push origin feature/amazing-feature.
Откройте Pull Request.

Лицензия

Проект распространяется по лицензии CC BY-NC 4.0.

Ссылки

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

Ключевые возможности

Сценарии использования

UnityMCP

Architecture

1. Unity Plugin (UnityMCPPlugin)

2. MCP Server (unity-mcp-server)

Available Tools

Installation

Installing via Smithery

Prerequisites

Unity Plugin Setup

MCP Server Setup

Usage

Starting the Server

Connecting from Unity

Example: Executing Commands

Development

Building the Server

Watching for Changes

Inspecting MCP Communication

Technical Details

Communication Protocol

Security Features

Error Handling

Contributing

License

UnityMCP

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

Предварительные требования

Установка плагина Unity

Установка MCP-сервера

Запуск

Автоматическая установка через Smithery (для Claude Desktop)

Доступные инструменты MCP

Примеры команд

Разработка и отладка

Технические детали

Внесение вклада

Лицензия

Ссылки

Какие необходимы предварительные условия для использования UnityMCP?

Что такое UnityMCP?

Каковы ключевые возможности UnityMCP?

Какие команды можно выполнять удаленно?

Как установить UnityMCP?

Комментарии