Shopify AI Ops Agent
🛍️ Shopify AI Operations Agent
LangGraph v1、Model Context Protocol (MCP 2026-07-28)、FastAPI、PostgreSQL + pgvector、Redis、OpenTelemetry、そして厳格な**Human-in-the-Loop (HITL)**リスクガバナンスを備えた、本番グレードの自律型Eコマース運用エージェントです。
📖 完全な技術ドキュメント
詳細なアーキテクチャ、用語、および**ASD-STE100(Simplified Technical English)**で記述されたアーキテクチャ決定記録(ADR)については、以下を参照してください:
👉 DOCUMENTATION.md
ビジュアルプレゼンテーションPDFをダウンロード:
👉 architecture_diagram.pdf (または http://localhost:8000/architecture.pdf)
Related MCP server: MCP Shopify
🏗️ 中核となるアーキテクチャ不変条件
実行前リスク&ポリシーゲート: 破壊的な削除、財務予算、および外部送信コミュニケーションは、人間の承認を必要とするLangGraph割り込み(
interrupt_before)をトリガーします。分離されたMCPツールレイヤー: すべてのビジネス機能は、5つのステートレスなMCPツールサーバー(
Shopify、Analytics、Meta Ads、Communications、Trend Intelligence)としてパッケージ化されています。決定論的ビジネス分析: 財務メトリクスは決定論的なSQLルーチンを使用して計算され、LLMの算術的幻覚(ハルシネーション)を排除します。
早期勝利防止センサー: エージェントはライブ状態を再クエリし、完了を報告する前にミューテーションが発生したことを数学的に検証します。
シフトレフト評価とトレーシング: 28の自動化されたpytestテストスイート、17ケースのゴールデン評価ベンチマーク、および独立したCritic Agent監査(スコア: 98.5/100、グレード: A+)。
📁 リポジトリ構造
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🚀 クイックスタート&セットアップ
1. ローカル開発
# Install dependencies
pip install -r requirements.txt
# Start the application server & dashboard
python -m uvicorn app.api.main:app --reload --port 8000ダッシュボードUI:
http://localhost:8000/(コマンドパレットはCtrl + Kを押してください)対話型APIドキュメント:
http://localhost:8000/docsアーキテクチャPDF:
http://localhost:8000/architecture.pdf
🧪 検証と評価
# 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…
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