chongdashu/unreal-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Разрешите клиентам AI-помощника, таким как Cursor, Windsurf и Claude Desktop, управлять Unreal Engine на естественном языке с помощью протокола Model Context Protocol (MCP).
Обзор
Этот проект позволяет клиентам AI-помощников, таким как Cursor, Windsurf и Claude Desktop, управлять Unreal Engine с помощью естественного языка с использованием протокола Model Context Protocol (MCP). Проект в настоящее время находится в состоянии. API, функциональность и детали реализации подвержены значительным изменениям. Хотя мы поощряем тестирование и обратную связь, пожалуйста, имейте в виду: - Неисправные изменения могут произойти без предупреждения - Функции могут быть неполными или нестабильными - Документация может быть устаревшей или отсутствовать - В настоящее время производственное использование не рекомендуется Интеграция Unreal MCP предоставляет комплексные инструменты для управления Unreal Engine с помощью естественного языка: Все эти возможности доступны через команды на естественном языке через AI-ассистентов, что облегчает автоматизацию и управление рабочими процессами Unreal Engine. - Основано на Blank Project, но с добавлением плагина UnrealMCP.
Обзор (машинный перевод)
Unreal-MCP
Этот проект позволяет клиентам AI-помощников, таким как Cursor, Windsurf и Claude Desktop, управлять Unreal Engine с помощью естественного языка с использованием протокола Model Context Protocol (MCP).
⚠️ Экспериментальный статус
В настоящее время проект находится в состоянии ЭКСПЕРИМЕНТАЛЬНЫЙ. API, функциональность и детали реализации подвергаются значительным изменениям. Хотя мы поощряем тестирование и обратную связь, пожалуйста, обратите внимание, что:
- Нарушения могут произойти без предупреждения
- Признаки могут быть неполными или нестабильными
- Документация может быть устаревшей или отсутствовать
- Производственное использование в настоящее время не рекомендуется
🌟 Обзор
Интеграция Unreal MCP предоставляет комплексные инструменты для управления Unreal Engine с помощью естественного языка:
| Категория | Возможности |
|---|---|
| Управление актёрами | • Создание и удаление актёров (кубы, сферы, свет, камеры и т.д.) • Настройка преобразования акторов (позиция, вращение, масштаб) • Запрос свойств акторов и поиск актёров по имени • Список всех актёров текущего уровня |
| Разработка чертежа | • Создание новых классов Blueprint с пользовательскими компонентами • Добавление и настройка компонентов (mesh, camera, light и т.д.). |
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
This project enables AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
⚠️ Experimental Status
This project is currently in an EXPERIMENTAL state. The API, functionality, and implementation details are subject to significant changes. While we encourage testing and feedback, please be aware that:
- Breaking changes may occur without notice
- Features may be incomplete or unstable
- Documentation may be outdated or missing
- Production use is not recommended at this time
🌟 Overview
The Unreal MCP integration provides comprehensive tools for controlling Unreal Engine through natural language:
| Category | Capabilities |
|---|---|
| Actor Management | • Create and delete actors (cubes, spheres, lights, cameras, etc.)• Set actor transforms (position, rotation, scale)• Query actor properties and find actors by name• List all actors in the current level |
| Blueprint Development | • Create new Blueprint classes with custom components• Add and configure components (mesh, camera, light, etc.)• Set component properties and physics settings• Compile Blueprints and spawn Blueprint actors• Create input mappings for player controls |
| Blueprint Node Graph | • Add event nodes (BeginPlay, Tick, etc.)• Create function call nodes and connect them• Add variables with custom types and default values• Create component and self references• Find and manage nodes in the graph |
| Editor Control | • Focus viewport on specific actors or locations• Control viewport camera orientation and distance |
All these capabilities are accessible through natural language commands via AI assistants, making it easy to automate and control Unreal Engine workflows.
🧩 Components
Sample Project (MCPGameProject) MCPGameProject
- Based off the Blank Project, but with the UnrealMCP plugin added.
Plugin (UnrealMCP) MCPGameProject/Plugins/UnrealMCP
- Native TCP server for MCP communication
- Integrates with Unreal Editor subsystems
- Implements actor manipulation tools
- Handles command execution and response handling
Python MCP Server Python/unreal_mcp_server.py
- Implemented in
unreal_mcp_server.py - Manages TCP socket connections to the C++ plugin (port 55557)
- Handles command serialization and response parsing
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"unrealMCP": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/folder/PYTHON>",
"run",
"unreal_mcp_server.py"
]
}
}
}