overdare-studio-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| STUDIO_HOST | No | Studio RPC host (default: 127.0.0.1) | 127.0.0.1 |
| STUDIO_PORT | No | Studio RPC port (default: 13377) | 13377 |
| OVERDARE_UNSAFE | No | Set to 1 to skip backup/rollback (not recommended) | |
| OVERDARE_MCP_TRACE | No | Set to 1 to enable Recorder for tracing RPC calls | |
| OVERDARE_ASSET_ROOTS | No | Additional allowed paths for image import (platform-specific separator) | |
| OVERDARE_PROJECT_CWD | No | Path to the folder containing the .umap/.ovdrjm world file. Required for write tools. | |
| OVERDARE_ALLOW_PUBLISH | No | Set to 1 to allow publishing (one of four gates) | |
| OVERDARE_MCP_TRACE_DIR | No | Directory to save trace files for replay | |
| OVERDARE_RPC_TIMEOUT_MS | No | RPC timeout in milliseconds (default: 30000) | 30000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| studio_capabilitiesA | Studio RPC 기능 지원 여부(capability)와 버전을 보고한다. 최초 1회 probe 후 캐시. refresh:true 면 강제 재확인. 지원하지 않는 기능을 호출하면 각 도구가 capability 에러를 계약 형태로 반환한다. |
| studio_browseA | OVERDARE Studio 레벨 인스턴스 트리를 조회한다 (RPC level.browse). 각 노드는 guid/name/class/children 을 가진다. startGuid 로 특정 노드부터, classType 으로 클래스 필터(예 Part/Script), maxDepth 로 깊이 제한(1=최상위만 권장). |
| studio_screenshotA | OVERDARE Studio 뷰포트 스크린샷을 캡처해 파일로 저장한다 (RPC game.screenshot, captureType=Viewport). 현재 Viewport 모드만 지원. 응답이 느릴 수 있어 타임아웃을 길게 잡는다. |
| studio_applyA | 디스크의 .ovdrjm 변경분을 라이브 씬에 반영한다 (RPC level.apply). 보통 .ovdrjm 편집 직후 호출하는 쓰기 파이프라인의 일부. 보류분이 없으면 사실상 no-op. |
| studio_saveA | 편집 중인 월드를 파일로 저장한다 (RPC level.save.file). .umap 과 .ovdrjm 둘 다 갱신됨. |
| studio_create_partA | 부모 인스턴스(parentGuid) 하위에 Part 를 생성한다. 쓰기 파이프라인(backup→modify→validate→level.apply→level.save.file)을 강제하며, 실패 시 자동 rollback. parentGuid 는 studio_browse 로 먼저 확인할 것. 속성: Size/CFrame/Color/Material/Anchored 등. Position 은 CFrame.Position 으로 지정한다. Size 단위는 cm. |
| studio_add_scriptA | 부모 인스턴스(parentGuid) 하위에 Script/LocalScript/ModuleScript 를 추가한다. 쓰기 파이프라인(backup→modify→validate→level.apply→level.save.file)을 강제하며, 실패 시 자동 rollback. 들여쓰기는 탭 사용 권장(선행 4-스페이스 그룹은 자동으로 탭 변환). |
| studio_update_partA | 기존 Part(또는 인스턴스)의 이름/속성을 수정한다. 쓰기 파이프라인(backup→modify→validate→level.apply→level.save.file)을 강제하며 실패 시 자동 rollback. 전달한 필드만 바뀌고 나머지는 보존된다(부분 업데이트). guid 는 studio_browse 로 확인. 속성: Size/CFrame(Position·Orientation)/Color/Material/Anchored/Transparency 등. name 으로 이름 변경. |
| studio_deleteA | 인스턴스를 삭제한다 (자식 포함 — 서브트리 통째로 제거). 쓰기 파이프라인(backup→modify→validate→level.apply→level.save.file)을 강제하며 실패 시 자동 rollback. 서비스(Workspace/Lighting/Players 등 싱글톤)는 삭제할 수 없다. guid 는 studio_browse 로 확인. |
| studio_import_modelA | 에셋 스토어(Asset Drawer)의 모델을 레벨에 임포트한다 (계층 보존). assetid 는 ovdrassetid://<숫자> 형식. 실패 시 자동 rollback. 지원 안 하면 capability 에러. |
| studio_import_imageA | 로컬 이미지 파일을 에셋 매니저에 임포트하고 asset id 를 반환한다. 경로는 프로젝트 경계(기본) 또는 OVERDARE_ASSET_ROOTS 안의 이미지 파일만 허용된다. 지원 확장자: .png, .jpg, .jpeg, .bmp, .tga, .gif, .webp. 지원 안 하면 capability 에러. |
| studio_apply_action_sequenceA | 기존 ActionSequencer 인스턴스(instanceGuid)에 시퀀서 JSON 파일을 적용한다. jsonFilePath 는 프로젝트 경계 안의 .json 파일이어야 한다(경로검증). 실패 시 자동 rollback. 지원 안 하면 capability 에러. |
| studio_publishA | 월드를 OVERDARE 플랫폼에 공개한다. 비가역·외부공개. 기본은 dry-run(미리보기). 실제 발사는 OVERDARE_ALLOW_PUBLISH=1 + confirm:true + dryRun:false 가 모두 충족돼야 한다. 하나라도 빠지면 RPC 를 호출하지 않는다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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/AS1HK/overdare-studio-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server