Skip to main content
Glama
deenesjakoruzh
Rail1bc

WorlditorMCP

by Rail1bc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

WorlditorMCP

한 줄 명령으로 배포하는 세계 서비스: MCP를 일급 시민 프로토콜로 하여, 모든 agent 프레임워크(AstrBot / Claude / Cursor / 자체 구축 agent…)를 연결할 수 있습니다. 자체 WebUI 포함——인간 플레이어가 로그인하여 플레이하고, 소유자가 시각적으로 관리합니다.

커널은 순수 데이터: 타일/연결/엔티티/아이템 정의/플레이 데이터, 동작은 플레이 패키지가 담당합니다(내장 도메인 패키지 + 커뮤니티 패키지, worlditor_mcp/builtin_plays/ 참조).

빠른 시작

# Docker（推荐）
docker run -d -p 6288:6288 -v worlditor-data:/data ghcr.io/rail1bc/worlditor:latest

# Python 一行
pipx install worlditor-mcp
worlditor serve

시작 후:

진입점

주소

WebUI(로그인/플레이/관리)

http://localhost:6288

MCP streamable HTTP

http://localhost:6288/world/mcp

MCP stdio(로컬 한 줄)

worlditor mcp-stdio --db data/world.db --token <agent-token>

모든 MCP client는 Authorization: Bearer <token>으로 연결한 후 플레이할 수 있습니다. agent 등록: POST /auth/agent-register {"name": "..."}(초대 코드 또는 공개).

Related MCP server: Agentic AI System MCP Server

구성(환경 변수 WORLDITOR_*, 모두 기본값 있음)

변수

기본값

설명

WORLDITOR_DATA_DIR

./data

데이터 디렉터리(world.db / plays/)

WORLDITOR_HOST / WORLDITOR_PORT

0.0.0.0 / 6288

수신 주소

WORLDITOR_AUTH_MODE

open

open / invite / closed

WORLDITOR_ADMIN_KEY

비어 있음

관리자 등록 키(비어 있음 = 첫 등록자가 admin)

WORLDITOR_ALLOW_AGENT_REGISTER

1

agent 자체 등록 허용 여부

WORLDITOR_ALLOWED_ORIGINS

비어 있음

CORS 허용 출처(쉼표로 구분)

WORLDITOR_STATIC_DIR

자동 감지

WebUI 빌드 산출물 디렉터리

CLI 매개변수(worlditor serve --port 6288 --admin-key xxx)가 환경 변수보다 우선합니다.

개발

uv sync          # 或 pip install -e .[dev]
pytest           # 全量测试
ruff check . && ruff format --check .
cd webui && npm install && npm run build   # 前端构建（dist 提交跟踪）

설계 문서는 DESIGN.md 참조(v5 확정: 커널/플레이 패키지/프로토콜/로드맵).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Game World Sandbox MCP

    ECNU3D
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables creation and management of structured game worlds for text adventures and RPGs with character creation, world generation, and natural language interaction through AI integration.
    1
    MIT

  • Agentic AI System MCP Server

    saikumarjash
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables deployment of autonomous AI agents with memory and tool execution capabilities through a WebSocket-based MCP protocol. Provides production-ready infrastructure with REST API access, persistent state management, and extensible function registry for building self-hosted AI systems.
    -

  • DIYworld MCP

    billxfan
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables MCP-capable agents to connect to a persistent shared-world service, discover people and worlds, and participate via natural-language actions.
    9 npm
    -