ponents
• 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 - Provides error handling and connection management - Loads and registers tool modules from the `tools` directory - Uses the FastMCP library to implement the Model Context Protocol ## 📂 Directory Structure - **MCPGameProject/** - Example Unreal project - **Plugins/UnrealMCP/** - C++ plugin source - **Source/UnrealMCP/** - Plugin source code - **UnrealMCP.uplugin** - Plugin definition - **Python/** - Python server and tools - **tools/** - Tool modules for actor, editor, and blueprint operations - **scripts/** - Example scripts and demos - **Docs/** - Comprehensive documentation - See [Docs/README.md](Docs/README.md) for documentation index ## 🚀 Quick Start Guide ### Prerequisites - Unreal Engine 5.5+ - Python 3.12+ - MCP Client (e.g., Claude Desktop, Cursor, Windsurf) ### Sample project For getting started quickly, feel free to use the starter project in `MCPGameProject`. This is a UE 5.5 Blank Starter Project with the `UnrealMCP.uplugin` already configured. 1. **Prepare the project** - Right-click your .uproject file - Generate Visual Studio project files 2. **Build the project (including the plugin)** - Open solution (`.sln`) - Choose `Development Editor` as your target. - Build ### Plugin Otherwise, if you want to use the plugin in your existing project: 1. **Copy the plugin to your project** - Copy `MCPGameProject/Plugins/UnrealMCP` to your project's Plugins folder 2. **Enable the plugin** - Edit > Plugins - Find "UnrealMCP" in Editor category - Enable the plugin - Restart editor when prompted 3. **Build the plugin** - Right-click your .uproject file - Generate Visual Studio project files - Open solution (`.sln) - Build with your target platform and output settings ### Python Server Setup See [Python/README.md](Python/README.md) for detailed Python setup instructions, including: - Setting up your Python environment - Running the MCP server - Using direct or server-based connections ### Configuring your MCP Client Use the following JSON for your mcp configuration based on your MCP client. ```json { "mcpServers": { "unrealMCP": { "command": "uv", "args": [ "--directory", "", "run", "unreal_mcp_server.py" ] } } } ``` An example is found in `mcp.json` ### MCP Configuration Locations Depending on which MCP client you're using, the configuration file location will differ: | MCP Client | Configuration File Location | Notes | |------------|------------------------------|-------| | Claude Desktop | `~/.config/claude-desktop/mcp.json` | On Windows: `%USERPROFILE%\.config\claude-desktop\mcp.json` | | Cursor | `.

Model Context Protocol for Unreal Engine

Tools