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? } 형태의 필드별 부분 성공 메모 배열입니다. 주요 작업은 성공했지만 일부 하위 단계가 건너뛰어진 경우에 사용됩니다. 예: 유효한 스폰 포인트 ID와 유효하지 않은 ID가 혼합된 networking.add_helper는 헬퍼가 연결된 상태와 잘못된 ID 각각에 대한 경고를 반환합니다.

오류는 여전히 isError: true와 함께 표준 { error, action, suggestion } 본문을 반환합니다. 실제 엔진 리소스로 확인할 수 없는 사용자 대상 값은 이제 자동으로 무효 처리되지 않고 실행 가능한 제안과 함께 오류를 발생시킵니다.

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 엔드포인트를 통한 원시 마크다운)

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를 저장소를 클론한 위치로 바꾸세요. 최신 API 스키마 URL은 sbox.game/api/schema에서 가져오세요 (다운로드 클릭, 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__aterial__roperties, 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__aterial, get__aterial_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