MCP アンリアル サーバー
リモート Python 実行を通じて Unreal Engine インスタンスと対話するためのサーバー実装。
特徴
🚀 Unreal インスタンス管理
マルチキャストによるUnrealノードの自動検出
リアルタイムノードステータス監視
LSP 互換クライアントによるリソース一覧
💻リモート実行
Unreal Engine 環境で Python コードを実行する
有人実行モードと無人実行モードの両方をサポート
ファイル実行とステートメント評価モード
📊ログ記録と監視
詳細なログをファイルに記録します (
mcp_unreal.log)異なる詳細レベルでのコンソールログ
ノード接続のヘルスモニタリング
Related MCP server: Unity MCP Integration
インストール
# Clone repository
git clone https://github.com/your-org/mcp-unreal-server.git
cd mcp-unreal-server
# Install dependencies
pip install -r requirements.txt
構成
ネットワーク設定
RemoteExecutionConfigでマルチキャスト パラメータを構成します。
# Default multicast settings (modify in server.py)
config.multicast_group_endpoint = ("239.0.0.1", 6766)
ログ記録
server.pyのログ記録設定を変更します。
# Adjust log levels
file_handler.setLevel(logging.DEBUG) # File logging
console_handler.setLevel(logging.INFO) # Console logging
使用法
サーバーの起動
python -m src.mcp_server_unreal.server
サポートされているツール
Unrealインスタンスに接続する
{
"host": "239.0.0.1",
"port": 6766
}
Pythonコードを実行する
{
"node_id": "<unreal-node-id>",
"code": "print('Hello Unreal')",
"unattended": true
}
APIドキュメント
リソース形式
types.Resource(
uri="unreal://<node_id>",
name=f"Unreal Instance: {node_id}",
description="Unreal Engine instance",
mimeType="application/x-unreal"
)
実行モード
モード | 説明 |
MODE_EXEC_FILE | Pythonファイルを実行する |
MODE_EXEC_ステートメント | Pythonステートメントを実行する |
MODE_EVAL_STATEMENT | Python式を評価する |
トラブルシューティング
よくある問題:
ノードが検出されません: MCP プラグインを使用して Unreal インスタンスが実行されていることを確認します
実行タイムアウト: マルチキャストトラフィックのファイアウォール設定を確認してください
接続が切断された場合: ノードのステータスの変化については
mcp_unreal.log監視します。
ライセンス
Apache 2.0 ライセンス