# 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:

```text
http://127.0.0.1:19744
```

Manual controls are available in Unity:

```text
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:

```powershell
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:

```toml
[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.