Add empty test level and Unreal MCP tooling

- L_TestFlight: empty, zero-gravity level for Phase 0 flight testing,
  set as editor/game default map.
- Enable UnrealMCPython + Python Editor Script Plugin, third-party
  MCP plugin (GenOrca/unreal-mcp v2.2.0) giving direct editor control
  (actors, blueprints, levels, materials, etc.) alongside Epic's
  built-in Unreal MCP plugin.
- Vendor the mcp-server Python source used to bridge to the plugin.
- .mcp.json intentionally gitignored (machine-specific absolute paths).
This commit is contained in:
Joshua Deville
2026-07-08 14:56:57 -04:00
parent 43494a614b
commit 496320cc8c
82 changed files with 19577 additions and 1 deletions

72
mcp-server/README.md Normal file
View File

@@ -0,0 +1,72 @@
# unreal-mcp-server
unreal-mcp-server is a Python-based server that implements the Model Context Protocol (MCP) for Unreal Engine.
It enables smooth communication between MCP clients (e.g., Claude, Cursor, Windsurf) and the Unreal Editor, and is intended to be used together with the Unreal-MCPython Plugin.
- Demo : [Build 3D Scenes in Unreal Engine with Claude AI | Unreal-MCPython Demo](https://youtu.be/V7KyjzFlBLk?si=sOY1dEVGV2hqi4JC)
- Fab Link : [Unreal-MCPython: AI Assistant Plugin for Unreal Editor using Python & MCP](https://fab.com/s/aed5f75d50b2)
- Github Link : [GenOrca/unreal-mcpython](https://github.com/GenOrca/unreal-mcpython)
## 🎯 Why Choose Unreal-MCPython?
<p align="center">
<img src="https://raw.githubusercontent.com/GenOrca/Screenshot/refs/heads/main/unreal-mcp/Screenshot%202025-06-02%20025106.png" width="400">
<img src="https://raw.githubusercontent.com/GenOrca/Screenshot/refs/heads/main/unreal-mcp/Screenshot%202025-06-02%20025111.png" width="400">
<img src="https://raw.githubusercontent.com/GenOrca/Screenshot/refs/heads/main/unreal-mcp/Screenshot%202025-06-02%20025115.png" width="400">
<img src="https://raw.githubusercontent.com/GenOrca/Screenshot/refs/heads/main/unreal-mcp/Screenshot%202025-06-02%20025120.png" width="400">
</p>
- 🧠 **Unreal AI integration** - Direct Claude AI assistance in Unreal Engine
- 🔗 **Native MCP protocol support** - Seamless communication between AI and UE
- 🎮 **Intelligent game development** - AI-powered asset management and scene manipulation
-**Smart automation** - Context-aware blueprint scripting with AI guidance
- 🎨 **Technical artist focused** - AI assistance for complex production pipelines
## Key Features
- MCP server for communication with Unreal Engine
- 16 namespace dispatcher tools (actor, material, blueprint, animation, asset, …) exposing 191 actions, each callable as `{action, params}`
- Supports Python 3.11 and later
# Installation
Clone the repository:
```bash
git clone https://github.com/your-org/unreal-mcp-server.git
cd unreal-mcp-server
```
# Running the Server
You can start the MCP server with the following command:
```bash
uv --directory absolute/path/to/unreal-mcp-server run src/unreal_mcp/main.py
```
# Example Configuration (Using Claude, VSCode, Cursor)
The following is an example configuration for launching the MCP server from Claude, VSCode, or Cursor:
```json
{
"mcpServers": {
"unreal-mcpython": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/unreal-mcp-server", // e.g., D:/GitHub/unreal-mcp-server
"run",
"src/unreal_mcp/main.py"
]
}
}
}
```
This configuration approach works similarly across editors like VSCode and Cursor.
# License
This project is licensed under the Apache-2.0 License. See the LICENSE file for details.