🤖 Smart Retail MCP Server

Servidor de herramientas basado en Model Context Protocol (MCP) que provee capacidades de análisis predictivo de inventario a agentes de IA.

Herramientas Disponibles

Herramienta	Descripción
`get_current_stock`	Obtiene el inventario actual de todos los productos junto con los tiempos de entrega del proveedor
`get_sales_velocity`	Calcula la velocidad promedio de ventas diarias por producto en los últimos N días
`create_ai_recommendation`	Crea alertas de reabastecimiento cuando el stock se agotará antes de la próxima entrega

Arquitectura

src/
├── index.ts   → Definición e implementación de herramientas MCP (stdio transport)
├── db.ts      → Pool de conexión a PostgreSQL
└── seed.ts    → Script para insertar datos de prueba

Configuración

Variables de entorno (.env)

DATABASE_URL=postgresql://usuario:password@localhost:5432/smart_retail

Scripts

npm start      # Ejecutar el servidor MCP
npm run dev    # Desarrollo con hot-reload (tsx watch)
npm run seed   # Insertar datos de prueba
npm run build  # Compilar TypeScript

Dependencias

@modelcontextprotocol/sdk — SDK oficial de MCP
pg — Cliente PostgreSQL
dotenv — Variables de entorno

Comunicación

El servidor se comunica vía stdio (stdin/stdout). El frontend Next.js lo levanta como proceso hijo usando StdioClientTransport del SDK MCP. No expone puertos HTTP.

Licencia

ISC

smart-retail-mcp