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) 리스크 거버넌스를 기반으로 구축된 프로덕션급 자율 전자상거래 운영 에이전트입니다.

📖 전체 기술 문서

심층 아키텍처, 용어, 그리고 **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. Shift-Left 평가 및 추적: 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