Unreal MCP

🚀 unreal - mcp

Unreal Engine用のMCPサーバーで、Unreal Python Remote Executionを利用しています。

Twitter · Discord

🚀 クイックスタート

このREADMEでは、Unreal Engine用のMCPサーバーであるunreal - mcpについて説明します。以下の各セクションで、このサーバーの特徴、インストール方法、利用可能なツールなどを紹介します。

✨ 主な機能

⚡ 差分

このサーバーは、組み込みのPythonリモート実行プロトコルを使用するため、新しいUEプラグインのインストールを必要としません。

新しいツールや機能を追加する際に、C++コードを必要としないため、開発がはるかに高速です。

完全なUnreal Engine Python APIをサポートしています。

⚠️ 重要な注意事項

⚠️ 重要提示

• これは公式のUnreal Engineプロジェクトではありません。
• あなたのAIエージェントやツールは、エディターに完全にアクセスできます。
• クライアントが提案する変更を承認する前に、必ず確認してください。

📦 インストール

📋 必要条件

• 🔧 Unreal Engine 5.4以上 (検証済み、以前のバージョンでも動作する可能性があります)
• 🟢 npx付きのNode.js
• 🤖 MCPクライアント (Claude、Cursorなど)

1. エディターの設定:
   • Unreal Engineプロジェクトを開きます。
   • Edit -> Pluginsに移動します。
   • "Python Editor Script Plugin"を検索し、有効にします。
   • 必要に応じてエディターを再起動します。
   • Edit -> Project Settingsに移動します。
   • "Python"を検索し、"Enable Remote Execution"オプションを有効にします。

2. クライアントの設定:
   • Claude (またはCursor)の設定を編集します。

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "@runreal/unreal-mcp"
      ]
    }
  }
}

🔧 トラブルシューティング

MCP Unreal: Unexpected token 'C', Connection... のようなエラーが表示された場合は、mcp - serverがUnreal Editorに接続できなかったことを意味します。

• Python Editor Script Pluginが有効になっていること、およびプロジェクト設定でRemote Executionオプションがチェックされていることを確認してください。
• バインドアドレスを 127.0.0.1 から 0.0.0.0 に変更してみてください。ただし、これによりローカルネットワークからの接続が許可されます。
• Unreal Editorを完全に再起動してください。
• クライアント (Claude、Cursorなど)を完全に閉じて開き、MCPサーバーに再接続することを確認してください (Windowsでは File -> Exit)。
• 実行中のプロセスを確認し、ゾンビのunreal - mcp Node.jsプロセスを殺してください。

🛠️ 利用可能なツール

🤝 コントリビューション

問題やプルリクエストを自由に開いてください。特に新しいツールやコマンドに関するコントリビューションは大歓迎です。

📄 ライセンス

License MIT