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許可