Unreal MCP

Unreal MCP 使 Cursor、Windsurf 和 Claude Desktop 等 AI 助手客户端能够使用 Model Context Protocol (MCP) 通过自然语言控制虚幻引擎（Unreal Engine）。

核心功能

• Actor管理：创建/删除Actor、设置变换、查询属性、列出场景中的Actor
• Blueprint开发：创建带有自定义组件的Blueprint类、编译Blueprint、生成Blueprint Actor、创建输入映射
• Blueprint节点图：添加事件节点、创建函数调用节点、添加变量、创建组件和自身引用、管理图中的节点
• 编辑器控制：将视口聚焦到Actor/位置、控制视口相机方向和距离
• 状态说明：项目处于实验性阶段，功能持续迭代中

适用场景

• 自动化Unreal Engine项目搭建
• AI辅助游戏开发和关卡设计
• 虚幻引擎中的程序化内容生成
• AI驱动的快速原型制作
• 自动化编辑器脚本编写
• 游戏开发团队AI工作流增强

安装方式

前置要求：Unreal Engine 5.x、Python、uv

git clone https://github.com/chongdashu/unreal-mcp.git
cd unreal-mcp

MCP 客户端配置：

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": ["--directory", "/path/to/the/folder/PYTHON", "run", "unreal_mcp_server.py"]
    }
  }
}

在虚幻编辑器中启用Python插件并运行服务器脚本即可连接。

许可证：MIT License