# 🤖 Smart Retail MCP Server

Servidor de herramientas basado en [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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)

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

## Scripts

```bash
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