Unrealengine5 MCP

🚀 Unreal Engine MCP

Unreal Engine 5.6+を自然言語で制御できるMCPツールです。専用のBlueprintワークフローをサポートした大規模プロジェクト向けに設計されています。MCPクライアントを通じてノードグラフの構築、GameplayAbilitiesの作成、エディタータスクの自動化が可能です。Unreal Python APIドキュメントを利用したRAG機能付きPythonスクリプトも含まれています。

🎬 デモ

Homing Cluster Grenade - Lyra grenade + MCPで生成されたBlueprints (GA, スキルシステム)

✨ 主な機能

📐 アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│              Claude Desktop / Cursor (クライアント)                │
│            LLMの推論とツールの呼び出し                   │
└──────────────────────────┬──────────────────────────────────┘
                           │ MCPプロトコル (stdio)
┌──────────────────────────┴──────────────────────────────────┐
│                    Python MCPサーバー                         │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ ツール                                                  │ │
│  │  • editor_tool    - アクター/アセットの操作           │ │
│  │  • blueprint_tool - ブループリント/GASノードグラフ          │ │
│  │  • pcg_tool       - PCGグラフの構築             │ │
│  │  • rag_tool       - API検索とPython実行      │ │
│  └────────────────────────────────────────────────────────┘ │
└──────────────────────────┬──────────────────────────────────┘
                           │ TCP
┌──────────────────────────┴──────────────────────────────────┐
│                 Unreal Engine C++プラグイン                     │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ コマンドハンドラー                                       │ │
│  │  • EditorCommands    - レベルアクターの操作          │ │
│  │  • BlueprintCommands - BPアセットとノードグラフの編集   │ │
│  │  • PCGCommands       - PCGグラフの操作          │ │
│  │  • PythonExecutor    - Pythonスクリプトの実行         │ │
│  └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

RAGシステム (BM25):
  • Unreal Python APIドキュメントの検索を提供
  • エラー回復のためにexecute_unreal_pythonで失敗した場合に使用
  • 外部APIキーは不要

🚀 クイックスタート

必要条件

⚠️ 重要提示

uvパッケージマネージャーが推奨されますが、存在しない場合は自動的にインストールされます。

1. リポジトリのクローン

git clone https://github.com/gimmeDG/UnrealEngine5-mcp.git
cd UnrealEngine5-mcp

2. Unreal Engineプラグインのセットアップ

1. Plugins/UnrealEngineMCPフォルダをあなたのUnrealプロジェクトのPlugins/ディレクトリにコピーします。
2. Unrealエディターでプロジェクトを開きます。
3. プラグインを有効にします：Edit → Plugins → "UnrealEngineMCP"を検索 → 有効にする
4. Unrealエディターを再起動します。

3. MCPクライアントの設定

Claude Desktop

Windows - %APPDATA%\Claude\claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "UnrealEngineMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\unreal-engine-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

macOS - ~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "UnrealEngineMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unreal-engine-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Cursor

Settings → MCP → Add Serverに同じ設定を追加します：

{
  "UnrealEngineMCP": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/unreal-engine-mcp",
      "run",
      "main.py"
    ]
  }
}

4. (オプション) 環境設定

cp .env.example .env
# デフォルト設定を変更する場合は.envを編集します

デフォルトの設定ですぐに使用できます。サーバーは以下のことを自動的に行います：

• 仮想環境を自動的に作成します。
• すべての依存関係をインストールします。
• 初回実行時にBM25インデックスを生成します。

🛠️ 利用可能なツール

エディターツール (21個のツール)

Blueprintツール (47個のツール)

RAGツール (2個のツール)

PCGツール (13個のツール) - 初期段階

⚠️ 重要提示

PCGツールは機能していますが、まだ改良中です。

📄 ライセンス

MIT License

💬 フィードバック

バグを見つけたり、提案がある場合は、issueを開いてください。