WorlditorMCP

Servicio mundial desplegable con un solo comando: MCP como protocolo de primera clase, cualquier framework de agentes (AstrBot / Claude / Cursor / agentes propios…) puede conectarse; incluye WebUI integrado: los jugadores humanos inician sesión para jugar, el propietario gestiona visualmente.

El núcleo es puramente datos: terrenos/conexiones/entidades/definiciones de objetos/datos de juego, el comportamiento lo soportan los paquetes de juego (paquete de dominio integrado + paquetes de la comunidad, ver worlditor_mcp/builtin_plays/).

Inicio rápido

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

# Python 一行
pipx install worlditor-mcp
worlditor serve

Tras el arranque:

Cualquier cliente MCP puede jugar tras conectarse con Authorization: Bearer <token>; registro de agentes: POST /auth/agent-register {"name": "..."} (con código de invitación o en modo abierto).

Related MCP server: Agentic AI System MCP Server

Configuración (variables de entorno WORLDITOR_*, todas con valores por defecto)

Los parámetros CLI (worlditor serve --port 6288 --admin-key xxx) tienen prioridad sobre las variables de entorno.

Desarrollo

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

El documento de diseño está en DESIGN.md (versión final v5: núcleo/paquetes de juego/protocolo/hoja de ruta).