Skip to main content
Glama
deenesjakoruzh
Nyx000

Arenula MCP

by Nyx000
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Arenula

nyx000.github.io/arenula-mcp

用于 s&box 游戏引擎的 MCP 服务器套件。将 AI 编码助手连接到 s&box 编辑器——读取场景、创建对象、编译代码、管理资源等。

遵循 Anthropic 的 MCP 最佳实践 设计：包含动作枚举的综合工具、带有负面指导的丰富描述、精简的响应、可操作的错误。

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

服务器

服务器

功能

运行时

传输方式

Editor

场景操作、编译、资源、地形

s&box 内部的 C# 插件

SSE :8098

API

离线类型/成员参考（约 1,800 种类型，约 15,000 个成员）、PBR 纹理获取

Node.js

stdio

Docs

来自 sbox.game 的叙述性文档（通过 .md 端点的原始 Markdown）

Node.js

stdio

设置

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/ 复制到你的 s&box 项目的 Libraries 文件夹中：

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

打开 s&box —— Arenula 会自动编译并在端口 8098 上启动 MCP 服务器。

3. 构建 API 和 Docs

从 Arenula-MCP 根目录安装并构建两个 Node.js 服务器：

npm run setup        # installs dependencies and builds both servers

这将构建 api/dist/index.js 和 docs/dist/index.js —— 这些是你的 AI 客户端将指向的文件。

4. 配置你的 AI 客户端

在你的 s&box 项目根目录中添加一个 .mcp.json 文件（或复制 .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 替换为你克隆仓库的位置。从 sbox.game/api/schema 获取最新的 API 模式 URL（点击下载，复制 URL）。

工具在你的 AI 客户端中显示为 mcp__editor__*、mcp__api__*、mcp__docs__*。

编辑器工具

23 个综合工具，182 个动作。每个工具都接受一个必需的 action 参数。

工具

操作

数量

scene

summary, hierarchy, statistics, find, find_in_radius, get_details, prefab_instances

7

gameobject

create, destroy, duplicate, reparent, rename, enable, set_tags, set_transform, batch_transform

9

component

add, remove, set_property, set_enabled, get_properties, get_types, copy

7

compile

trigger, status, errors, generate_solution, wait

5

prefab

instantiate, get_structure, get_instances, break, update, create, save_overrides, revert, get_overrides

9

asset_query

browse, search, open, get_dependencies, get_model_info, get_material_properties, get_mesh_info, get_bounds, get_unsaved, get_status, get_json, get_references

12

asset_manage

create, delete, rename, move, save, reload, get_references

7

editor

select, get/set_selected, clear/frame_selection, get_play_state, start/stop_play, get_log, save_scene, save_scene_as, save_all, undo/redo, console_list, console_run, open_code_file, get/set_preferences

19

session

list, set_active, load_scene

3

lighting

create, configure, create_skybox, set_skybox

4

physics

add_collider, configure_collider, add_rigidbody, create_model_physics, create_character_controller, create_joint

6

audio

create, configure

2

effects

create, configure_particle, configure_post_processing, configure_sprite, configure_prop, configure_world_panel

6

camera

create, configure, capture_viewport, capture_tour, orbit_capture

5

mesh

create_block, create_plane, create_cylinder, create_wedge, create_arch, create_clutter, extrude_faces, remove_faces, add_face, clip_faces, scale_mesh, thicken_faces, bevel_edges, bevel_vertices, split_edges, quad_slice_faces, dissolve_edges, bridge_edges, connect_vertices, flip_faces, extend_edges, set_face_material, set_texture_params, vertex ops, get_info

27

navmesh

create_agent, create_area, create_link, generate, generate_tile, unload_tile, set_defer_generation, get_status, query_path

9

cloud

search, get_package, get_versions, mount

4

project

get_collision, set_collision_rule, get_input, get_info

4

terrain

create, configure, get_info, get_height, get_height_region, set_height, noise, erode, stamp, add/remove_material, get_material_at, blend_materials, set_hole, paint_material, import/export_heightmap, sync, configure_clutter, regenerate_clutter, clear_clutter

21

trace

ray, sphere_cast, box_cast, sample_grid, multi_ray

5

player

create, configure_movement, configure_camera, configure_body, configure_interaction

5

networking

add_helper, configure_object, get_status

3

schema

export, info, clear

3

架构

33个C#源文件——9个核心基础设施，24个按工具处理程序（包括ConsoleHandler）。

架构

署名

许可证

GPL-3.0 (编辑器) · MIT (API, 文档, schemagen) — 参见 LICENSE 了解拆分原因以及适用于您复制代码的许可证。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers