MCP Unreal Server

by radial-hks
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Facilitates executing Python code remotely within Unreal Engine instances, supporting multiple execution modes including file execution and statement evaluation.

  • Enables remote Python code execution in Unreal Engine environments, supporting both attended and unattended execution modes, file execution, and statement evaluation through an automatic node discovery system.

MCP アンリアル サーバー

リモート 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 }
  1. 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_FILEPythonファイルを実行する
MODE_EXEC_ステートメントPythonステートメントを実行する
MODE_EVAL_STATEMENTPython式を評価する

トラブルシューティング

よくある問題:

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

ライセンス

Apache 2.0 ライセンス

-
security - not tested
F
license - not found
-
quality - not tested

Unreal Engine 環境でのリモート Python コード実行を可能にするサーバー実装。マルチキャスト ネットワークを介した自動 Unreal ノード検出および管理機能を備えています。

  1. Features
    1. Installation
      1. Configuration
        1. Network Settings
        2. Logging
      2. Usage
        1. Starting the Server
        2. Supported Tools
      3. API Documentation
        1. Resource Format
        2. Execution Modes
      4. Troubleshooting
        1. License
          ID: xptd5hcrir