启用 Cursor、Windsurf 和 Claude Desktop 等 AI 助手客户端，通过模型上下文协议（MCP）通过自然语言控制虚幻引擎。
概览
该项目使 Cursor、Windsurf 和 Claude Desktop 等 AI 助手客户端能够通过自然语言使用模型上下文协议（MCP）控制虚幻引擎。 该项目目前处于一个状态。API、功能和实现细节可能会有重大变化。虽然我们鼓励测试和反馈，但请注意： - 可能发生无预警的破坏性变更 - 功能可能不完整或不稳定 - 文档可能过时或缺失 - 目前不建议使用生产环境 虚幻MCP集成提供了通过自然语言控制虚幻引擎的全面工具： 所有这些功能都可以通过AI助手的自然语言命令实现，使得自动化和控制虚幻引擎工作流程变得轻松。 - 基于 Blank 项目，但添加了 UnrealMCP 插件。
概述（AI 翻译）
虚幻-MCP
该项目使 Cursor、Windsurf 和 Claude Desktop 等 AI 助手客户端能够通过自然语言使用模型上下文协议（MCP）控制虚幻引擎。
⚠️ 实验状态
该项目目前处于实验阶段。API、功能和实现细节可能会有重大变更。虽然我们鼓励测试和反馈，但请注意：
- 可能发生无预警的变更
- 特征可能不完整或不稳定
- 文档可能过时或缺失
- 目前不建议生产使用。
🌟 概述
虚幻MCP集成提供了通过自然语言控制虚幻引擎的全面工具：
| 类别 | 能力 |
|---|---|
| 演员管理 | • 创建和删除角色（立方体、球体、灯光、摄像机等） • 设置角色变换（位置、旋转、缩放） • 查询演员属性并按名称查找演员 • 列出当前关卡中的所有角色 |
| 蓝图开发 | • 创建新的蓝图类，包含自定义组件 • 添加和配置组件（网格、相机、光源等）。 |
本页由 AI 翻译，技术细节请以原文为准。
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 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"unrealMCP": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/folder/PYTHON>",
"run",
"unreal_mcp_server.py"
]
}
}
}