Skip to main content
Glama
deenesjakoruzh
Rail1bc

WorlditorMCP

by Rail1bc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

WorlditorMCP

Мировой сервис, разворачиваемый одной командой: MCP — протокол первого класса, любая агентная платформа (AstrBot / Claude / Cursor / собственный агент…) может подключиться; встроенный 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-клиент может играть, подключившись с Authorization: Bearer <token>; регистрация агента: 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

Разрешать ли самостоятельную регистрацию агентов

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
    -