Vibe Worldbuilding MCP

Vibe Worldbuilding MCP

Crea mundos ficticios detallados con Claude - Con taxonomías automáticas, entradas interconectadas, imágenes generadas por IA y sitios web navegables.

⚡ Inicio Rápido

1. Instalar Dependencias

# Python dependencies
pip install -e .

# Node.js dependencies  
npm install

2. Configurar la API de FAL (Opcional - para generación de imágenes)

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

3. Configurar el Servidor MCP

Añade a tu configuración de Claude Desktop:

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

4. Crea Tu Primer Mundo

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

🌟 Lo Que Obtienes

Pipeline Completo de Construcción de Mundos:

• ✅ Conceptos de mundos ricos con lore detallado y atmósfera
• ✅ Taxonomías personalizadas (personajes, ubicaciones, artefactos, etc.)
• ✅ Entradas interconectadas con referencias cruzadas automáticas
• ✅ Imágenes generadas por IA para elementos visuales del mundo
• ✅ Sitios web estáticos con navegación y galerías de imágenes
• ✅ Generación automática de stubs para entidades referenciadas

📚 Documentación

Documento	Propósito
📖 Guía de Usuario	Documentación completa de uso y ejemplos
⚡ Guía de Flujo de Trabajo	Secuencia de comandos MCP y mejores prácticas
🔧 Guía de Desarrollo	Contribución y configuración de desarrollo
🏗️ Guía de Arquitectura	Diseño del sistema y detalles técnicos

🧪 Pruebas

# 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

🚀 Mundos de Ejemplo

• Verdant Realms - Ecosistema de bosque bioluminiscente
• Mundos de Prueba - Generados por el conjunto de pruebas

📄 Licencia

Licencia MIT - Consulta LICENSE para más detalles.

---

Hecho con Claude 🤖 | Impulsado por MCP ⚡ | Mejorado con Imágenes de IA 🎨