UEVR-MCP Server

An MCP (Model Context Protocol) server that gives AI agents live, programmatic access to any Unreal Engine game running with UEVR — from flat-screen games injected into VR to native UE titles.

• Inspect everything. Every UObject, every field, every UFunction — searchable and navigable from a running game. Call any method, chain multi-step queries across the object graph, batch operations in a single tick.
• Read and write live state. Player health, enemy AI, physics, materials, animations, transforms — the agent sees what the game sees, in real time.
• Full VR control. HMD and controller poses, haptic feedback, snap turn, aim method, motion controller attachment — complete VR subsystem access.
• Live Lua scripting. Execute Lua code in the game process with persistent state, frame callbacks, timers, async coroutines, and a module system. Hot-reload scripts without losing state. Write and deploy scripts to the UEVR autorun folder.
• Screenshot from the GPU. Capture the game’s D3D11 or D3D12 backbuffer as JPEG — works even when the game window is behind other windows. Handles R10G10B10A2, FP16 HDR, BGRA8, and RGBA8 formats with high-quality WIC scaling.
• Crash diagnostics built in. Pull a single snapshot with callback health counters, breadcrumb state, plugin inventory, latest crash dump, UEVR log tail, runtime map/controller/pawn, and live render metadata.
• Reverse-engineer anything. Snapshot an object’s state, perform an action, diff to see what changed. Hook any UFunction to log calls, block execution, or run Lua callbacks with argument inspection. Watch properties with Lua triggers for reactive scripting.
• Real-time event streaming. Poll for hook fires, watch changes, and Lua output in real time via long-polling.
• ProcessEvent listener. Start/stop a global ProcessEvent hook to capture every Blueprint and native function call in real time — filter by name, ignore noisy ticks, establish baselines, and discover what the game does when you take an action. Equivalent to UEVR’s Developer tab.
• Motion controller attachment. Attach any actor or component to a VR controller hand with position/rotation offsets — the core mechanism for making VR mods feel native.
• Timer/scheduler. Create one-shot or repeating timers that execute Lua code, with full lifecycle management (list, cancel, clear).
• Dump a buildable UE project from a running game. One call produces a .uproject + per-module Source//{Public,Private}/*.h tree with real UCLASS(Config=Game) / UPROPERTY(EditAnywhere, Replicated) / AActor* Owner headers, real property offsets, typed object refs, enum entries, interface inheritance, CDO default values, and Kismet bytecode previews on Blueprint-hosted functions. Falls back to Dumper-7 + USMAP conversion for games where UEVR’s render hooks are fragile.