Unreal Engine MCP Server For Claude Desktop

🚀 用于Claude桌面的Unreal Engine MCP服务器

本项目包含一个MCP Python服务器，它能让Claude Desktop通过文本提示与Unreal Engine 5.3（借助远程控制API）进行交互，从而创建和操作3D对象。这种集成使得Claude能够运用自然语言在Unreal Engine里构建并修改3D场景，是迈向文字到游戏生成技术的重要一步。

🚀 快速开始

1. 需求

• Python 3.10+
• 启用远程控制API插件的Unreal Engine 5.3
• Windows版Claude Desktop

2. 📦 安装指南

克隆仓库并安装所需的包：

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

3. 配置Claude Desktop

转到Claude Desktop → 文件 → 设置 → 开发者 → 编辑配置 claude_desktop_config.json，并添加以下内容，可根据需要调整本地仓库路径：

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

4. 启动Unreal Engine

启动Unreal Engine并确保远程控制API插件已启用。

5. 启动Claude Desktop

运行以下命令以启动MCP服务器：

mcp run unreal_mcp_server.py

🏗️ 项目结构

• unreal_mcp_server.py：与Claude的交互接口。
• commands/：定义各种功能命令，如创建几何体、移动对象等。

✨ 主要特性

基本操作

1. 创建几何体：

   • 使用create_cube()创建一个立方体。
   • 使用create_sphere()创建一个球体。
   • 使用create_cylinder()创建一个圆柱体。

2. 变换操作：

   • 使用set_position(x, y, z)设置对象位置。
   • 使用set_rotation(x, y, z)设置对象旋转角度。
   • 使用set_scale(x, y, z)调整对象缩放比例。

3. 删除对象：

   • 使用delete_object()删除指定对象。

进阶功能

• 批量操作：支持同时对多个对象执行相同操作，如移动、旋转等。
• 场景保存/加载：允许保存当前场景并重新加载之前保存的场景。
• 材质修改：可调整对象的材质属性，如颜色、纹理等。

💻 使用示例

基础用法

# 创建一个红色立方体
cube = create_cube()
set_color(cube, (1, 0, 0))

# 创建一个蓝色球体
sphere = create_sphere()
set_color(sphere, (0, 0, 1))

高级用法

# 将立方体移动到指定位置
set_position(cube, (5, 0, 0))

# 绕Y轴旋转90度
set_rotation(cube, (0, 90, 0))

# 调整缩放比例
set_scale(cube, (2, 1, 1))

📚 详细文档

故障排除

连接问题

• 确保Unreal Engine和Claude Desktop均已启动且网络连接正常。
• 检查防火墙设置，确保端口未被阻止。

对象未显示

• 检查Unreal Engine的日志文件以获取错误信息。
• 确保对象创建位置在合理范围内，避免过于远离原点(0,0,0)。
• 尝试简化请求以隔离问题。

开发

要在开发模式下运行服务器：

pip install mcp[cli]
mcp dev unreal_mcp_server.py

贡献

欢迎贡献！这是一个Claude与Unreal Engine的集成项目，还有很多可以改进的地方：

• 提高自然语言处理能力以更好地理解场景描述。
• 增加更多复杂的对象创建功能。
• 支持更多的Unreal Engine特性。
• 改进错误处理和反馈机制。

📄 许可证

MIT许可