VRBeats Unity MCP Server

This MCP server connects Codex to the Unity Editor bridge in this project.

Unity side

Open the project in Unity. The bridge auto-starts on domain reload and listens only on:

http://127.0.0.1:19744

Manual controls are available in Unity:

Tools > Codex Bridge > Start Server
Tools > Codex Bridge > Stop Server
Tools > Codex Bridge > Auto Start
Tools > Codex Bridge > Capture Game View

Install

Run once from this folder:

npm install

Codex MCP config

Add a server entry like this to the Codex MCP config, then restart Codex/VS Code so the tool list refreshes:

[mcp_servers.vrbeats_unity]
command = "node"
args = ["C:\\Users\\User-40\\Desktop\\unity\\work\\BeatSabar\\VRBeatSaber\\tools\\unity-mcp-server\\index.mjs"]
startup_timeout_sec = 30

[mcp_servers.vrbeats_unity.env]
UNITY_BRIDGE_URL = "http://127.0.0.1:19744"

Exposed tools

unity_health
unity_capture_game_view
unity_get_console_logs
unity_list_scene_roots
unity_list_scene_objects
unity_get_object
unity_set_transform
unity_set_play_state

unity_capture_game_view writes Captures/latest.png in the project root.