Skip to content

Commit 44ea54a

Browse files
authored
feat: Update Unreal Engine MCP Server with intelligent asset path handling and other fixes (github#246)
* feat: Update Unreal Engine MCP Server with intelligent asset path handling and production-ready stability - Added intelligent asset path handling: supports actor classes (StaticMeshActor), asset paths (/Engine/BasicShapes/Cube), and simple names (Cube, Sphere) with auto-resolution - Enhanced AI assistant compatibility with automatic StaticMeshActor spawning for asset paths - Fixed circular reference issues preventing JSON serialization errors in complex Unreal objects - Improved stability with proper WebSocket error handling and response validation - Updated descriptions to highlight production-ready features and AI-friendly usage patterns - Successfully tested with local build (13 tools found), catalog generation, and Docker import * Update Unreal Engine MCP Server configuration - Remove 'Production-ready' from description - Update default host to host.docker.internal for Docker compatibility - Add comprehensive descriptions for all configuration parameters - Add required fields validation - Improve networking documentation for various deployment scenarios * chore(server): update Unreal Engine MCP Server icon URL * fix(unreal-engine-mcp-server): update server icon URL in metadata
1 parent 6387acb commit 44ea54a

2 files changed

Lines changed: 22 additions & 18 deletions

File tree

servers/unreal-engine-mcp-server/server.yaml

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,48 +11,52 @@ meta:
1111
- editor
1212
about:
1313
title: Unreal Engine MCP Server
14-
description: Comprehensive MCP server for controlling Unreal Engine via Remote Control API. Enables AI assistants to interact with Unreal Engine projects, manage assets, control actors, create cinematics, and automate game development workflows. Supports animation, physics, visual effects, blueprints, and more.
15-
icon: https://cdn2.unrealengine.com/ue-logo-stacked-unreal-engine-w-677x545-fac11de0943f.png
14+
description: MCP server for controlling Unreal Engine via Remote Control API. Features intelligent asset path handling, circular reference-safe responses, and 13 consolidated tools covering actors, assets, editor control, cinematics, physics, and more. Supports both simple shape names ("Cube") and full asset paths ("/Engine/BasicShapes/Cube") with automatic StaticMeshActor spawning. Handles common AI assistant usage patterns seamlessly.
15+
icon: https://raw.githubusercontent.com/ChiR24/Unreal_mcp/main/Public/icon.png
1616
source:
1717
project: https://github.com/ChiR24/Unreal_mcp
1818
config:
1919
description: Configure the connection to Unreal Engine Remote Control API
2020
env:
2121
- name: UE_HOST
22-
example: 127.0.0.1
2322
value: '{{unreal-engine-mcp-server.ue_host}}'
2423
- name: UE_RC_HTTP_PORT
25-
example: 30010
2624
value: '{{unreal-engine-mcp-server.ue_rc_http_port}}'
2725
- name: UE_RC_WS_PORT
28-
example: 30020
2926
value: '{{unreal-engine-mcp-server.ue_rc_ws_port}}'
3027
- name: USE_CONSOLIDATED_TOOLS
31-
example: true
3228
value: '{{unreal-engine-mcp-server.use_consolidated_tools}}'
3329
- name: LOG_LEVEL
34-
example: info
3530
value: '{{unreal-engine-mcp-server.log_level}}'
3631
parameters:
3732
type: object
3833
properties:
3934
ue_host:
4035
type: string
41-
default: 127.0.0.1
36+
default: "host.docker.internal"
37+
description: "Unreal Engine host address. Use: host.docker.internal for local UE on Windows/Mac Docker, 127.0.0.1 for Linux without Docker, or actual IP address (e.g., 192.168.1.100) for remote UE"
4238
ue_rc_http_port:
4339
type: string
44-
default: '30010'
40+
default: "30010"
41+
description: "Remote Control HTTP port"
4542
ue_rc_ws_port:
4643
type: string
47-
default: '30020'
44+
default: "30020"
45+
description: "Remote Control WebSocket port"
4846
use_consolidated_tools:
4947
type: boolean
5048
default: true
49+
description: "Use consolidated tools (13 tools) vs individual tools (36+ tools)"
5150
log_level:
5251
type: string
53-
default: info
52+
default: "info"
53+
description: "Logging level"
5454
enum:
55-
- debug
56-
- info
57-
- warn
58-
- error
55+
- "debug"
56+
- "info"
57+
- "warn"
58+
- "error"
59+
required:
60+
- ue_host
61+
- ue_rc_http_port
62+
- ue_rc_ws_port

servers/unreal-engine-mcp-server/tools.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@
4242
},
4343
{
4444
"name": "control_actor",
45-
"description": "Control actors - spawn, delete, apply physics",
45+
"description": "Control actors - spawn, delete, apply physics. Intelligently handles actor classes (StaticMeshActor, CameraActor) AND asset paths (/Engine/BasicShapes/Cube) or simple names (Cube, Sphere) with automatic StaticMeshActor spawning. AI-friendly with smart path resolution.",
4646
"arguments": [
4747
{
4848
"name": "action",
@@ -52,12 +52,12 @@
5252
{
5353
"name": "actorName",
5454
"type": "string",
55-
"desc": "Actor name"
55+
"desc": "Actor name (optional for spawn - auto-generated if not provided, required for delete/apply_force)"
5656
},
5757
{
5858
"name": "classPath",
5959
"type": "string",
60-
"desc": "Blueprint/class path"
60+
"desc": "Actor class (StaticMeshActor, CameraActor) OR asset path (/Engine/BasicShapes/Cube, /Game/MyMesh) OR simple shape name (Cube, Sphere). Asset paths automatically spawn StaticMeshActor with mesh applied. Simple names auto-resolve to engine assets."
6161
},
6262
{
6363
"name": "location",

0 commit comments

Comments
 (0)