Py Ue5 MCP Server

🚀 Py-UNREAL-MCP-Server

Py-UNREAL-MCP-Serverは、Pythonで実装されたサービスです。これを使用すると、Unreal Engineとのやり取りが可能になり、Remote Control APIを通じてUnreal Engineシーン内のアクターの作成、変更、削除を行うことができます。

🚀 クイックスタート

このセクションでは、Py-UNREAL-MCP-Serverのインストールと起動方法について説明します。

📦 インストール

以下の手順に従って、Py-UNREAL-MCP-Serverをインストールしてください。

1. 最新版のPy-UNREAL-MCP-Server.zipファイルをダウンロードします。
2. ダウンロードしたファイルを任意の場所に解凍します。
3. 以下のPythonパッケージがインストールされていることを確認します。
   • python-dotenv
   • loguru

💻 使用例

サーバーの起動

サーバーを起動するには、ターミナルで以下のコマンドを実行します。

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

パラメータの説明

• --port：サーバーがリッスンするポートを指定します。デフォルトは8000です。
• --host：サーバーがバインドするホストアドレスを指定します。デフォルトはlocalhostです。

✨ 主な機能

Py-UNREAL-MCP-Serverは、以下の主要な機能をサポートしています。

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に接続しました

トラブルシューティング

接続問題

• Unreal Engineが実行中で、リモートコントロール機能が有効になっていることを確認してください。
• ファイアウォールの設定を確認し、デフォルトのポート30010がブロックされていないことを確認してください。

コマンド実行問題

• 簡単なコマンドからテストして、基本機能を確認してください。
• リクエストの構文が正しいことを確認してください。

将来の開発予定

次のバージョンでは、以下の機能を追加する予定です。

• WebSocketプロトコルを使用したリアルタイムシーンの監視と操作のサポート。
• アクターの属性をより直感的に管理するためのグラフィカルユーザーインターフェイスの提供。