unreal-mcp
Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
Unreal MCP is a Model Context Protocol server that enables AI assistants like Claude Desktop, Cursor, and Windsurf to control Unreal Engine through natural language commands. It bridges AI clients with Unreal Engine 5.5+ by combining a C++ plugin that runs inside the Unreal Editor with a Python-based MCP server that communicates over TCP. Developers can use conversational AI to create actors, manage Blueprints, manipulate node graphs, and control the viewport without manual editor interaction. The integration automates game development workflows and makes complex engine operations accessible through simple text prompts.
Key Features
Use Cases
- 01Automate repetitive level design tasks by describing scene layouts in natural language
- 02Rapidly prototype Blueprint classes and component configurations through AI conversation
- 03Query and inspect game objects across large levels without manual searching
- 04Generate Blueprint node graphs for gameplay logic using conversational descriptions
- 05Control viewport navigation and focus during development workflows
- 06Teach game development concepts by having AI demonstrate engine operations in real-time
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
unreal-mcp — FAQ
What is unreal-mcp?+
Unreal MCP is a Model Context Protocol server that lets AI assistants like Claude Desktop, Cursor, and Windsurf control Unreal Engine 5.5+ through natural language. It consists of a C++ plugin that runs in the Unreal Editor and a Python server that connects AI clients to the engine via TCP.
How do I install the unreal-mcp server?+
Copy the UnrealMCP plugin to your Unreal project's Plugins folder, enable it in the editor, and rebuild your project. Then set up the Python server using uv and configure your MCP client's JSON config file to point to the Python server script. Detailed paths and commands are provided for each step.
Which AI clients work with unreal-mcp?+
Unreal MCP works with Claude Desktop, Cursor, and Windsurf. Each client requires placing the MCP configuration JSON in a specific location: Claude Desktop uses ~/.config/claude-desktop/mcp.json, Cursor uses .cursor/mcp.json in your project root, and Windsurf uses ~/.config/windsurf/mcp.json.
What are the prerequisites for using unreal-mcp?+
You need Unreal Engine 5.5 or higher, Python 3.12 or higher, and an MCP-compatible AI client such as Claude Desktop, Cursor, or Windsurf. No API keys are required beyond what your chosen AI client needs.
Is unreal-mcp free to use?+
Yes, unreal-mcp is released under the MIT license and is free to use. However, the project is currently experimental with breaking changes possible, so production use is not recommended.
Can I use unreal-mcp in an existing Unreal project?+
Yes, you can copy the UnrealMCP plugin from the sample project's Plugins folder into your own project's Plugins directory, enable it through the editor's plugin manager, regenerate Visual Studio project files, and rebuild. The plugin integrates with any Unreal Engine 5.5+ project.
How do I install unreal-mcp?+
Open the source repository on GitHub and follow its README. unreal-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is unreal-mcp free?+
unreal-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.