Unrealmcpbridge

🚀 虚幻引擎 MCP Python 桥接插件

このプラグインは、虚幻エンジン（UE）用のもので、Model Context Protocol (MCP) のサーバーサイドを実装しています。このプラグインにより、Anthropic の Claude のような MCP クライアントが、完全な UE Python API にアクセスできるようになります。

🚀 クイックスタート

このプラグインは、UE での Python 開発を強化し、Claude などの AI エージェントとの連携を可能にします。以下に、使用シナリオ、インストール方法、開発のヒントを紹介します。

✨ 主な機能

• Python でのツールやワークフローの開発を、Claude のようなエージェントで自動化できます。
• ワークフローのスマートで動的な自動化を実現します。
• エージェントとの共同開発をサポートします。

📦 インストール

前提条件

• Visual Studio 2019 以上（コードからビルドする場合）
• AI エージェント（ここでは Claude を想定していますが、MCP を実装したエージェントであれば使用可能です）
• Python エディタースクリプトプラグインを有効にした虚幻エンジン 5
• 虚幻エンジン Python API を確認してください。

Fab からのインストール

最も簡単な方法は、Fab ストアページ から MCP Python ブリッジプラグインをインストールすることです。購入後、プラグインは Epic Games ランチャーのライブラリに表示されます。「虚幻エンジンにインストール」をクリックし、指示に従ってインストールを完了してください。

GitHub からのインストール

Fab を通じてインストールできない場合は、GitHub からソースコードをダウンロードし、手動でビルドすることができます。

1. GitHub リポジトリ にアクセスします。
2. リポジトリをローカル開発環境にクローンします。
3. Visual Studio 2019 以上を開き、プロジェクトフォルダ内の .uproject ファイルを開きます。
4. 「ビルド」をクリックして、プラグインを生成します。

💻 使用例

基本的な使用法

新しいツールやプロンプトを unreal_mcp_client.py に追加するには、既存のパターンに従ってください。例えば、以下はクライアントで create_castle() という新しいプロンプトを定義する方法です。

@mcp.prompt()
def create_castle() -> str:
    """创建一座城堡"""
    return f"""
请在当前虚幻引擎项目中创建一座城堡。
0. 参考虚幻引擎 Python API 以查找创建新代码的文档：https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/?application_version=5.5
1. 清理场景中的所有 StaticMeshActors。
2. 获取项目目录和内容目录。
3. 找到构建结构的基本形状。
4. 使用这些基本形状创建一座城堡。
"""

unreal_mcp_client.py を変更するたびに、Claude を再起動して変更を反映させる必要があります。Windows では、タスクマネージャーを使用して Claude プロセスを終了し、完全に再起動する必要がある場合があります。

以上の手順に従えば、新しいツールやプロンプトを MCP Python ブリッジプラグインに簡単に統合し、Claude との対話能力を拡張することができます。