ShopOps MCP

Shopify 및 WooCommerce 스토어 관리를 위한 모델 컨텍스트 프로토콜(MCP)을 구현하는 AI 기반 서버입니다.

주요 기능

Shopify 및 WooCommerce용 스토어 커넥터.
재고, 가격, 고객, 주문, 제품 성과 및 보고서를 다루는 11개의 MCP 도구.
스토어 개요, 재고, 최근 주문 및 상위 고객을 노출하는 4개의 MCP 리소스.
이동 평균 수요와 안전 재고 계산을 사용한 재고 예측.
RFM 기반 고객 세분화 (7개의 개별 세그먼트).
AI 기반 가격 분석 및 최적화.
주문 이상/사기 탐지.
제품 성과에 대한 ABC 분석.
일일 및 주간 자동 보고서.
이중 전송: 로컬 stdio 및 Streamable HTTP (MCPize).
TypeScript, @modelcontextprotocol/sdk v1.29+, Zod v4 지원.
무료 티어 및 $25, $45 유료 플랜 제공.

빠른 시작

# 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

서버가 환경 변수를 읽고, 구성된 스토어에 연결하며, MCP 도구와 리소스를 노출합니다.

MCP 도구

도구	설명
`store_connect`	Shopify 또는 WooCommerce 스토어에 대한 연결을 설정하고 자격 증명을 검증합니다.
`inventory_status`	현재 재고 수준, 백오더 플래그 및 재고 부족 알림을 반환합니다.
`inventory_forecast`	이동 평균 수요와 안전 재고 버퍼를 사용하여 향후 재고 요구 사항을 예측합니다.
`pricing_analyze`	가격 탄력성 보고서를 생성하고 가격이 낮거나 높게 책정된 SKU를 식별합니다.
`pricing_optimize`	AI 기반 수요 예측 및 경쟁사 데이터를 바탕으로 최적의 가격대를 제안합니다.
`customers_segment`	RFM 분석을 수행하고 고객을 7개 세그먼트 중 하나로 할당합니다.
`customers_churn`	고객의 이탈 위험을 점수화하고 유지 전략을 제안합니다.
`order_anomalies`	패턴 인식 모델을 사용하여 잠재적인 사기 또는 오류 주문을 탐지합니다.
`product_performance`	ABC 분석을 수행하고 제품 등급별 기여도 지표를 반환합니다.
`report_daily`	일일 운영 요약(판매, 재고, 알림)을 JSON/CSV 형식으로 생성합니다.
`report_weekly`	추세 시각화가 포함된 주간 성과 보고서를 생성합니다.

MCP 리소스

리소스	설명
`store://overview`	총 매출, 주문, 고객 및 매출 총이익과 같은 상위 수준의 스토어 지표입니다.
`store://inventory`	보유 수량, 예약 재고 및 예상 부족분을 포함한 전체 재고 카탈로그입니다.
`store://orders/recent`	상태, 총 가치 및 결제 수단이 포함된 최근 주문 100개 목록입니다.
`store://customers/top`	평생 가치, 구매 빈도 및 최근성을 기준으로 순위가 매겨진 상위 50명의 고객입니다.

구성

프로젝트 루트에 .env 파일을 생성하세요. 다음 변수가 필요합니다:

변수	필수 대상	설명
`SHOPIFY_API_KEY`	Shopify	프라이빗 앱 API 키.
`SHOPIFY_API_PASSWORD`	Shopify	프라이빗 앱 비밀번호.
`SHOPIFY_STORE_DOMAIN`	Shopify	스토어 도메인 (예: `myshop.myshopify.com`).
`WOOCOMMERCE_CONSUMER_KEY`	WooCommerce	REST API 소비자 키.
`WOOCOMMERCE_CONSUMER_SECRET`	WooCommerce	REST API 소비자 비밀번호.
`WOOCOMMERCE_STORE_URL`	WooCommerce	스토어 URL (예: `https://example.com`).
`MCP_PORT`	HTTP 전송	Streamable HTTP 엔드포인트용 포트 (기본값 `8080`).
`MCP_LOG_LEVEL`	전체	로깅 상세 수준 (`error`, `warn`, `info`, `debug`).
`MCP_PRICING_MODEL`	가격 도구	가격 모델 선택 (`basic`, `advanced`).
`MCP_FORECAST_WINDOW_DAYS`	재고 예측	예측할 일수 (기본값 `30`).

선택적 변수:

변수	설명
`MCP_ENABLE_ANONYMIZATION`	`true`로 설정하면 보고서에서 개인 식별 데이터가 마스킹됩니다.
`MCP_REPORT_S3_BUCKET`	제공된 경우, 일일/주간 보고서가 지정된 S3 버킷에 업로드됩니다.

라이선스

ShopOps MCP는 MIT 라이선스 하에 배포됩니다. 전체 약관은 LICENSE를 참조하세요.

작성자: Automatia BCN

shopops-mcp

ShopOps MCP

주요 기능

빠른 시작

MCP 도구

MCP 리소스

구성

라이선스

Resources

Latest Blog Posts

MCP directory API