Vibe Stack MCP

Vibe Stack MCP 🚀

Un servidor de Model Context Protocol (MCP) que ayuda a los desarrolladores de VibeCoder a elegir la pila tecnológica perfecta para sus proyectos mediante preguntas progresivas y recomendaciones personalizadas.

Perfecto para la creación rápida de prototipos y para obtener recomendaciones de pila tecnológica basadas en los requisitos de tu proyecto, presupuesto, cronograma y nivel de comodidad técnica.

Qué hace

Este servidor MCP ayuda a los desarrolladores a elegir rápidamente pilas tecnológicas óptimas sin quedarse atascados en la parálisis del análisis técnico. En lugar de investigar docenas de frameworks, hace preguntas inteligentes sobre tu proyecto y te ofrece la pila moderna y probada que se adapta a tus necesidades.

Características principales

• Preguntas sin jerga: Utiliza un lenguaje sencillo que cualquiera puede entender
• Elicitación progresiva: Recopila requisitos paso a paso utilizando la especificación de elicitación de MCP
• Enfoque en Plataforma como Servicio: Recomienda plataformas fáciles de usar como Vercel, Supabase, Netlify
• Guía práctica: Proporciona guías de implementación y estimaciones de costos
• Apto para principiantes: Se centra en herramientas que minimizan la complejidad técnica

Instalación

1. Instala las dependencias:

uv pip install fastmcp

2. Ejecuta el servidor:

python run_server.py

3. Añádelo a la configuración de tu cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "vibe-stack-planner": {
      "command": "python",
      "args": ["/path/to/vibe_coder_stack_planner/run_server.py"]
    }
  }
}

Herramientas disponibles

start_project_planning()

Inicia el proceso de planificación interactiva mediante una serie de preguntas sencillas:

• ¿Qué estás tratando de construir?
• ¿Quién lo usará y cómo?
• ¿Qué características necesitas?
• ¿Cuántos usuarios esperas?
• ¿Cuál es tu presupuesto y nivel de comodidad técnica?

recommend_stack(session_requirements?)

Proporciona recomendaciones de pila tecnológica basadas en los requisitos recopilados. Se puede usar con o sin el proceso interactivo.

explain_recommendation(detail_level?)

Explica por qué se recomendaron tecnologías específicas, con explicaciones "básicas" o "detalladas".

get_deployment_guide(platform?)

Proporciona instrucciones de implementación paso a paso adaptadas a tus necesidades específicas.

Ejemplo 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.

Arquitectura

El servidor utiliza:

• FastMCP: Framework de Python de alto nivel para servidores MCP
• Especificación de elicitación: Última especificación de elicitación de MCP para preguntas interactivas
• Recomendaciones basadas en reglas: Analiza requisitos para sugerir tecnologías apropiadas
• Divulgación progresiva: Construye complejidad gradualmente según el nivel de comodidad del usuario

Plataformas compatibles

El servidor se centra en soluciones de Plataforma como Servicio:

• Frontend: Vercel, Netlify, GitHub Pages
• Backend: Vercel Functions, Netlify Functions, Supabase
• Database: Supabase, PlanetScale, Firebase
• Auth: Supabase Auth, Auth0, Clerk
• Hosting: Vercel, Netlify, Render

Desarrollo

Para extender o modificar el servidor:

1. Añade nuevos tipos de preguntas: Modifica el flujo de elicitación en las funciones _ask_about_*
2. Mejora las recomendaciones: Actualiza la función _analyze_requirements
3. Añade nuevas plataformas: Extiende la lógica de recomendación y las guías de implementación
4. Mejora la interfaz de usuario: La especificación de elicitación admite controles de formulario enriquecidos

Licencia

Este proyecto es de código abierto. ¡Siéntete libre de hacer fork, extender y contribuir!

---

Hecho con ❤️ para la comunidad de vibe coders