8000 GitHub - db-lyon/ue-mcp: Complete Unreal Engine development toolkit exposed as MCP tools. · GitHub
[go: up one dir, main page]

Skip to content
db-lyonPublic

About

Complete Unreal Engine development toolkit exposed as MCP tools.

Topics

Resources

Security policy

Stars

478 stars

Watchers

3 watching

Forks

Repository files navigation

UE-MCP

npm version npm downloads CI MIT Discord

Let an AI agent work inside your Unreal Editor. Ask in plain English, and it builds levels, Blueprints, materials, VFX, landscapes and more in your open project.

ue-mcp: Epic's 830 native actions plus 1,333 of its own, and dialog handling, retries and rollback, guardrails, spatial control, workflow automation, plugins, multi-editor control and auto-reported tool gaps

UE-MCP is a free, open-source Model Context Protocol server for Unreal Engine 5. It connects AI assistants like Claude, Cursor and Codex to the editor through 2163+ actions, including Epic's native Unreal 5.8 tools.

"Place a point light 300 units above the player start, warm white, intensity 5000."
"Create a pulsing emissive material and apply it to every cube in the level."
"Build the project in Development and tell me about any compile errors."

Two ways to use it

1. UE-MCP Studio: a chat agent in the editor

studio-showcase.mp4

Studio is a free desktop client with the agent built in. Dock it in the editor or run it in its own window. Sign in with your Claude or ChatGPT account, or use an API key. Every turn is checkpointed so you can review and revert changes, and shell commands and file edits wait for your approval.

Download the editor plugin from its latest release, unzip it into your project's Plugins folder, and open Studio from the toolbar. Studio sets up everything else. Windows, UE 5.7 and 5.8.

2. Bring your own AI client

Already using Claude Code, Claude Desktop, Cursor or Codex? From your project folder:

npx ue-mcp init

The wizard installs the bridge plugin into your project and configures your AI client. Open the editor (the bridge compiles on first launch), then ask your AI to run project(action="get_status") to confirm it is connected.

Full walkthrough: Getting Started.

What can it do?

7B40

Almost anything you do by hand in the editor: levels and actors, Blueprints, materials, assets and imports, animation and Control Rig, Niagara, landscape, foliage, PCG, audio, UMG, gameplay systems, GAS, StateTree, networking, Sequencer, builds and PIE.

Beyond single actions, it can chain steps into reusable flows with rollback, handle editor dialogs, drive several editors at once, and be extended with ue-mcp plugins.

To see it build a full scene from nothing, run the built-in Neon Shrine demo.

FAQ

What is "MCP"?

Model Context Protocol is an open standard that lets AI assistants call external tools. UE-MCP is the tool server that gives them the Unreal Editor.

Does it cost anything?

No. UE-MCP and Studio are MIT-licensed and free for personal and commercial use. You pay only for your AI model, through your existing plan or API key.

Which Unreal versions and platforms?

UE 5.4 to 5.8 on Windows, 5.6+ on macOS and Linux. Studio is Windows-only for now, on UE 5.7 and 5.8. You also need Node.js 20+ and a C++ toolchain, since the bridge plugin compiles in your project.

Is it safe to let an AI edit my project?

Write guards can block or require confirmation for changes, source-controlled assets can be protected, and flows roll back on failure. Studio adds per-turn checkpoints and approval prompts. Use source control regardless.

Does it work without the editor open?

Partly. Config, C++ headers and asset listings can be read with the editor closed. Anything that changes the project needs the editor running.

How is this different from Epic's built-in AI tools?

UE-MCP wraps Epic's native UE 5.8 tools and adds over a thousand of its own, plus flows, guards and plugins. See the comparison against Epic and other Unreal MCP servers.

It won't connect / something isn't working.

Run npx ue-mcp doctor, check out the Troubleshooting Guide, or come give me a shout in the official ue-mcp discord!!!

Learn more

Contributing

Issues and pull requests are welcome. Start with Development. Install git-lfs before cloning, because the test project stores assets through LFS.

If UE-MCP helps your work, sponsorship is appreciated.

License

MIT. Contributions are accepted under the same license.

About

Complete Unreal Engine development toolkit exposed as MCP tools.

Topics

Resources

Security policy

Stars

478 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages

0