UNREAL ENGINE MCP DOCUMENTATION
Master Vibe Coding with our comprehensive UMG and Blueprint MCP tools guide
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.
INSTALLATION & QUICK START
Prerequisites
• Unreal Engine 5.6+
• Python 3.12+
• Git
• MCP Client (VS Code, Claude Desktop, Cursor, Windsurf)
- 1 Clone into Plugins Folder
Clone directly into your Unreal Engine project's Plugins folder:
cd /path/to/your/unreal/project/Plugins git clone https://github.com/kevinpbuckley/VibeUE.git
Example for Windows:
cd C:\MyProject\Plugins
- 2 Enable the Plugin in Unreal Engine
1. Open your Unreal Engine project
2. Go to Edit > Plugins
3. Find "VibeUE" in the Editor category
4. Check the box to enable it
5. Restart the editor when prompted
The plugin will build automatically when enabled.
- 3 Configure MCP Client
VS Code (Recommended)
1. Install the "Model Context Protocol" extension from VS Code marketplace
2. Create or update
.vscode/mcp.json
in your project root:{ "servers": { "VibeUE": { "type": "stdio", "command": "python", "args": ["Plugins\\VibeUE\\Python\\vibe-ue-main\\Python\\vibe_ue_server.py"], "env": {}, "cwd": "${workspaceFolder}" } }, "inputs": [] }
3. Reload VS Code - The MCP server will start automatically
Other MCP Clients
Use this configuration for Claude Desktop, Cursor, or Windsurf:
{ "mcpServers": { "VibeUE": { "command": "python", "args": ["Plugins\\VibeUE\\Python\\vibe-ue-main\\Python\\vibe_ue_server.py"], "cwd": "<path/to/your/unreal/project>" } } }
- 4 Test the Installation
1. Open Unreal Engine with your project
2. Open your MCP client (VS Code, Claude Desktop, etc.)
3. Ask your AI assistant: "Search for widgets in my project"
4. Success! If it returns widget information, VibeUE is working
AVAILABLE TOOLS
VibeUE provides over 69 specialized tools organized into these categories:
🎨 Asset Management
Manage Unreal Engine assets, textures, meshes, and materials
📐 Blueprint Development
Create, compile, and manage Blueprint graphs and nodes
🖼️ UMG Widgets
Build UI components, buttons, lists, and interactive widgets
🎮 Components & Properties
Configure component properties and settings
🔍 Development Utilities
Search, analyze, and debug your project
⚙️ System & Utilities
General system tools and file operations
🎯 Event Management
Handle Blueprint events and input actions
TROUBLESHOOTING
❌ MCP Server Not Starting
Solution: Check that Python 3.12+ is installed and accessible
python --version
# Should show Python 3.12 or higher
❌ Plugin Not Found in Unreal Engine
Solution: Ensure you cloned to the correct Plugins folder
# Structure should be:
YourProject/
Plugins/
VibeUE/
VibeUE.uplugin
❌ Tools Not Responding
Solution: Restart Unreal Engine and reload your MCP client
1. Close Unreal Engine completely
2. Restart Unreal Engine and open your project
3. Reload VS Code or restart your MCP client
4. Wait for the MCP server to initialize
SUPPORT & COMMUNITY
Need help? Connect with the VibeUE community and get support:
💬 Discord Community
Join our Discord for real-time support and discussions:
Buckley603
📚 GitHub Repository
Report issues, contribute, or browse the source code:
github.com/kevinpbuckley/VibeUERemember: VibeUE is experimental software. Please report any issues or unexpected behavior to help improve the project!
Note: VibeUE is pronounced "Vibe U-E" (three syllables: Vibe + U + E)