Arenula

nyx000.github.io/arenula-mcp

Набор MCP-серверов для игрового движка s&box. Подключает ИИ-помощников по коду к редактору s&box — чтение сцен, создание объектов, компиляция кода, управление активами и многое другое.

Разработан в соответствии с лучшими практиками MCP от Anthropic: универсальные инструменты с перечислениями действий, подробные описания с негативными указаниями, сокращённые ответы, действенные ошибки.

Arenula — латинское слово, означающее "песчинка". Одна песчинка в песочнице.

Конверт ответа

Инструменты мутации возвращают JSON со следующими полями:

• message — краткое человекочитаемое подтверждение.

• verified — (опционально) обратное чтение состояния после мутации, чтобы вызывающие могли подтвердить, что изменение действительно применилось. Например, после component.add: { "component_exists": true, "component_type": "ModelRenderer" }. После terrain.configure_clutter: { "clutter_assigned": "volcano_ground", "seed": 42, "mode": "Infinite" }. Если это поле отсутствует, вызывающий должен считать мутацию неподтверждённой.

• warnings — (опционально) массив заметок о частичном успехе по полям, каждый { field, message, suggestion? }. Используется, когда основная операция выполнена, но некоторый подшаг был пропущен — например, networking.add_helper со смесью допустимых и недопустимых ID точек появления вернёт подключённого помощника и предупреждение для каждого плохого ID.

Ошибки по-прежнему возвращают стандартное тело { error, action, suggestion } с isError: true. Любое пользовательское значение, которое не может быть разрешено в реальный ресурс движка, теперь вызывает ошибку с действенным предложением, а не молча игнорируется.

Related MCP server: sbox-mcp-documentation

Серверы

Настройка

1. Клонирование Arenula-MCP

Клонируйте или загрузите этот репозиторий куда-нибудь на вашу машину. Здесь будут располагаться серверы API и Docs — они не обязательно должны находиться внутри вашего проекта 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. Плагин редактора

Скопируйте editor/ в папку Libraries вашего проекта s&box:

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

Откройте s&box — Arenula скомпилируется автоматически и запустит MCP-сервер на порту 8098.

3. Сборка API и Docs

Из корня Arenula-MCP установите и соберите оба Node.js сервера:

npm run setup        # installs dependencies and builds both servers

Это собирает api/dist/index.js и docs/dist/index.js — эти файлы будет использовать ваш ИИ-клиент.

4. Настройка вашего ИИ-клиента

Добавьте файл .mcp.json в корень вашего проекта s&box (или скопируйте .mcp.json.example). Обновите пути до места, куда вы клонировали 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"]
    }
  }
}

Замените C:/Projects/Arenula-MCP на путь, куда вы клонировали репозиторий. Получите последний URL схемы API с sbox.game/api/schema (нажмите Download, скопируйте URL).

Инструменты отображаются как mcp__editor__*, mcp__api__*, mcp__docs__* в вашем ИИ-клиенте.

Инструменты редактора

23 универсальных инструмента, 182 действия. Каждый инструмент принимает обязательный параметр action.

Архитектура

33 файла исходного кода на C# — 9 базовой инфраструктуры, 24 обработчика для каждого инструмента (включая ConsoleHandler).

Атрибуция

• Редактор основан на Ozmium MCP Server от ozmium7 (GPL-3.0)

• API основан на sbox-api-mcp от sofianebel (MIT)

• Документация основана на sbox-docs-mcp от sofianebel (MIT)

Лицензия

GPL-3.0 (Редактор) · MIT (API, Документация, schemagen) — см. LICENSE для объяснения, почему существует разделение и какая лицензия применяется к коду, который вы копируете.