Volver al CV

MealVault

Gestiona recetas, despensa, planificación de comidas y listas de la compra, con un servidor MCP que expone la API como herramientas para un LLM.

Detalle de receta
Estado
Autoalojado

Qué hace

  • Recetas con sustitutos y subrecetas.
  • Inventario de despensa: cocinar una receta descuenta existencias, empezando por lo más antiguo.
  • «Qué puedo cocinar ahora», con lo que falta en las recetas casi posibles.
  • Menús semanales y listas de la compra, más un registro de movimientos de la despensa para analizar el consumo.

Cómo está hecho

  • API REST con Flask y flask-smorest, con documentación OpenAPI generada. Una clase manager por modelo reúne sus consultas y sus reglas de negocio.
  • SQLAlchemy 2.0 con migraciones de Alembic y pruebas que se ejecutan contra un PostgreSQL real.
  • El servidor MCP es un paquete aparte con 32 herramientas escritas a mano y orientadas a tareas, en lugar de una herramienta por endpoint generada desde unas 65 rutas CRUD, entre las que un modelo elegiría mal.
  • Frontend con React 19, TypeScript y Vite sobre la misma API.
  • Siguiente paso: agentes de LangChain que sugieran recetas a partir de la despensa y planifiquen la semana.
Lista de la despensa
Menú semanal

Tecnologías

  • Python
  • Flask
  • SQLAlchemy
  • PostgreSQL
  • Redis
  • React
  • TypeScript
  • FastMCP
  • Alembic