Unreal Engine MCP Server for Claude Desktop

基本能力

产品定位

Unreal Engine MCP Server 是一个用于连接 Claude Desktop 和 Unreal Engine 5.3 的中间件，旨在通过自然语言实现 3D 场景的创建和修改。

核心功能

1. 基本对象创建：通过文本提示创建基本形状（如立方体、球体、圆柱体等），并自定义位置、旋转、缩放、颜色和材质。
2. 蓝图 Actor 创建：从蓝图类生成建筑物、道具、角色等，并支持自定义参数。
3. 场景操作：修改现有对象的位置、旋转、缩放、颜色和材质，以及切换可见性。
4. 资产发现：搜索和列出项目中的可用资产，支持按类型、路径或关键词过滤。

适用场景

1. 游戏开发：快速构建和修改 3D 场景，提高开发效率。
2. 原型设计：通过自然语言快速生成 3D 原型。
3. 教育：用于教学和演示 3D 建模和游戏开发的基本概念。

工具列表

1. unreal_mcp_server.py：主入口点，注册 MCP 工具。
2. unreal_connection.py：处理与 Unreal Engine 的通信。
3. unreal_actors.py：创建和操作 Actor 的功能。
4. unreal_assets.py：处理资产和关卡信息的功能。
5. unreal_utils.py：实用函数和常量。

常见问题解答

1. 连接问题：确保 Unreal Engine 正在运行，Remote Control API 插件已启用，端口 30010 未被占用，防火墙未阻止连接。
2. 对象未出现：检查 Unreal Engine 的输出日志，确保对象未在远离原点 (0,0,0) 的位置创建，简化请求以隔离问题。
3. 日志：服务器将详细信息记录到控制台，检查日志以获取错误消息和跟踪信息。

使用教程

使用依赖

1. Python 3.10+
2. Unreal Engine 5.3 并启用 Remote Control API 插件
3. Claude Desktop (Windows)

安装教程

1. 克隆仓库并安装所需包：

git clone https://github.com/runeape-sats/unreal-mcp.git
cd unreal-mcp
pip install uv mcp requests

1. 配置 Claude Desktop：
2. 打开 Claude Desktop → 文件 → 设置 → 开发者 → 编辑配置 claude_desktop_config.json，添加以下内容（调整路径为本地仓库路径）：

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": ["--directory", "\\path\\to\\unreal-mcp", "run", "unreal_mcp_server.py"],
      "env": {}
    }
  }
}

1. 启动 Unreal Engine 并确保 Remote Control API 插件已启用。
2. 重启 Claude Desktop 以加载新配置。

调试方式

1. 运行服务器开发模式：

pip install mcp[cli]
mcp dev unreal_mcp_server.py

1. 检查控制台日志以获取详细信息和错误消息。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。