Vibe Stack MCP

Ajuda desenvolvedores a escolher a stack de tecnologia certa para seus projetos com recomendações personalizadas.

Documentação

Vibe Stack MCP 🚀

Um servidor Model Context Protocol (MCP) que ajuda desenvolvedores VibeCoder a escolher a stack de tecnologia perfeita para seus projetos por meio de questionamento progressivo e recomendações personalizadas.

Ideal para prototipagem rápida e para obter recomendações de stack de tecnologia com base nos requisitos do seu projeto, orçamento, cronograma e nível de conforto técnico.

O que ele faz

Este servidor MCP ajuda desenvolvedores a escolher rapidamente stacks de tecnologia ideais sem cair na paralisia de análise técnica. Em vez de pesquisar dezenas de frameworks, ele faz perguntas inteligentes sobre o seu projeto e oferece a stack moderna e comprovada que atende às suas necessidades.

Principais recursos

  • Perguntas sem jargões: Usa linguagem simples que qualquer pessoa entende
  • Elicitação progressiva: Coleta requisitos passo a passo usando a especificação de elicitação do MCP
  • Foco em Plataforma como Serviço: Recomenda plataformas fáceis de usar, como Vercel, Supabase, Netlify
  • Orientação prática: Fornece guias de implantação e estimativas de custo
  • Adequado para iniciantes: Foca em ferramentas que minimizam a complexidade técnica

Instalação

  1. Instale as dependências:
uv pip install fastmcp
  1. Execute o servidor:
python run_server.py
  1. Adicione à configuração do seu cliente MCP (ex.: Claude Desktop):
{
  "mcpServers": {
    "vibe-stack-planner": {
      "command": "python",
      "args": ["/path/to/vibe_coder_stack_planner/run_server.py"]
    }
  }
}

Ferramentas Disponíveis

start_project_planning()

Inicia o processo de planejamento interativo por meio de uma série de perguntas simples:

  • O que você está tentando construir?
  • Quem vai usar e como?
  • Quais recursos você precisa?
  • Quantos usuários você espera?
  • Qual é o seu orçamento e nível de conforto técnico?

recommend_stack(session_requirements?)

Fornece recomendações de stack de tecnologia com base nos requisitos coletados. Pode ser usado com ou sem o processo interativo.

explain_recommendation(detail_level?)

Explica por que tecnologias específicas foram recomendadas, com explicações "básicas" ou "detalhadas".

get_deployment_guide(platform?)

Fornece instruções de implantação passo a passo, adaptadas às suas necessidades específicas.

Exemplo de Uso

User: I want to build something but I don't know where to start technically.

AI: Let me help you plan the right tech stack! I'll use the vibe coder stack planner to ask you some simple questions.

[Uses start_project_planning tool]

Server: Let's start planning your project! First, tell me about your vision.
What problem are you trying to solve, or what idea do you want to build?

[Progressive questioning continues...]

Server: 🎉 Perfect! Based on what you've told me, here's my recommendation:

**Recommended Tech Stack:**
• Frontend: Next.js (React framework) for a modern web app
• Backend: Supabase (handles database, auth, and API automatically)  
• Hosting: Vercel (free tier covers most small projects)
• Domain: Namecheap or Google Domains (~$12/year)

**Why this works for you:**
I chose beginner-friendly tools that handle most technical details automatically. These tools let you build and deploy quickly. This stack has generous free tiers to keep costs minimal.

Arquitetura

O servidor usa:

  • FastMCP: Framework Python de alto nível para servidores MCP
  • Elicitation Spec: Especificação de elicitação MCP mais recente para questionamento interativo
  • Recomendações baseadas em regras: Analisa requisitos para sugerir tecnologias apropriadas
  • Revelação progressiva: Constrói complexidade gradualmente com base no nível de conforto do usuário

Plataformas Suportadas

O servidor foca em soluções de Plataforma como Serviço:

  • Frontend: Vercel, Netlify, GitHub Pages
  • Backend: Vercel Functions, Netlify Functions, Supabase
  • Banco de dados: Supabase, PlanetScale, Firebase
  • Autenticação: Supabase Auth, Auth0, Clerk
  • Hospedagem: Vercel, Netlify, Render

Desenvolvimento

Para estender ou modificar o servidor:

  1. Adicionar novos tipos de pergunta: Modifique o fluxo de elicitação nas funções _ask_about_*
  2. Melhorar as recomendações: Atualize a função _analyze_requirements
  3. Adicionar novas plataformas: Estenda a lógica de recomendação e os guias de implantação
  4. Melhorar a interface do usuário: A especificação de elicitação suporta controles de formulário avançados

Licença

Este projeto é open source. Sinta-se à vontade para fazer fork, estender e contribuir!


Feito com ❤️ para a comunidade vibe coder