ShopOps MCP

KI-gestützter Server, der das Model Context Protocol (MCP) zur Verwaltung von Shopify- und WooCommerce-Shops implementiert.

Funktionen

Shop-Connectoren für Shopify und WooCommerce.
11 MCP-Tools für Bestandsverwaltung, Preisgestaltung, Kunden, Bestellungen, Produktleistung und Berichterstattung.
4 MCP-Ressourcen für Shop-Übersicht, Bestand, aktuelle Bestellungen und Top-Kunden.
Bestandsvorhersage mittels gleitendem Durchschnitt der Nachfrage und Sicherheitsbestand-Berechnung.
RFM-basierte Kundensegmentierung (7 verschiedene Segmente).
KI-gestützte Preisanalyse und -optimierung.
Erkennung von Bestellanomalien / Betrugserkennung.
ABC-Analyse der Produktleistung.
Automatisierte tägliche und wöchentliche Berichte.
Dualer Transport: lokales stdio und Streamable HTTP (MCPize).
TypeScript, @modelcontextprotocol/sdk v1.29+, Zod v4.
Kostenlose Stufe sowie kostenpflichtige Pläne für 25 $ und 45 $.

Schnellstart

# 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

Der Server liest die Umgebungsvariablen, verbindet sich mit dem/den konfigurierten Shop(s) und stellt die MCP-Tools und -Ressourcen bereit.

MCP-Tools

Tool	Beschreibung
`store_connect`	Stellt eine Verbindung zu einem Shopify- oder WooCommerce-Shop her und validiert die Anmeldedaten.
`inventory_status`	Gibt aktuelle Lagerbestände, Rückstands-Flags und Warnungen bei niedrigem Bestand zurück.
`inventory_forecast`	Projiziert zukünftigen Bestandsbedarf unter Verwendung von gleitendem Durchschnitt der Nachfrage und Sicherheitsbestand-Puffern.
`pricing_analyze`	Erstellt einen Bericht zur Preiselastizität und identifiziert unter- oder überbewertete SKUs.
`pricing_optimize`	Schlägt optimale Preispunkte basierend auf KI-gesteuerten Nachfrageprognosen und Wettbewerberdaten vor.
`customers_segment`	Führt eine RFM-Analyse durch und weist Kunden einem von sieben Segmenten zu.
`customers_churn`	Bewertet Kunden hinsichtlich des Abwanderungsrisikos und bietet Empfehlungen zur Kundenbindung.
`order_anomalies`	Erkennt potenziell betrügerische oder fehlerhafte Bestellungen mithilfe von Mustererkennungsmodellen.
`product_performance`	Führt eine ABC-Analyse durch und gibt Beitragskennzahlen pro Produktklasse zurück.
`report_daily`	Erstellt eine tägliche Zusammenfassung der Betriebsabläufe (Verkäufe, Bestand, Warnungen) im JSON/CSV-Format.
`report_weekly`	Erstellt einen wöchentlichen Leistungsbericht mit Trendvisualisierungen.

MCP-Ressourcen

Ressource	Beschreibung
`store://overview`	Hochrangige Shop-Kennzahlen: Gesamtumsatz, Bestellungen, Kunden und Bruttomarge.
`store://inventory`	Vollständiger Bestandskatalog mit vorhandener Menge, reserviertem Bestand und prognostizierten Engpässen.
`store://orders/recent`	Liste der 100 aktuellsten Bestellungen mit Status, Gesamtwert und Zahlungsmethode.
`store://customers/top`	Top 50 Kunden, sortiert nach Lifetime Value, Kaufhäufigkeit und Aktualität.

Konfiguration

Erstellen Sie eine .env-Datei im Projektstammverzeichnis. Die folgenden Variablen sind erforderlich:

Variable	Erforderlich für	Beschreibung
`SHOPIFY_API_KEY`	Shopify	API-Schlüssel der privaten App.
`SHOPIFY_API_PASSWORD`	Shopify	Passwort der privaten App.
`SHOPIFY_STORE_DOMAIN`	Shopify	Shop-Domain (z. B. `myshop.myshopify.com`).
`WOOCOMMERCE_CONSUMER_KEY`	WooCommerce	Consumer-Key der REST-API.
`WOOCOMMERCE_CONSUMER_SECRET`	WooCommerce	Consumer-Secret der REST-API.
`WOOCOMMERCE_STORE_URL`	WooCommerce	Shop-URL (z. B. `https://example.com`).
`MCP_PORT`	HTTP-Transport	Port für den Streamable HTTP-Endpunkt (Standard `8080`).
`MCP_LOG_LEVEL`	Alle	Ausführlichkeit der Protokollierung (`error`, `warn`, `info`, `debug`).
`MCP_PRICING_MODEL`	Pricing-Tools	Auswahl des Preismodells (`basic`, `advanced`).
`MCP_FORECAST_WINDOW_DAYS`	Bestandsvorhersage	Anzahl der Tage für die Prognose (Standard `30`).

Optionale Variablen:

Variable	Beschreibung
`MCP_ENABLE_ANONYMIZATION`	Wenn auf `true` gesetzt, werden personenbezogene Daten in Berichten maskiert.
`MCP_REPORT_S3_BUCKET`	Falls angegeben, werden tägliche/wöchentliche Berichte in den angegebenen S3-Bucket hochgeladen.

Lizenz

ShopOps MCP wird unter der MIT-Lizenz veröffentlicht. Siehe LICENSE für die vollständigen Bedingungen.

Autor: Automatia BCN

shopops-mcp