Skip to main content
Glama
deenesjakoruzh
Rail1bc

WorlditorMCP

by Rail1bc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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:

Entrada

Dirección

WebUI (inicio de sesión/juego/gestión)

http://localhost:6288

MCP streamable HTTP

http://localhost:6288/world/mcp

MCP stdio (una línea local)

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

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)

Variable

Por defecto

Descripción

WORLDITOR_DATA_DIR

./data

Directorio de datos (world.db / plays/)

WORLDITOR_HOST / WORLDITOR_PORT

0.0.0.0 / 6288

Dirección de escucha

WORLDITOR_AUTH_MODE

open

open / invite / closed

WORLDITOR_ADMIN_KEY

vacío

Clave de registro de administrador (vacía = el primer registrado es admin)

WORLDITOR_ALLOW_AGENT_REGISTER

1

Si se permite el auto-registro de agentes

WORLDITOR_ALLOWED_ORIGINS

vacío

Orígenes permitidos para CORS (separados por comas)

WORLDITOR_STATIC_DIR

detección automática

Directorio de artefactos de compilación del WebUI

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).

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
    -