Skip to main content
Glama
deenesjakoruzh
Nyx000

Arenula MCP

by Nyx000
OverviewSchemaRelated ServersScoreDiscussions
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 installed

F
license - not found
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • ChiR24-unreal_mcp_server

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…

  • gread

    An MCP server that gives your AI access to the source code and docs of all public github repos

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Nyx000/arenula-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server