ShopOps MCP

Servidor basado en IA que implementa el Protocolo de Contexto de Modelo (MCP) para gestionar tiendas Shopify y WooCommerce.

Características

Conectores de tienda para Shopify y WooCommerce.
11 herramientas MCP que cubren inventario, precios, clientes, pedidos, rendimiento de productos e informes.
4 recursos MCP que exponen la visión general de la tienda, inventario, pedidos recientes y mejores clientes.
Previsión de inventario mediante demanda de media móvil más cálculo de stock de seguridad.
Segmentación de clientes basada en RFM (7 segmentos distintos).
Análisis y optimización de precios impulsados por IA.
Detección de anomalías / fraude en pedidos.
Análisis ABC del rendimiento de productos.
Informes diarios y semanales automatizados.
Transporte dual: stdio local y HTTP Streamable (MCPize).
TypeScript, @modelcontextprotocol/sdk v1.29+, Zod v4.
Nivel gratuito, además de planes de pago de 25 $ y 45 $.

Inicio rápido

# 1. Install the package
npm i shopops-mcp

# 2. Create a .env file (see Configuration section)
cp .env.example .env

# 3. Run the server (local stdio mode)
npx shopops-mcp run --transport stdio

# 4. Or start the HTTP endpoint (MCPize deployment)
npx shopops-mcp run --transport http --port 8080

El servidor leerá las variables de entorno, se conectará a la(s) tienda(s) configurada(s) y expondrá las herramientas y recursos de MCP.

Herramientas MCP

Herramienta	Descripción
`store_connect`	Establece una conexión con una tienda Shopify o WooCommerce y valida las credenciales.
`inventory_status`	Devuelve los niveles de stock actuales, indicadores de pedidos pendientes y alertas de stock bajo.
`inventory_forecast`	Proyecta las necesidades futuras de inventario utilizando la demanda de media móvil y buffers de stock de seguridad.
`pricing_analyze`	Genera un informe de elasticidad de precios e identifica los SKU con precios bajos o altos.
`pricing_optimize`	Sugiere puntos de precio óptimos basados en previsiones de demanda impulsadas por IA y datos de la competencia.
`customers_segment`	Realiza un análisis RFM y asigna a los clientes a uno de los siete segmentos.
`customers_churn`	Evalúa a los clientes según el riesgo de abandono y proporciona recomendaciones de retención.
`order_anomalies`	Detecta pedidos potencialmente fraudulentos o erróneos utilizando modelos de reconocimiento de patrones.
`product_performance`	Realiza un análisis ABC y devuelve métricas de contribución por clase de producto.
`report_daily`	Genera un resumen de operaciones diario en JSON/CSV (ventas, inventario, alertas).
`report_weekly`	Genera un informe de rendimiento semanal con visualizaciones de tendencias.

Recursos MCP

Recurso	Descripción
`store://overview`	Métricas de alto nivel de la tienda: ventas totales, pedidos, clientes y margen bruto.
`store://inventory`	Catálogo completo de inventario con cantidad disponible, stock reservado y escasez prevista.
`store://orders/recent`	Lista de los 100 pedidos más recientes con estado, valor total y método de pago.
`store://customers/top`	Los 50 mejores clientes clasificados por valor de vida, frecuencia de compra y recencia.

Configuración

Cree un archivo .env en la raíz del proyecto. Se requieren las siguientes variables:

Variable	Requerido para	Descripción
`SHOPIFY_API_KEY`	Shopify	Clave API de la aplicación privada.
`SHOPIFY_API_PASSWORD`	Shopify	Contraseña de la aplicación privada.
`SHOPIFY_STORE_DOMAIN`	Shopify	Dominio de la tienda (p. ej., `myshop.myshopify.com`).
`WOOCOMMERCE_CONSUMER_KEY`	WooCommerce	Clave de consumidor de la API REST.
`WOOCOMMERCE_CONSUMER_SECRET`	WooCommerce	Secreto de consumidor de la API REST.
`WOOCOMMERCE_STORE_URL`	WooCommerce	URL de la tienda (p. ej., `https://example.com`).
`MCP_PORT`	Transporte HTTP	Puerto para el endpoint HTTP Streamable (por defecto `8080`).
`MCP_LOG_LEVEL`	Todo	Verbosidad del registro (`error`, `warn`, `info`, `debug`).
`MCP_PRICING_MODEL`	Herramientas de precios	Seleccionar modelo de precios (`basic`, `advanced`).
`MCP_FORECAST_WINDOW_DAYS`	Previsión de inventario	Número de días a prever (por defecto `30`).

Variables opcionales:

Variable	Descripción
`MCP_ENABLE_ANONYMIZATION`	Cuando se establece en `true`, los datos de identificación personal se enmascaran en los informes.
`MCP_REPORT_S3_BUCKET`	Si se proporciona, los informes diarios/semanales se cargan en el bucket de S3 especificado.

Licencia

ShopOps MCP se publica bajo la Licencia MIT. Consulte LICENSE para conocer los términos completos.

Autor: Automatia BCN

shopops-mcp