Py Ue5 MCP Server

該項目是一個連接Claude AI與Unreal Engine 5的Python服務器，通過自然語言指令實現對UE5場景中3D對象和藍圖演員的創建、修改與控制。

開發者工具遊戲與遊戲化 #UE5集成 #自然語言控制 #藍圖交互 #場景管理 .Python

評分 : 2.5分

下載量 : 7.6K

更新時間 : 2025-04-28

打開站點

什麼是Unreal Engine 5 MCP Server?

Unreal Engine 5 MCP Server通過自然語言處理技術，使您能夠通過對話方式控制和創建3D對象及藍圖演員。它利用Remote Control API在Unreal Engine 5中實現這一功能。

如何使用Unreal Engine 5 MCP Server?

首先啟動Unreal Engine和您的項目，然後啟動Claude Desktop並開始與之互動。通過簡單的自然語言描述，您可以快速構建和修改場景。

適用場景

適用於需要快速原型設計、複雜場景構建以及即時視覺反饋的開發者。

主要功能

自然語言控制

通過簡單的文字指令來創建和操作3D對象。

藍圖演員交互

訪問並操作藍圖中的函數。

場景管理

構建、修改和排列場景。

資產發現

搜索和利用項目中的資源。

即時反饋

即時查看Unreal Engine視口中的變化。

優勢

通過自然語言簡化複雜任務。

支持即時場景編輯。

高度集成Unreal Engine的功能。

侷限性

需要安裝特定版本的Python和Unreal Engine。

可能不支持所有自定義Blueprint功能。

如何使用

設置環境

克隆倉庫並安裝依賴項。

配置Claude Desktop

編輯Claude桌面配置文件以添加MCP服務器。

啟動Unreal Engine

確保Remote Control API插件已啟用。

使用案例

創建雪人家庭

使用自然語言描述，一次性創建多個雪人。

調整雪人大小

改變雪人的尺寸。

常見問題

如何解決連接問題？

為什麼某些命令無法執行？

🚀 Py-UNREAL-MCP-Server

Py-UNREAL-MCP-Server 是一個用於與虛幻引擎（Unreal Engine）進行交互的 Python 服務。它藉助遠程控制 API 協議，可對 Unreal Engine 場景中的演員進行創建、修改和刪除操作，為開發者提供便捷的場景管理能力。

🚀 快速開始

本部分將引導你完成 Py-UNREAL-MCP-Server 的安裝與啟動。

📦 安裝指南

下載最新版本的 Py-UNREAL-MCP-Server.zip 文件。
將下載的文件解壓到任意位置。
確保安裝以下 Python 包：
- python-dotenv
- loguru

💻 使用示例

基礎用法

在終端中運行以下命令啟動服務器：

python main.py [--port PORT] [--host HOST]

參數說明

--port：指定服務器監聽的端口，默認為 8000。
--host：指定服務器綁定的主機地址，默認為 localhost。

✨ 主要特性

1. 演員創建

基本演員創建：在當前層級中創建一個指定類別的演員。
演員複製：通過 Blueprint 函數對現有演員進行復制。
家庭模式創建：一次性生成一組排列整齊的“雪人一家”。

2. 演員修改

支持對任意屬性進行調整，包括位置、旋轉角度和縮放比例。
允許重命名演員或選擇性地僅更新特定屬性。

🔧 技術細節

日誌記錄與調試

服務運行期間會生成詳細日誌，便於排查問題：

2023-11-15 14:32:45,123 - Unreal-MCP-Server - INFO - Unreal Engine MCP服務器啟動中...
2023-11-15 14:32:45,125 - Unreal-MCP-Server - INFO - 默認度量單位：釐米（1 Unreal Unit = 1 cm）
2023-11-15 14:32:45,234 - Unreal-MCP-Server - INFO - 已連接到Unreal Engine遠程控制API