Ozmium S&box

v1.0.0Developer Toolsstable

Connect AI coding assistants to the S&box editor using the Model Context Protocol (MCP). While you're building your game, your AI assistant can see inside the editor in real time — reading your scene, listing GameObjects, and running console commands

ozmium-mcp-server-for-sboxmcpai-integration
Share:
17
Stars
0
Downloads
0
Weekly
0/5

What is Ozmium S&box?

Ozmium S&box is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to connect ai coding assistants to the s&box editor using the model context protocol (mcp). while you're building your game, your ai assistant can see inside the editor in real time — reading your scene,...

Connect AI coding assistants to the S&box editor using the Model Context Protocol (MCP). While you're building your game, your AI assistant can see inside the editor in real time — reading your scene, listing GameObjects, and running console commands

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Connect AI coding assistants to the S&box editor using the M

Use Cases

Connect AI to the S&box game editor in real-time.
Read scene contents and list GameObjects in your game.
Run console commands in the editor from AI assistants.
ozmium7

Maintainer

LicenseGPL-3.0
Languagec#
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ozmium-mcp-server-for-sbox

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Ozmium S&box

Ozmium MCP Server for S&box bridges AI coding assistants directly to the S&box game editor using the Model Context Protocol over a local SSE connection on port 8098. With 95 tools across 12 categories, it gives your AI full real-time visibility into your scene — reading GameObjects, modifying components, instantiating prefabs, controlling play mode, and running console commands — all without leaving your editor or copy-pasting code.

Prerequisites

  • S&box game engine installed and running
  • Ozmium MCP plugin added via the S&box Library Manager or as a git submodule at Libraries/ozmium.oz_mcp
  • An MCP-compatible AI client such as Claude Desktop
  • No external API keys required — the server runs entirely on localhost
1

Add the Ozmium plugin to your S&box project

Add the plugin via the S&box Library Manager or as a git submodule placed at Libraries/ozmium.oz_mcp inside your project. Allow S&box to compile the plugin after adding it.

git submodule add https://github.com/ozmium7/Ozmium-MCP-Server-for-Sbox Libraries/ozmium.oz_mcp
2

Start the MCP server inside the S&box editor

Open the S&box editor, navigate to Editor → MCP → Open MCP Panel, then click Start MCP Server. The status indicator turns green when the server is listening on localhost:8098 via SSE.

3

Configure your AI client to connect via SSE

Add the SSE endpoint to your MCP client configuration. The server uses type 'sse' and connects to http://localhost:8098/sse. No authentication is needed.

{
  "mcpServers": {
    "sbox": {
      "url": "http://localhost:8098/sse",
      "type": "sse"
    }
  }
}
4

Verify the connection

Ask your AI assistant to list GameObjects in the current scene. If the server is running and connected correctly, it will return a live list of objects from your open scene.

5

Explore the 95 available tools

The server exposes tools across 12 categories: Scene Read, Scene Write, Assets, Editor, Console, Mesh, Physics, Audio, Lighting, Effects, and more. Use natural language to interact with your scene without context-switching.

Ozmium S&box Examples

Client configuration (Claude Desktop)

Add this to your Claude Desktop config file to connect to the locally running S&box MCP server.

{
  "mcpServers": {
    "sbox": {
      "url": "http://localhost:8098/sse",
      "type": "sse"
    }
  }
}

Prompts to try

Real-time scene interaction prompts that leverage the 95 tools available in the Ozmium server.

- "List all GameObjects in the current scene and their components"
- "Create a new GameObject called 'Player' and add a CharacterController component"
- "Find all GameObjects within a 10-unit radius of the origin"
- "Run the 'noclip' console command"
- "Start play mode and tell me when it's running"

Troubleshooting Ozmium S&box

Status indicator stays red after clicking Start MCP Server

Ensure the plugin compiled successfully — check the S&box console for compilation errors. Restart the editor after resolving any compile errors, then try starting the server again.

AI client cannot connect to http://localhost:8098/sse

Confirm the MCP server is running (green indicator in the MCP Panel). Some AI clients require the server to be running before the client is launched. Also verify no firewall rule is blocking port 8098 on localhost.

Tools return stale or empty scene data

The server reads scene state in real time. Make sure you have a scene open in the S&box editor. If you recently changed scenes, the server automatically reflects the new scene on the next tool call.

Frequently Asked Questions about Ozmium S&box

What is Ozmium S&box?

Ozmium S&box is a Model Context Protocol (MCP) server that connect ai coding assistants to the s&box editor using the model context protocol (mcp). while you're building your game, your ai assistant can see inside the editor in real time — reading your scene, listing gameobjects, and running console commands It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Ozmium S&box?

Follow the installation instructions on the Ozmium S&box GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Ozmium S&box?

Ozmium S&box works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Ozmium S&box free to use?

Yes, Ozmium S&box is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ozmium-mcp-server-for-sbox": { "command": "npx", "args": ["-y", "ozmium-mcp-server-for-sbox"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Ozmium S&box?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides