s&box MCP Server

Permite que assistentes de IA interajam com objetos e componentes do jogo s&box por meio de comunicação WebSocket.

GitHub
10
Experimente este MCPPatrocinado

Documentação

[!IMPORTANT]

Projeto Descontinuado

O desenvolvimento desta biblioteca foi descontinuado.

Decidi parar de manter este projeto, pois o ecossistema MCP para s&box começou a seguir em uma direção diferente. Na mesma época, a Braxen começou a desenvolver seu próprio MCP, e vários outros MCPs começaram a ser lançados.

O principal problema desta biblioteca é que ela exigia a criação e execução de um servidor de ponte externo entre o agente de codificação e o motor do jogo. Embora essa abordagem funcionasse, não era fácil de configurar, era trabalhosa de manter e adicionava complexidade desnecessária para os usuários.

No final, optei por uma solução diferente: sdocs.suiram.dev, um MCP focado em fornecer aos agentes um melhor contexto sobre a documentação e a API do s&box.

Isso se mostrou mais útil do que um MCP que faz a ponte diretamente com o motor do jogo. O maior problema não era a comunicação com o motor, mas a falta de documentação confiável e contexto de API disponível para os agentes de codificação.

Este repositório permanecerá disponível para referência, mas deve ser considerado obsoleto e não é mais desenvolvido ativamente.

Model Context Protocol para s&box

.NET s&box

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA interajam com o editor do s&box por meio de comunicação WebSocket em tempo real.

Este servidor MCP funciona em conjunto com a s&box Adapter Library separada para fornecer integração perfeita entre assistentes de IA e seus projetos s&box.

Pré-requisitos

Início Rápido

Passo 1: Instalar e Executar o Servidor MCP

Para começar, certifique-se de ter o Docker instalado no seu sistema. Usuários do Cursor podem simplesmente clicar no botão abaixo para instalar e iniciar o Servidor MCP automaticamente, ou você pode seguir as instruções manuais abaixo.

  1. Execute o contêiner

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

  2. Conecte seu assistente de IA ao Servidor MCP em execução

    Install MCP Server

Instalação Manual usando .NET SDK

  1. Compile o servidor

        dotnet build

  2. Execute o servidor

        dotnet run

  3. Conecte seu assistente de IA ao Servidor MCP em execução

    Install MCP Server

Passo 2: Instalar a Adapter Library no s&box

Para habilitar a interação com o s&box, você precisa instalar a biblioteca adaptadora. Esta biblioteca permite que o Servidor MCP se comunique com o editor do s&box.

  1. Instale a Adapter Library do repositório sbox-mcp-library

  2. Siga as instruções de configuração no repositório da Adapter Library para:

    • Instalar a biblioteca no seu projeto s&box através da Asset Library
    • Conectar-se a este Servidor MCP

[!IMPORTANT] O servidor deve estar em execução para que a biblioteca adaptadora do s&box funcione. Certifique-se de que o servidor esteja em execução antes de prosseguir para o próximo passo.

Uso

Depois que este Servidor MCP e a s&box Adapter Library estiverem instalados e conectados, você pode interagir com seu editor do s&box usando linguagem natural através do seu assistente de IA:

"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"

Arquitetura

Este Servidor MCP atua como uma ponte entre:

  • Assistente de IA ↔ Este Servidor MCP ↔ s&box Adapter Library ↔ Editor do s&box

O Servidor MCP:

  • Recebe comandos de assistentes de IA via Model Context Protocol
  • Traduz chamadas de ferramentas MCP em comandos WebSocket estruturados
  • Envia comandos para a s&box Adapter Library para execução
  • Retorna respostas aos assistentes de IA

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

Repositórios Relacionados

Suporte