Server facts
Unreal Engine Generative AI Support Plugin MCP Server
Project
- Author
- prajwalshettydev
- Website
- muddyterrain.com/docs/
- License
- MIT
- Category
- Games & 3D
Tech
- Runtime / language
- c++C++
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 676
- Last commit
- Data as of
Tags
- Blueprints
- Game Development
- Generative Ai
- Scene Control
- Unreal Engine
Overview
Unreal Engine Generative AI Support Plugin brings model integrations and assistant-driven editor actions into an Unreal project. The free repository includes chat integrations for OpenAI, Anthropic, XAI, and DeepSeek, with structured output support for OpenAI. Its MCP bridge lets Claude Desktop, Claude Code, or Cursor interact with the editor. This is aimed at game developers who want both API-based AI features and an assistant able to change their development scene.
The documented MCP capabilities include spawning objects, changing their position and scale, adjusting materials, creating Blueprint types, and adding functions or variables. Python execution and console commands are also available. The feature-status list is important: Blueprint node wiring is described as buggy, while advanced scene work, widget generation, and other capabilities remain unfinished. The README explicitly says the free plugin's MCP support is not under active development. Paid plugins are presented separately, so their broader model lists should not be treated as free-repository functionality.
Setup uses a Python bridge with FastMCP and requires Unreal's Python Editor Script Plugin. The plugin can be added as a Git submodule, then enabled in the editor. MCP control itself does not require an Anthropic API key for testing through the Claude app; direct model API use has separate key requirements. Because the bridge can directly modify the project, the README recommends a controlled environment, backups, and version control before enabling it.
Install & configure
Requirements
- Unreal Engine project with the GenerativeAISupport plugin enabled
- Python with FastMCP installed
- Unreal Python Editor Script Plugin enabled
- A supported MCP client
python /Plugins/GenerativeAISupport/Content/Python/mcp_server.pyReplace the example bridge path with its location in your project. The README documents pip install fastmcp and adding the plugin as a Git submodule. Exact MCP tool identifiers are not stated in the supplied README.
Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Use Settings → Developer → Edit Config when available. Do not assume a Linux configuration path; check the client documentation for your platform. Remote servers use the app’s connector flow when supported, not the local stdio file shown here. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"UnrealGenAISupport": {
"command": "python",
"args": [
"/Plugins/GenerativeAISupport/Content/Python/mcp_server.py"
],
"env": {
"UNREAL_HOST": "<Unreal editor host, shown as localhost>",
"UNREAL_PORT": "<Unreal editor connection port, shown as 9877>"
}
}
}
}Config file · Project: .cursor/mcp.json
User: ~/.cursor/mcp.json
The project path is relative to the workspace root. The tilde denotes your user home directory. Use Cursor’s MCP settings to confirm which configuration and scope your installed version is reading. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"UnrealGenAISupport": {
"command": "python",
"args": [
"/Plugins/GenerativeAISupport/Content/Python/mcp_server.py"
],
"env": {
"UNREAL_HOST": "<Unreal editor host, shown as localhost>",
"UNREAL_PORT": "<Unreal editor connection port, shown as 9877>"
}
}
}
}Config file · Workspace: .vscode/mcp.json
For user scope, use the “MCP: Open User Configuration” command if available. Do not guess a user configuration path across operating systems, profiles, containers, or remote workspaces; check the client documentation. Merge this example with existing settings; do not overwrite unrelated servers.
{
"servers": {
"UnrealGenAISupport": {
"type": "stdio",
"command": "python",
"args": [
"/Plugins/GenerativeAISupport/Content/Python/mcp_server.py"
],
"env": {
"UNREAL_HOST": "<Unreal editor host, shown as localhost>",
"UNREAL_PORT": "<Unreal editor connection port, shown as 9877>"
}
}
}
}Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Open the MCP configuration through Windsurf’s settings when possible to confirm the active file. Paths can differ in managed or future releases; check the client documentation if this location is not present. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"UnrealGenAISupport": {
"command": "python",
"args": [
"/Plugins/GenerativeAISupport/Content/Python/mcp_server.py"
],
"env": {
"UNREAL_HOST": "<Unreal editor host, shown as localhost>",
"UNREAL_PORT": "<Unreal editor connection port, shown as 9877>"
}
}
}
}Config file · Project scope: .mcp.json at the repository root
The project file uses mcpServers. For user scope, use claude mcp add --scope user rather than assuming .mcp.json in your home directory is the user configuration. Check the client documentation for managed settings and storage details. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"UnrealGenAISupport": {
"type": "stdio",
"command": "python",
"args": [
"/Plugins/GenerativeAISupport/Content/Python/mcp_server.py"
],
"env": {
"UNREAL_HOST": "<Unreal editor host, shown as localhost>",
"UNREAL_PORT": "<Unreal editor connection port, shown as 9877>"
}
}
}
}Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Use cases
- Let an assistant spawn and transform objects in an Unreal scene.
- Create Blueprint types and add functions or variables.
- Run Python scripts or console commands through an assistant.
- Integrate supported chat APIs into Unreal gameplay experiments.
Strengths
- Combines Unreal editor control with model API integration.
- Supports Claude Desktop, Claude Code, and Cursor.
- The free plugin is MIT-licensed.
Limitations
- MCP support in the free plugin is not actively developed.
- Several advertised feature areas are unfinished or buggy.
- Direct project control requires careful backups and isolation.
Unreal Engine Generative AI Support Plugin setup notes
- Check UNREAL_HOST, UNREAL_PORT in the Unreal Engine Generative AI Support Plugin configuration if startup or authentication fails.
- Unreal Engine Generative AI Support Plugin's stdio example needs a client that launches local processes.