MCP Unreal Server

MCP Unreal Server

リモート Python 実行を介して Unreal Engine インスタンスとやり取りするためのサーバー実装です。

機能

• 🚀 Unreal インスタンス管理

  • マルチキャストによる Unreal ノードの自動検出
  • ノードのステータスをリアルタイムで監視
  • LSP 互換クライアントを介したリソース一覧表示

• 💻 リモート実行

  • Unreal Engine 環境で Python コードを実行
  • 対話実行モードと非対話実行モードの両方をサポート
  • ファイル実行モードとステートメント評価モード

• 📊 ログ記録と監視

  • ファイルへの詳細なログ記録（mcp_unreal.log）
  • 詳細レベルの異なるコンソールログ
  • ノード接続の健全性を監視

インストール

# 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

サポートされているツール

1. Unreal インスタンスに接続

{
  "host": "239.0.0.1",
  "port": 6766
}

2. 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_STATEMENT	Python ステートメントを実行
MODE_EVAL_STATEMENT	Python 式を評価

トラブルシューティング

よくある問題：

• ノードが検出されない：MCP プラグインを使用して Unreal インスタンスが起動していることを確認してください
• 実行がタイムアウトする：マルチキャストトラフィックに対するファイアウォール設定を確認してください
• 接続が切断される：ノードのステータス変化を確認するため、mcp_unreal.log を監視してください

ライセンス

Apache-2.0 ライセンス