GameDev MCP Plugin

Enable AI agents to work inside Unreal Editor through MCP.

Build Unreal Editor workflows with Codex, Claude Code, Cursor, and other MCP-compatible clients.

Unreal Engine • MCP • AI agents • UMG • Blueprint • Animation Blueprint • Niagara • Landscape • Materials • World workflows

✨ Overview

Most AI tools stop at code.
GameDev MCP Plugin is built to help AI agents work with actual Unreal Editor workflows through an embedded MCP server and Unreal-side tooling.

This project is especially useful if you want to:

• connect Codex, Claude Code, Cursor, or other MCP clients to Unreal Editor
• inspect and edit Unreal assets with AI agents
• build AI-assisted workflows for UMG, Blueprint, Animation Blueprint, Niagara, materials, and world authoring
• reduce the gap between prompting an agent and making changes inside Unreal Editor

🔥 Features

• Asset query and lifecycle workflows
• UMG inspection and editing workflows
• Blueprint authoring and graph workflows, including comment box and reroute (K2Node_Knot) nodes
• Animation Blueprint and animation workflows
• Niagara and material workflows, including reroute and named reroute graph coverage
• Representative validation now covers Blueprint, UMG, animation asset, material, Niagara, and world workflows on UE 5.7 / Win64
• Settings and object inspection workflows
• Landscape, foliage, and world authoring workflows
• Embedded MCP server and Unreal Editor bridge tooling

For a comprehensive domain-by-domain support summary, including Live Coding, animation, Control Rig, Sequencer, Data Tables, and world authoring, see CAPABILITY_MATRIX.md.

🚀 Quick Start

Watch the install video

Prefer a video walkthrough first? Watch the install guide on YouTube before following the steps below.

1. Install the plugin

1. Download the latest release ZIP from the Releases page.
2. Extract the package.
3. Copy GameDevMCPPlugin/ into your Unreal project:
   • <YourProject>/Plugins/GameDevMCPPlugin
4. Open your project in Unreal Editor.
5. Confirm the plugin is loaded and that this file exists:
   • <YourProject>/Saved/UnrealMCP/connection.json

2. Register the bundled MCP server

The plugin package includes the MCP server inside:

• <YourProject>/Plugins/GameDevMCPPlugin/mcp_server

The easiest way to get started is to ask your AI client to register the bundled mcp_server from this plugin and connect it to your running Unreal Editor.

Recommended prompt

Register the bundled mcp_server from this plugin as an MCP server and connect it to my running Unreal Editor.

Most MCP-capable clients can use the bundled launcher as a standard stdio MCP server.

If you keep one global ue-mcp entry and switch between multiple Unreal projects, use the bundled workspace-aware launchers instead of hardcoding one project path. See CLIENT_SETUP.md for examples.

If your client does not support MCP setup by prompt, see CLIENT_SETUP.md for manual setup examples.

3. Ask your AI agent to connect to Unreal

After the MCP server is registered, ask your agent to connect to the current Unreal Editor session.

Example prompts

Connect to my current Unreal Editor through MCP.
List the available tools from ue-mcp.

After that, you can ask for higher-level tasks such as:

Create a UMG widget blueprint for a pause menu.
Inspect this Animation Blueprint and summarize its state machine.
Add trees and grass to the currently open level.

4. If setup by prompt does not work

Some clients require manual MCP configuration instead of natural-language setup.

See CLIENT_SETUP.md for client-specific examples and Codex tips.

🎬 Demo Videos

Blueprint authoring demo

See a Blueprint creation workflow in action with GameDev MCP Plugin and an AI agent.

🤖 Clients

• Codex CLI
• Claude Code
• Cursor
• VS Code MCP-compatible clients
• other MCP-capable agent clients

Client-specific setup examples live in CLIENT_SETUP.md.

🧩 Use Cases

• create or inspect assets
• edit UMG widget trees
• build or patch Blueprints
• work with Animation Blueprints and animation assets
• inspect or modify Niagara and materials
• adjust editor settings and object properties
• author or automate world and landscape workflows

📦 Download

Download the latest package from the Releases page.

Always verify the included SHA256 checksum before installation.

🧰 Included

This repository includes:

• binary plugin release packages
• embedded MCP server files inside the plugin package
• release notes
• installation guidance
• client setup examples
• capability matrix
• known issues

The full Unreal plugin source repository is not included in this public repository.

🔌 Included MCP Server

The package includes the embedded MCP server inside the plugin folder.

• Server root:
  • <YourProject>/Plugins/GameDevMCPPlugin/mcp_server
• Fixed-project launchers:
  • <YourProject>/Plugins/GameDevMCPPlugin/run_mcp_server.cmd
  • <YourProject>/Plugins/GameDevMCPPlugin/run_mcp_server.ps1
  • <YourProject>/Plugins/GameDevMCPPlugin/run_mcp_server.sh
• Workspace-aware launchers:
  • <YourProject>/Plugins/GameDevMCPPlugin/run_mcp_server_from_cwd.cmd
  • <YourProject>/Plugins/GameDevMCPPlugin/run_mcp_server_from_cwd.ps1
  • <YourProject>/Plugins/GameDevMCPPlugin/mcp_server/scripts/run_mcp_server_from_cwd.sh

🖥️ Supported Setup

• Unreal Engine 5.7
• Windows Win64
• Local Unreal Editor workflow validation

🐞 Feedback

Feedback is welcome for:

• installation experience
• editor stability
• workflow clarity
• missing authoring flows
• documentation gaps

When reporting issues, include:

• Unreal Engine version
• OS and platform
• exact release tag
• reproduction steps
• relevant logs or screenshots

⚠️ Known Issues

For current limitations, compatibility notes, and workflow caveats, see KNOWN_ISSUES.md.

⭐ Star This Project

If this is useful for your Unreal workflow, a star helps more developers find the project.