Unreal Engine MCP Server

Name: Unreal Engine MCP Server
Author: ChiR24

ChiR24

Get started Repository

Lets AI assistants control Unreal Engine through a native C++ Automation Bridge plugin.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add unreal-engine --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' --env UE_HOST='<UE_HOST>' --env UE_RC_HTTP_PORT='<UE_RC_HTTP_PORT>' --env UE_RC_WS_PORT='<UE_RC_WS_PORT>' --env MCP_AUTOMATION_PORT='<MCP_AUTOMATION_PORT>' -- npx -y unreal-engine-mcp-server

~/.codex/config.toml

[mcp_servers.unreal-engine]
command = "npx"
args = ["-y", "unreal-engine-mcp-server"]
env = { UE_PROJECT_PATH = "<UE_PROJECT_PATH>", MCP_AUTOMATION_CAPABILITY_TOKEN = "<MCP_AUTOMATION_CAPABILITY_TOKEN>", UE_HOST = "<UE_HOST>", UE_RC_HTTP_PORT = "<UE_RC_HTTP_PORT>", UE_RC_WS_PORT = "<UE_RC_WS_PORT>", MCP_AUTOMATION_PORT = "<MCP_AUTOMATION_PORT>" }

# codex mcp add unreal-engine --env UE_PROJECT_PATH='<UE_PROJECT_PATH>' --env MCP_AUTOMATION_CAPABILITY_TOKEN='<MCP_AUTOMATION_CAPABILITY_TOKEN>' --env UE_HOST='<UE_HOST>' --env UE_RC_HTTP_PORT='<UE_RC_HTTP_PORT>' --env UE_RC_WS_PORT='<UE_RC_WS_PORT>' --env MCP_AUTOMATION_PORT='<MCP_AUTOMATION_PORT>' -- npx -y unreal-engine-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>",
        "UE_HOST": "<UE_HOST>",
        "UE_RC_HTTP_PORT": "<UE_RC_HTTP_PORT>",
        "UE_RC_WS_PORT": "<UE_RC_WS_PORT>",
        "MCP_AUTOMATION_PORT": "<MCP_AUTOMATION_PORT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "unreal-engine": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>",
        "UE_HOST": "<UE_HOST>",
        "UE_RC_HTTP_PORT": "<UE_RC_HTTP_PORT>",
        "UE_RC_WS_PORT": "<UE_RC_WS_PORT>",
        "MCP_AUTOMATION_PORT": "<MCP_AUTOMATION_PORT>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>",
        "UE_HOST": "<UE_HOST>",
        "UE_RC_HTTP_PORT": "<UE_RC_HTTP_PORT>",
        "UE_RC_WS_PORT": "<UE_RC_WS_PORT>",
        "MCP_AUTOMATION_PORT": "<MCP_AUTOMATION_PORT>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>",
        "UE_HOST": "<UE_HOST>",
        "UE_RC_HTTP_PORT": "<UE_RC_HTTP_PORT>",
        "UE_RC_WS_PORT": "<UE_RC_WS_PORT>",
        "MCP_AUTOMATION_PORT": "<MCP_AUTOMATION_PORT>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": [
        "-y",
        "unreal-engine-mcp-server"
      ],
      "env": {
        "UE_PROJECT_PATH": "<UE_PROJECT_PATH>",
        "MCP_AUTOMATION_CAPABILITY_TOKEN": "<MCP_AUTOMATION_CAPABILITY_TOKEN>",
        "UE_HOST": "<UE_HOST>",
        "UE_RC_HTTP_PORT": "<UE_RC_HTTP_PORT>",
        "UE_RC_WS_PORT": "<UE_RC_WS_PORT>",
        "MCP_AUTOMATION_PORT": "<MCP_AUTOMATION_PORT>"
      }
    }
  }
}

Remote

claude mcp add --transport http unreal-engine https://server.smithery.ai/@ChiR24/unreal_mcp/mcp

~/.codex/config.toml

[mcp_servers.unreal-engine]
url = "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"

# codex mcp add unreal-engine --url https://server.smithery.ai/@ChiR24/unreal_mcp/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "unreal-engine": {
      "url": "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "unreal-engine": {
      "type": "http",
      "url": "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "unreal-engine": {
      "httpUrl": "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "unreal-engine": {
      "url": "https://server.smithery.ai/@ChiR24/unreal_mcp/mcp"
    }
  }
}

Environment variables

UE_PROJECT_PATH
MCP_AUTOMATION_CAPABILITY_TOKEN
UE_HOST
UE_RC_HTTP_PORT
UE_RC_WS_PORT
MCP_AUTOMATION_PORT

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related