VibeUE

MCP Server for Unreal Engine

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. 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. 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. 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. 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/VibeUE

Remember: 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)