Game World Sandbox

You can manage and interact with game worlds using an MCP server built for fast, structured world generation and character management. This server enables AI-assisted world creation, character handling, and in-memory world data with strong validation, making it ideal for text adventures and role-playing scenarios driven by language models.

How to use

Interact with the MCP server through a client that communicates with the MCP endpoint. Start by running the server locally, then connect your client to generate worlds, create characters, and access complete world data. You can generate fantasy or sci-fi worlds, define characters with backstories, and query the full World Bible for your chosen world.

Typical workflows include creating a new world, adding player characters, and then querying the world data to guide storytelling or gameplay. The system validates world structure and character data to keep world state consistent during your adventures.

How to install

Prerequisites: Python 3.13 or newer and a virtual environment are recommended.

# Install Python and set up a virtual environment
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Additional content

Configuration and startup notes help you run the server and connect clients smoothly. The MCP server exposes an HTTP endpoint for remote clients and can also be started as a local stdio process for direct control.

Security and access: keep your OpenAI API keys and any integration tokens secure. If you enable external AI integrations, ensure proper access controls and environment isolation for your runtime.

Examples: after starting the server, use your MCP client to request world creation, character creation, and world data retrieval. The system is designed to provide structured responses that map to your game world concepts.

Notes: the server uses a World Bible schema to validate data and maintain consistency across cosmology, geography, society, and history. You can extend the schema with new components as your game evolves.

MCP server configuration snippets

{
  "mcpServers": {
    "gameworld_mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp/",
      "args": []
    },
    "gameworld_mcp_stdio": {
      "type": "stdio",
      "name": "gameworld_mcp_stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Available tools

generate_world

Creates a new game world based on a specified style such as Fantasy or Sci-Fi.

create_character

Adds a player character to an existing world with a full set of attributes and inventory.

worlds://{world_id}

Retrieves the complete World Bible for a given world ID.