Publisher-documented clients
Claude DesktopCursorWindsurf
These names appear in the publisher's installation documentation. MCP100-verified configurations are shown separately above when available.
🚀 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.
- Prepare the project
- Right-click your .uproject file
- Generate Visual Studio project files
- 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:
-
Copy the plugin to your project
- Copy
MCPGameProject/Plugins/UnrealMCP to your project's Plugins folder
-
Enable the plugin
- Edit > Plugins
- Find "UnrealMCP" in Editor category
- Enable the plugin
- Restart editor when prompted
-
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 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.
{
"mcpServers": {
"unrealMCP": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/folder/PYTHON>",
"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 | .cursor/mcp.json | Located in your project root directory |
| Windsurf | ~/.config/windsurf/mcp.json | On Windows: %USERPROFILE%\.config\windsurf\mcp.json |
Each client uses the same JSON format as shown in the example above.
Simply place the configuration in the appropriate location for your MCP client.