Vibe Worldbuilding MCP

Ciptakan dunia fiksi yang mendetail dengan taksonomi otomatis, entri yang saling terhubung, gambar yang dihasilkan AI, dan situs web yang dapat dinavigasi.

Dokumentasi

Vibe Worldbuilding MCP

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

Example World

⚑ 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

DocumentPurpose
πŸ“– User GuideComplete usage documentation and examples
⚑ Workflow GuideMCP command sequence and best practices
πŸ”§ Development GuideContributing and development setup
πŸ—οΈ Architecture GuideSystem 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

πŸš€ Example Worlds

πŸ“„ License

MIT License - See LICENSE for details.


Made with Claude πŸ€– | Powered by MCP ⚑ | Enhanced with AI Images 🎨