Skillget

sbox-mcp-server

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Gecti
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This server implements the Model Context Protocol (MCP) to bridge AI coding assistants with the s&box game engine, allowing the AI to interact with the game's editor via real-time WebSocket communication.

Security Assessment
The code scan reviewed 2 files and found no dangerous patterns, hardcoded secrets, or dangerous permission requests. Functionally, the tool executes via a local Docker container and exposes a local server (`localhost:8080`). It relies on WebSocket connections to communicate with the game engine, meaning it makes local network requests to operate. Overall security risk is rated as Low.

Quality Assessment
This project is explicitly marked as discontinued and deprecated in its README. While the repository saw a push very recently (0 days ago), it only holds 10 GitHub stars and lacks a license file, which means there are no formal usage or distribution rights granted to users. The author notes it was abandoned due to being overly complex to maintain and has been replaced by an alternative documentation-focused approach.

Verdict
Not recommended for new projects, as the tool is officially deprecated, entirely unsupported, and lacks a software license.
SUMMARY

An integration of an MCP server for the game S&box.

README.md

[!IMPORTANT]

Project Discontinued

Development of this library has been discontinued.

I decided to stop maintaining this project as the MCP ecosystem for s&box started moving forward in a different direction. Around the same time, Braxen began developing their own MCP, and multiple other MCPs started to be released.

The main issue with this library is that it required building and running an external bridge server between the coding agent and the game engine. While this approach worked, it was not easy to set up, was painful to maintain, and added unnecessary complexity for users.

In the end, I moved toward a different solution: sdocs.suiram.dev, an MCP focused on providing agents with better context about the s&box documentation and API.

This turned out to be more useful than an MCP that directly bridges with the game engine. The bigger problem was not engine communication, but the lack of reliable documentation and API context available to coding agents.

This repository will remain available for reference, but it should be considered deprecated and is no longer actively developed.

Model Context Protocol for s&box

.NET
s&box

A Model Context Protocol (MCP) server that enables AI assistants to interact with the s&box editor through real-time WebSocket communication.

This MCP server works in conjunction with the separate s&box Adapter Library to provide seamless integration between AI assistants and your s&box projects.

Prerequisites

Quick Start

Step 1: Install and Run the MCP Server

To get started, make sure you have Docker installed on your system. Cursor users can simply click the button below to install and launch the MCP Server automatically, or you can follow the manual instructions below.

  1. Run the container

    docker run -d -p 8080:8080 --name sbox-mcp-server ghcr.io/suiramdev/sbox-mcp-server:latest

  2. Connect your AI assistant to the running MCP Server

    Install MCP Server

Manual Installation using .NET SDK

  1. Build the server

        dotnet build

  2. Run the server

        dotnet run

  3. Connect your AI assistant to the running MCP Server

    Install MCP Server

Step 2: Install the Adapter Library in s&box

To enable interaction with s&box, you need to install the adapter library. This library allows the MCP Server to communicate with the s&box editor.

  1. Install the Adapter Library from the sbox-mcp-library repository

  2. Follow the setup instructions in the Adapter Library repository to:

    • Install the library in your s&box project through the Asset Library
    • Connect to this MCP Server

[!IMPORTANT]
The server must be running for the s&box adapter library to function. Please ensure the server is running before proceeding to the next step.

Usage

Once both this MCP Server and the s&box Adapter Library are installed and connected, you can interact with your s&box editor using natural language through your AI assistant:

"Create a ModelRenderer component on the Cube object"
"Find all game objects named 'Player'"
"Set the Scale property of the Transform component on MainCamera to 2,2,2"
"Remove the Rigidbody component from the Ball object"
"Show me all components attached to the Ground object"

Architecture

This MCP Server acts as a bridge between:

  • AI Assistant ↔ This MCP Server ↔ s&box Adapter Library ↔ s&box Editor

The MCP Server:

  • Receives commands from AI assistants via the Model Context Protocol
  • Translates MCP tool calls into structured WebSocket commands
  • Sends commands to the s&box Adapter Library for execution
  • Returns responses back to AI assistants

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Related Repositories

Support

Yorumlar (0)

Sonuc bulunamadi