smart-retail-mcp
🤖 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 |
| Obtiene el inventario actual de todos los productos junto con los tiempos de entrega del proveedor |
| Calcula la velocidad promedio de ventas diarias por producto en los últimos N días |
| Crea alertas de reabastecimiento cuando el stock se agotará antes de la próxima entrega |
Related MCP server: vanam-erp-mcp
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 pruebaConfiguración
Variables de entorno (.env)
DATABASE_URL=postgresql://usuario:password@localhost:5432/smart_retailScripts
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 TypeScriptDependencias
@modelcontextprotocol/sdk— SDK oficial de MCPpg— Cliente PostgreSQLdotenv— 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
Available Tools
3 toolscreate_ai_recommendationA
Crea una alerta de reabastecimiento en la base de datos cuando detectas que el stock se agotará antes de que el proveedor pueda entregar.
Inputs: reason (required), product_id (required), recommended_order_qty (required).
get_current_stockA
Obtiene los niveles actuales de inventario de todos los productos y los tiempos de entrega del proveedor.
Inputs: no named parameters.
get_sales_velocityA
Calcula el promedio de ventas diarias de los productos en los últimos X días. Útil para predecir cuándo se agotará el stock.
Inputs: days (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct inventory concern: current stock and lead times, sales velocity, and creating restock alerts. There is no meaningful overlap, so an agent can select the correct tool without ambiguity.
All tool names follow a consistent verb_noun pattern: get_current_stock, get_sales_velocity, create_ai_recommendation. The naming is predictable and clear.
Three tools is at the low end, but each tool has a clear role in the inventory-alerting workflow. The count feels appropriate for a narrow purpose, though the broad server name could imply more coverage.
The set covers the input side well, but create_ai_recommendation is a create-only operation with no way to list, update, or delete existing recommendations. This leaves agents with a dead end for managing alert state.
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceInventory Management AI - MCP server providing AI-powered tools and automation by MEOK AI Labs8 npm36 PyPIMIT
- FlicenseAqualityDmaintenanceMCP server for querying inventory items and stock levels via internal API, enabling AI chatbots to look up product codes and current quantities.2-
- AlicenseNot gradedqualityDmaintenancePredictive supply-chain MCP server that forecasts material confirmation risks and enables AI clients to interact with the system via natural language.MIT
- FlicenseNot gradedqualityCmaintenanceEnterprise-grade MCP server for intelligent supply chain analytics, enabling managers to investigate forecast accuracy, vendor performance, demand trends, and root causes using natural language.-