jongjae0305
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
# 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.
|