Arenula

nyx000.github.io/arenula-mcp

Suite de servidores MCP para el motor de juego s&box. Conecta asistentes de codificación por IA al editor de s&box — leyendo escenas, creando objetos, compilando código, gestionando activos y más.

Diseñado siguiendo las mejores prácticas de MCP de Anthropic: herramientas omnímodas con enumeraciones de acciones, descripciones enriquecidas con orientación negativa, respuestas recortadas, errores procesables.

Arenula — Latín para "grano de arena". Un grano en la caja de arena.

Envoltorio de respuesta

Las herramientas de mutación devuelven JSON con estos campos:

• message — breve confirmación legible por humanos.

• verified — (opcional) relectura del estado después de la mutación, para que los llamantes puedan confirmar que el cambio realmente se aplicó. P. ej., después de component.add: { "component_exists": true, "component_type": "ModelRenderer" }. Después de terrain.configure_clutter: { "clutter_assigned": "volcano_ground", "seed": 42, "mode": "Infinite" }. Cuando este campo falta, el llamante debe asumir que la mutación no está verificada.

• warnings — (opcional) array de notas de éxito parcial por campo, cada una { field, message, suggestion? }. Se usa cuando la operación principal tuvo éxito pero algún subpaso se omitió — p. ej., networking.add_helper con una mezcla de IDs de punto de aparición válidos e inválidos devolverá el helper conectado y una advertencia por cada ID incorrecto.

Los errores aún devuelven el cuerpo estándar { error, action, suggestion } con isError: true. Cualquier valor orientado al usuario que no pueda resolverse a un recurso real del motor ahora genera un error con una sugerencia procesable en lugar de no hacer nada silenciosamente.

Related MCP server: sbox-mcp-documentation

Servidores

Configuración

1. Clonar Arenula-MCP

Clona o descarga este repositorio en algún lugar de tu máquina. Aquí es donde residirán los servidores API y Docs — no necesitan estar dentro de tu proyecto de s&box.

C:\Projects\Arenula-MCP\       <-- can be anywhere you like
  editor/                      goes into your s&box project (step 2)
  api/                         stays here, runs from here
  docs/                        stays here, runs from here

2. Plugin del editor

Copia editor/ en la carpeta Libraries de tu proyecto de s&box:

YourProject/
  Libraries/
    arenula_mcp/               <-- copy the contents of editor/ here
      Editor/
        Core/
        Handlers/
      sbox_mcp.sbproj

Abre s&box — Arenula se compila automáticamente e inicia el servidor MCP en el puerto 8098.

3. Compilar API y Docs

Desde la raíz de Arenula-MCP, instala y compila ambos servidores Node.js:

npm run setup        # installs dependencies and builds both servers

Esto compila api/dist/index.js y docs/dist/index.js — esos son los archivos a los que tu cliente de IA apuntará.

4. Configurar tu cliente de IA

Añade un archivo .mcp.json a la raíz de tu proyecto de s&box (o copia .mcp.json.example). Actualiza las rutas a donde clonaste Arenula-MCP:

{
  "mcpServers": {
    "editor": {
      "type": "sse",
      "url": "http://localhost:8098/sse"
    },
    "api": {
      "command": "node",
      "args": ["C:/Projects/Arenula-MCP/api/dist/index.js"],
      "env": {
        "SBOX_API_URL": "https://cdn.sbox.game/releases/..."
      }
    },
    "docs": {
      "command": "node",
      "args": ["C:/Projects/Arenula-MCP/docs/dist/index.js"]
    }
  }
}

Reemplaza C:/Projects/Arenula-MCP con donde hayas clonado el repositorio. Obtén la URL del esquema API más reciente desde sbox.game/api/schema (haz clic en Descargar, copia la URL).

Las herramientas aparecen como mcp__editor__*, mcp__api__*, mcp__docs__* en tu cliente de IA.

Herramientas del Editor

23 herramientas omnímodas, 182 acciones. Cada herramienta toma un parámetro action obligatorio.

Arquitectura

33 archivos fuente en C# — 9 de infraestructura principal, 24 manejadores por herramienta (incl. ConsoleHandler).

Atribución

• Editor basado en Ozmium MCP Server por ozmium7 (GPL-3.0)

• API basada en sbox-api-mcp por sofianebel (MIT)

• Documentación basada en sbox-docs-mcp por sofianebel (MIT)

Licencia

GPL-3.0 (Editor) · MIT (API, Docs, schemagen) — consulta LICENSE para saber por qué existe la división y cuál se aplica al código que copies.