chongdashu/unreal-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Cursor、Windsurf、Claude DesktopなどのAIアシスタントクライアントが、モデルコンテキストプロトコル(MCP)を用いて自然言語を通じてUnreal Engineを制御できるようにします。
概要
このプロジェクトにより、Cursor、Windsurf、Claude DesktopなどのAIアシスタントクライアントが、モデルコンテキストプロトコル(MCP)を用いて自然言語を通じてUnreal Engineを制御できるようになっています。 このプロジェクトは現在、進行中の段階にあります。API、機能、実装の詳細は大幅な変更の可能性があります。テストやフィードバックを推奨しますが、以下の点にご注意ください: - 予告なしに不具合が起こる可能性のある変更 - 機能が不完全または不安定である場合 - ドキュメントが古くなっているか欠落している場合がある - 現時点では本番環境での使用は推奨されません Unreal MCP統合は、自然言語を通じてUnreal Engineを制御するための包括的なツールを提供します: これらの機能はAIアシスタントによる自然言語コマンドでアクセス可能で、Unreal Engineのワークフローの自動化と制御が容易です。 - Blank Projectをベースにしつつ、UnrealMCPプラグインを追加しています。
概要（AI 翻訳）
Unreal-MCP
このプロジェクトにより、Cursor、Windsurf、Claude DesktopなどのAIアシスタントクライアントが、モデルコンテキストプロトコル(MCP)を用いて自然言語を通じてUnreal Engineを制御できるようになっています。
⚠️ 実験的状況
このプロジェクトは現在、実験的状態にあります。API、機能、実装の詳細は大幅な変更の可能性があります。テストとフィードバックを推奨しますが、以下の点にご注意ください:
- 通知なしに発生する可能性のある重大な変更
- 特徴が不完全または不安定である場合があります
- ドキュメントが古くなっているか、欠落している場合があります
- 現時点では生産使用は推奨されません
🌟 概要
Unreal MCP統合は、自然言語を通じてUnreal Engineを制御するための包括的なツールを提供します:
| カテゴリ | 能力 |
|---|---|
| アクター管理・アクター(キューブ、スフィア、ライト、カメラなど)の作成・削除 • アクター変換(位置、回転、スケール)の設定 • アクタープロパティをクエリし、名前でアクターを検索 • 現在のレベルの全アクターをリストアップ | |
| ブループリント開発 | • カスタムコンポーネントで新しいブループリントクラスを作成する • コンポーネント(メッシュ、カメラ、ライトなど)を追加・構成 |
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
This project enables AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
⚠️ Experimental Status
This project is currently in an EXPERIMENTAL state. The API, functionality, and implementation details are subject to significant changes. While we encourage testing and feedback, please be aware that:
- Breaking changes may occur without notice
- Features may be incomplete or unstable
- Documentation may be outdated or missing
- Production use is not recommended at this time
🌟 Overview
The Unreal MCP integration provides comprehensive tools for controlling Unreal Engine through natural language:
| Category | Capabilities |
|---|---|
| Actor Management | • Create and delete actors (cubes, spheres, lights, cameras, etc.)• Set actor transforms (position, rotation, scale)• Query actor properties and find actors by name• List all actors in the current level |
| Blueprint Development | • Create new Blueprint classes with custom components• Add and configure components (mesh, camera, light, etc.)• Set component properties and physics settings• Compile Blueprints and spawn Blueprint actors• Create input mappings for player controls |
| Blueprint Node Graph | • Add event nodes (BeginPlay, Tick, etc.)• Create function call nodes and connect them• Add variables with custom types and default values• Create component and self references• Find and manage nodes in the graph |
| Editor Control | • Focus viewport on specific actors or locations• Control viewport camera orientation and distance |
All these capabilities are accessible through natural language commands via AI assistants, making it easy to automate and control Unreal Engine workflows.
🧩 Components
Sample Project (MCPGameProject) MCPGameProject
- Based off the Blank Project, but with the UnrealMCP plugin added.
Plugin (UnrealMCP) MCPGameProject/Plugins/UnrealMCP
- Native TCP server for MCP communication
- Integrates with Unreal Editor subsystems
- Implements actor manipulation tools
- Handles command execution and response handling
Python MCP Server Python/unreal_mcp_server.py
- Implemented in
unreal_mcp_server.py - Manages TCP socket connections to the C++ plugin (port 55557)
- Handles command serialization and response parsing
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"unrealMCP": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/folder/PYTHON>",
"run",
"unreal_mcp_server.py"
]
}
}
}