About Sbox MCP
Sbox MCP is an MCP server in the Productivity category: mcp server for sbox.
The repository has 5 stars and 0 forks.
Install
git clone https://github.com/gabrieldcl/sbox-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Sbox MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
sbox-mcp
MCP server giving Claude full real-time awareness of the S&Box editor.
30 tools — scene hierarchy, GameObjects, components, C# scripts, console output, assets, editor control.
Architecture
Claude Code (WSL)
↕ stdio (MCP protocol)
TypeScript MCP Server [Node.js, WSL]
↕ WebSocket ws://[windows-host]:27015
S&Box Bridge Addon [C#, inside S&Box editor]
↕ S&Box editor APIs
S&Box Editor
Setup
1. Install the S&Box addon
Copy the contents of addon/code/ into the S&Box toolbase code directory:
C:\Program Files (x86)\Steam\steamapps\common\sbox\addons\tools\Code\SboxMcp\
The final structure should look like:
addons\tools\Code\SboxMcp\
BridgeServer.cs
CommandRouter.cs
ConsoleCapture.cs
EditorPanel.cs
Handlers\
SceneHandler.cs
ComponentHandler.cs
FileHandler.cs
EditorHandler.cs
ConsoleHandler.cs
AssetHandler.cs
This puts the code inside local.toolbase — the package S&Box always compiles on startup.
Restart S&Box. Once it compiles, go to Editor → MCP Bridge → Open Panel.
It shows "Waiting for connection..." — this is normal until the MCP server connects.
2. Build the TypeScript MCP server
cd server
npm install
npm run build
3. Add to Claude Code
claude mcp add -s user sbox -- node /home/<you>/projects/sbox-mcp/server/dist/index.js
Restart Claude Code. The sbox MCP server will be active in all sessions.
Tools
| Category | Tools |
|---|---|
| Scene read | scene_get_info, scene_get_hierarchy, scene_get_object, scene_find_objects |
| Scene write | scene_create_object, scene_delete_object, scene_set_transform, scene_set_name, scene_set_enabled, scene_clone_object, scene_reparent_object, scene_save, scene_undo, scene_redo |
| Components | component_list, component_get, component_set, component_add, component_remove |
| Files | file_read, file_write, file_list, project_info |
| Editor | editor_get_selection, editor_select_object, editor_play, editor_stop, editor_is_playing |
| Console | console_get_output, console_run_command |
| Assets | asset_search, asset_mount, asset_browse_local |
WSL Networking
The TypeScript server auto-detects the Windows host IP from /etc/resolv.conf.
The S&Box addon binds to 0.0.0.0:27015 so it's reachable from WSL.
To use a different port:
SBOX_MCP_PORT=27015 node dist/index.js
Configuration
The addon auto-starts the WebSocket server when S&Box opens.
Use the MCP Bridge panel → Restart if the connection drops.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.