Vibe Worldbuilding MCP

Vibe Worldbuilding MCP

Crie mundos ficcionais detalhados com Claude - Com taxonomias automáticas, entradas interconectadas, imagens geradas por IA e sites navegáveis.

⚡ Início Rápido

1. Instalar Dependências

# Python dependencies
pip install -e .

# Node.js dependencies  
npm install

2. Configurar API FAL (Opcional - para geração de imagens)

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

3. Configurar o Servidor MCP

Adicione à sua configuração do Claude Desktop:

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

4. Crie Seu Primeiro 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

🌟 O Que Você Obtém

Pipeline Completo de Worldbuilding:

• ✅ Conceitos de mundo ricos com lore detalhado e atmosfera
• ✅ Taxonomias personalizadas (personagens, locais, artefatos, etc.)
• ✅ Entradas interconectadas com referências cruzadas automáticas
• ✅ Imagens geradas por IA para elementos visuais do mundo
• ✅ Sites estáticos com navegação e galerias de imagens
• ✅ Geração automática de stubs para entidades referenciadas

📚 Documentação

Documento	Finalidade
📖 Guia do Usuário	Documentação completa de uso e exemplos
⚡ Guia de Fluxo de Trabalho	Sequência de comandos MCP e melhores práticas
🔧 Guia de Desenvolvimento	Contribuição e configuração de desenvolvimento
🏗️ Guia de Arquitetura	Design do sistema e detalhes técnicos

🧪 Testes

# 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 Exemplo

• Verdant Realms - Ecossistema de floresta bioluminescente
• Test Worlds - Gerados pela suíte de testes

📄 Licença

Licença MIT - Consulte LICENSE para detalhes.

---

Feito com Claude 🤖 | Impulsionado por MCP ⚡ | Aprimorado com Imagens de IA 🎨