Skip to main content
Glama
Redser06

Merchant Web MCP

by Redser06

Merchant Web MCP — 에이전트 분석 및 운용성 프로토타입

모든 전자상거래 스토어프론트를 AI 쇼핑 에이전트를 위한 관찰 가능하고, 측정 가능하며, 거래 가능한 플랫폼으로 전환하세요.

Build & Test Protocol Spec License


[!NOTE] 프로토타입 및 시뮬레이션 고지: 이 저장소는 제안된 BigCommerce / Merchant Web MCP 플러그인 아키텍처의 대화형 시뮬레이션 콕핏 및 프로토타입을 포함합니다. 시뮬레이션 엔진은 클라이언트 측에서 실행되며, 시뮬레이션된 지연 시간, 실제 Web Crypto HMAC-SHA256 서명, 실제 15분 TTL 재고 예약 타이머, 그리고 경영진용 에이전트 의도 분석 대시보드를 제공합니다.


🎯 핵심 문제 및 가치 제안

단기적 현실: 에이전트 트래픽에 대한 맹점

오늘날 판매자들은 AI 쇼핑 에이전트(ChatGPT Agent, Claude, Perplexity, Apple Intelligence)에 대해 알지 못합니다. 봇이 제품 페이지를 스크레이핑할 때:

  • 트래픽은 단순 웹 스크레이퍼와 구분할 수 없습니다.

  • 시각적 스크레이핑은 페이지당 6,000–10,000 토큰을 소비하며 React hydration 또는 DOM 재설계 시 자주 실패합니다.

  • 판매자들은 에이전트가 어떤 제품을 검색하는지, 어떤 쿼리가 실패하는지, 어떤 상업적 수요가 포착되지 않은 채 지나가는지에 대해 전혀 가시성이 없습니다.

해결책: BigCommerce Merchant Web MCP

  1. 에이전트 의도 분석(즉각적인 SaaS 가치): 유입되는 에이전트 세션, 도구 실행, 발견된 의도 가치(£124k+ 파이프라인), 공급자별 분석, 카탈로그 수요 격차를 포착합니다.

  2. 결정적 MCP 인터페이스: 구조화된 JSON-RPC 도구(search_products, get_product_details, check_variant_stock, apply_promotions, add_to_cart_session, create_checkout_session)를 노출합니다.

  3. 검증된 암호화 핸드오프: 15분 임시 재고 소프트락과 함께 실제 Web Crypto HMAC-SHA256 토큰을 사용하여 서명된 체크아웃 URL을 생성합니다.


Related MCP server: Shopify Agentic MCP Gateway

🏗️ 아키텍처 개요

┌────────────────────────────────────────────────────────┐
│                   AI Shopping Agent                    │
│             (Claude / ChatGPT / Perplexity)            │
└───────────────────────────┬────────────────────────────┘
                            │ (1) Discover: /.well-known/mcp.json
                            │ (2) Transport: HTTP / SSE Stream
                            ▼
┌────────────────────────────────────────────────────────┐
│             Merchant Web MCP Plugin Engine             │
│  ┌──────────────────────────────────────────────────┐  │
│  │ Layered Security Guard (Unicode Filter & Regex)  │  │
│  └────────────────────────┬─────────────────────────┘  │
│                           │                             │
│  ┌────────────────────────▼─────────────────────────┐  │
│  │ Standardized MCP Tools:                          │  │
│  │  • search_products(query, max_price, waterproof) │  │
│  │  • check_variant_stock(variant_id, postal_code)  │  │
│  │  • apply_promotions(promo_code, subtotal)        │  │
│  │  • add_to_cart_session(variant_id, qty) [15m TTL]│  │
│  │  • create_checkout_session (WebCrypto HMAC SHA256│  │
│  │  • get_store_policies()                          │  │
│  └────────────────────────┬─────────────────────────┘  │
└───────────────────────────┼────────────────────────────┘
                            │
            ┌───────────────┴───────────────┐
            ▼                               ▼
┌───────────────────────┐       ┌───────────────────────┐
│ Merchant Catalog / DB │       │ Storefront Cart & DOM │
│ (BigCommerce / D1)    │       │ (Live State Sync)     │
└───────────────────────┘       └───────────────────────┘

🚀 콕핏 및 테스트 실행

빠른 시작

# 1. Install dependencies
bun install

# 2. Run test suite (7 tests, 27 assertions)
bun test

# 3. Start development server
bun run dev

실시간 배포


🛡️ 이 저장소의 보안 및 무결성 주요 사항

  • 실제 Web Crypto HMAC-SHA256: 표준 crypto.subtle를 사용하여 src/mcp/cryptoAuth.ts에 구현되었습니다. 서명은 체크아웃 세션 생성 시 암호화 방식으로 검증됩니다.

  • 활성 TTL 재고 만료: src/mcp/merchantMcpEngine.ts에 구현되었습니다. 임시 예약은 900초(15분) 후 만료되어 재고를 자동으로 사용 가능한 재고로 반환하고 클라이언트 와이어 HUD에 알립니다.

  • 계층형 심층 방어: src/mcp/securityGuard.ts에 구현되었습니다. 유니코드/제로 폭 난독화를 정규화하고 고객 리뷰, 검색 쿼리, 프로모션 인수를 검사합니다.

  • 다중 카트 격리: 엔진은 cart_id로 카트를 명시적으로 매핑하여 잘못되거나 외부 카트 세션에 대한 체크아웃 시도를 거부합니다.


🗺️ 로드맵 및 프로덕션 사양

대상 Cloudflare Worker + BigCommerce 엣지 서버 사양은 ROADMAP.md를 참조하세요.

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

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 Servers

View all related MCP servers

Related MCP Connectors

  • Commission infrastructure for AI commerce — program discovery, attribution, and settlement.

  • Agent-native commerce with trusted catalog, durable carts, and Stripe Checkout via MCP and UCP.

  • Agent-native product catalog for AI shopping agents. 296M+ products, 28 countries.

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/Redser06/merchant-web-mcp'

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