Skip to main content
Glama
deenesjakoruzh
Thebeardedambivert

Shopify AI Ops Agent

by Thebeardedambivert
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

🛍️ Shopify AI Operations Agent

Python 3.11+ FastAPI LangGraph License: MIT

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）

🏗️ 中核となるアーキテクチャ不変条件

  1. 実行前リスク＆ポリシーゲート: 破壊的な削除、財務予算、および外部送信コミュニケーションは、人間の承認を必要とするLangGraph割り込み（interrupt_before）をトリガーします。

  2. 分離されたMCPツールレイヤー: すべてのビジネス機能は、5つのステートレスなMCPツールサーバー（Shopify、Analytics、Meta Ads、Communications、Trend Intelligence）としてパッケージ化されています。

  3. 決定論的ビジネス分析: 財務メトリクスは決定論的なSQLルーチンを使用して計算され、LLMの算術的幻覚（ハルシネーション）を排除します。

  4. 早期勝利防止センサー: エージェントはライブ状態を再クエリし、完了を報告する前にミューテーションが発生したことを数学的に検証します。

  5. シフトレフト評価とトレーシング: 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_agent

This server cannot be installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • ListingGood MCP

    Get recommended by Amazon's AI. Hosted MCP server for Amazon listing compliance & generation.

  • DataDoe MCP

    Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

  • Presso

    Connect e-commerce and marketing data to AI assistants via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Thebeardedambivert/shopify-ai-ops-agent'

If you have feedback or need assistance with the MCP directory API, please join our Discord server