Vibe Worldbuilding Mcp

Create detailed fictional worlds with Claude - Complete with automatic taxonomies, interconnected entries, AI-generated images, and navigable websites.

⚡ Quick Start

1. Install Dependencies

## Python dependencies
pip install -e .

## Node.js dependencies  
npm install

2. Configure FAL API (Optional - for image generation)

## Add your FAL API key to .env
echo "FAL_KEY=your_api_key_here" > .env

3. Set Up MCP Server

Add to your Claude Desktop configuration:

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

4. Create Your First World

1. Ask Claude: "Create a fantasy world about floating islands"
2. Claude uses MCP tools to build complete world structure
3. Generated world includes entries, images, and navigable website

🌟 What You Get

Complete Worldbuilding Pipeline:

✅ Rich world concepts with detailed lore and atmosphere
✅ Custom taxonomies (characters, locations, artifacts, etc.)
✅ Interconnected entries with automatic cross-references
✅ AI-generated images for visual world elements
✅ Static websites with navigation and image galleries
✅ Auto-stub generation for referenced entities

📚 Documentation

Document	Purpose
📖 User Guide{:target=“_blank”}	Complete usage documentation and examples
⚡ Workflow Guide{:target=“_blank”}	MCP command sequence and best practices
🔧 Development Guide{:target=“_blank”}	Contributing and development setup
🏗️ Architecture Guide{:target=“_blank”}	System design and technical details

🧪 Testing

## Run complete test suite
python tests/run_tests.py

## Test with image generation
python tests/test_e2e_comprehensive.py --verbose

## Keep test world for exploration
python tests/test_e2e_comprehensive.py --verbose