Unreal Engine MCP Server For Claude Desktop

🚀 クラウドデスクトップ用Unreal Engine MCPサーバー

このリポジトリには、Claude Desktopがテキストプロンプトを通じてUnreal Engine 5.3（リモートコントロールAPI経由）とやり取りし、3Dオブジェクトを作成および操作できるようにするMCP Pythonサーバーが含まれています。この統合により、Claudeは自然言語を使ってUnreal Engine内で3Dシーンを構築および修正でき、文字からゲームを生成する技術への第一歩を表しています。

🚀 クイックスタート

1. 必要条件

• Python 3.10以上
• リモートコントロールAPIプラグインが有効になっているUnreal Engine 5.3
• Windows版Claude Desktop

2. インストール

リポジトリをクローンし、必要なパッケージをインストールします。

git clone https://github.com/runeape-sats/unreal-mcp.git
cd unreal-mcp
pip install uv mcp requests

3. Claude Desktopの設定

Claude Desktop → ファイル → 設定 → 開発者 → 設定ファイル claude_desktop_config.json を編集し、以下の内容を追加し、必要に応じてローカルリポジトリのパスを調整します。

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "uv",
      "args": ["--directory", "\\path\\to\\unreal-mcp", "run unreal_mcp_server.py"],
      "env": {}
    }
  }
}

4. Unreal Engineの起動

Unreal Engineを起動し、リモートコントロールAPIプラグインが有効になっていることを確認します。

5. Claude Desktopの起動

以下のコマンドを実行してMCPサーバーを起動します。

mcp run unreal_mcp_server.py

📁 プロジェクト構造

• unreal_mcp_server.py：Claudeとのインターフェース。
• commands/：立方体の作成やオブジェクトの移動など、さまざまな機能コマンドを定義します。

✨ 主な機能

基本操作

1. ジオメトリの作成：

   • create_cube() を使用して立方体を作成します。
   • create_sphere() を使用して球体を作成します。
   • create_cylinder() を使用して円柱体を作成します。

2. 変換操作：

   • set_position(x, y, z) を使用してオブジェクトの位置を設定します。
   • set_rotation(x, y, z) を使用してオブジェクトの回転角度を設定します。
   • set_scale(x, y, z) を使用してオブジェクトのスケールを調整します。

3. オブジェクトの削除：

   • delete_object() を使用して指定されたオブジェクトを削除します。

高度な機能

• バッチ操作：移動や回転など、複数のオブジェクトに対して同時に同じ操作を実行することができます。
• シーンの保存/読み込み：現在のシーンを保存し、以前に保存したシーンを再読み込みすることができます。
• マテリアルの変更：オブジェクトのマテリアル属性（色、テクスチャなど）を調整することができます。

💻 使用例

基本ジオメトリの作成

# 赤色の立方体を作成
cube = create_cube()
set_color(cube, (1, 0, 0))

# 青色の球体を作成
sphere = create_sphere()
set_color(sphere, (0, 0, 1))

変換操作の例

# 立方体を指定された位置に移動
set_position(cube, (5, 0, 0))

# Y軸を中心に90度回転
set_rotation(cube, (0, 90, 0))

# スケールを調整
set_scale(cube, (2, 1, 1))

🛠️ トラブルシューティング

接続問題

• Unreal EngineとClaude Desktopが両方とも起動しており、ネットワーク接続が正常であることを確認してください。
• ファイアウォールの設定を確認し、ポートがブロックされていないことを確認してください。

オブジェクトが表示されない場合

• Unreal Engineのログファイルを確認してエラー情報を取得してください。
• オブジェクトの作成位置が合理的な範囲内にあり、原点(0,0,0)から過度に離れていないことを確認してください。
• 問題を切り分けるために、リクエストを簡素化してみてください。

🛠️ 開発

開発モードでサーバーを実行するには、次のコマンドを実行します。

pip install mcp[cli]
mcp dev unreal_mcp_server.py

🤝 コントリビューション

コントリビューションを歓迎します！これはClaudeとUnreal Engineの統合プロジェクトであり、改善の余地がたくさんあります。

• シーンの説明をよりよく理解するために、自然言語処理能力を向上させる。
• より複雑なオブジェクト作成機能を追加する。
• より多くのUnreal Engineの機能をサポートする。
• エラー処理とフィードバックメカニズムを改善する。

📄 ライセンス

MITライセンス