Vibe Worldbuilding

html

8

GitHub Stars

html

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jasnonaz-vibe-worldbuilding-mcp": {
      "command": "python3",
      "args": [
        "./vibe_worldbuilding_server.py"
      ],
      "env": {
        "FAL_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run and use a dedicated MCP server to automate rich worldbuilding workflows. This server orchestrates world concepts, custom taxonomies, interconnected entries, AI-generated images, and navigable static websites, enabling you to create and navigate complex fictional worlds with ease.

How to use

You interact with the MCP server through an MCP client to create and manage worlds. Start by telling the system what you want to build, for example a fantasy world with floating islands. The server will generate a complete world structure, including entries, images, and a navigable website. You can then explore the world, inspect cross-references, and view visual assets generated for key concepts.

How to install

Prerequisites: you need Python and Node.js installed on your machine.

pip install -e .

# Node.js dependencies
npm install

Configure MCP server (stdio)

{
  "mcpServers": {
    "vibe_worldbuilding": {
      "command": "python3",
      "args": ["./vibe_worldbuilding_server.py"],
      "env": {
        "FAL_KEY": "your_fal_api_key_here"
      }
    }
  }
}

Set up and run the server in your environment

Add the MCP server configuration to your client settings as shown in the example above. This enables the client to launch the Python-based server and pass the required environment variable for image generation if you choose to use it.

Create your first world

Ask the client to create a world with a prompt like: “Create a fantasy world about floating islands.” 2. The MCP server builds a complete world structure, including entries, images, and a navigable site. 3. You’ll have generated content ready to review and refine.

Testing and example worlds

You can run the provided tests to validate the setup and explore example worlds. For example, you may run end-to-end tests to verify image generation and world creation workflows, then keep a test world open for exploration.

What you get

A complete worldbuilding pipeline that delivers rich lore, custom taxonomies, interconnected entries, AI-generated imagery, and static websites with auto-stub generation for referenced entities.

Notes on dependencies and tooling

The project uses Python for the server, with Node.js tooling for client-side dependencies. You’ll install Python packages and Node.js packages during setup.

Example worlds

Verdant Realms — Bioluminescent forest ecosystem. Test Worlds — Generated by test suite.

License

MIT License - See LICENSE for details.