Shopify AI Ops Agent
🛍️ Shopify AI Operations Agent
Ein produktionsreifer autonomer E-Commerce-Operations-Agent, entwickelt mit LangGraph v1, Model Context Protocol (MCP 2026-07-28), FastAPI, PostgreSQL + pgvector, Redis, OpenTelemetry und strenger Human-in-the-Loop (HITL)-Risiko-Governance.
📖 Vollständige technische Dokumentation
Für detaillierte Architektur, Terminologien und Architectural Decision Records (ADRs) in ASD-STE100 (Simplified Technical English), siehe:
👉 DOCUMENTATION.md
Laden Sie das visuelle Präsentations-PDF herunter:
👉 architecture_diagram.pdf (oder unter http://localhost:8000/architecture.pdf)
Related MCP server: MCP Shopify
🏗️ Zentrale Architektur-Invarianten
Pre-Execution Risk & Policy Gate: Destruktive Löschungen, finanzielle Budgets und ausgehende Kommunikationen lösen einen LangGraph-Interrupt (
interrupt_before) aus, der eine menschliche Genehmigung erfordert.Decoupled MCP Tool Layer: Alle Geschäftsfunktionen sind als 5 zustandslose MCP-Tool-Server (
Shopify,Analytics,Meta Ads,Communications,Trend Intelligence) gekapselt.Deterministic Business Analytics: Finanzkennzahlen werden mithilfe deterministischer SQL-Routinen berechnet, wodurch arithmetische LLM-Halluzinationen eliminiert werden.
Anti-Early-Victory Sensors: Der Agent fragt den Live-Zustand erneut ab, um mathematisch zu verifizieren, dass Mutationen stattgefunden haben, bevor er den Abschluss meldet.
Shift-Left Evals & Tracing: 28 automatisierte pytest-Testsuiten, ein Golden-Eval-Benchmark mit 17 Fällen und ein unabhängiges Critic-Agent-Audit (Score: 98.5/100, Grade: A+).
📁 Repository-Struktur
shopify-ai-ops-agent/
├── DOCUMENTATION.md # Full technical documentation (ASD-STE100)
├── architecture_diagram.pdf # 2-slide landscape architecture diagram
├── docker-compose.yml # Postgres (pgvector) + Redis + Jaeger + API
├── pyproject.toml # Dependencies & packaging
├── app/
│ ├── api/ # FastAPI routes (agent, approvals, health)
│ ├── agent/ # LangGraph state machine & specialized nodes
│ ├── mcp_servers/ # 5 Stateless MCP tool servers
│ ├── core/ # Security (HMAC-SHA256), Idempotency, Database
│ ├── rag/ # Hybrid Vector + BM25 search & brand guidelines
│ ├── static/ # Executive SaaS Cockpit UI & Command Palette
│ └── evals/ # Golden datasets & Critic Agent audit
└── tests/ # 28 automated unit, safety, and integration tests🚀 Schnellstart & Setup
1. Lokale Entwicklung
# Install dependencies
pip install -r requirements.txt
# Start the application server & dashboard
python -m uvicorn app.api.main:app --reload --port 8000Dashboard-UI:
http://localhost:8000/(Drücken SieCtrl + Kfür die Befehlspalette)Interaktive API-Dokumentation:
http://localhost:8000/docsArchitektur-PDF:
http://localhost:8000/architecture.pdf
🧪 Verifizierung & Evaluierungen
# Run full automated test suite (28 tests)
python -m pytest tests/ -v
# Run independent Critic Agent technical audit
python -m app.evals.judge_agentTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Multi-tenant MCP gateway for AI commerce. One connection, every store.
Multi-tenant MCP gateway for AI commerce. One connection, every store.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.-
- AlicenseNot gradedqualityCmaintenanceA comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.19 npm20MIT
- FlicenseNot gradedqualityDmaintenanceHosted MCP server connecting Shopify, Klaviyo, GA4, Meta Ads, Google Ads, Xero, Gorgias and 20+ e-commerce data sources so AI assistants can answer merchant questions that span every source at once.-
- AlicenseNot gradedqualityCmaintenanceMCP server for e-commerce operations including product catalog management, cart/checkout, and Stripe integration, with built-in EU AI Act compliance.71 PyPIMIT