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 个 token,并且经常因 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. 可验证的密码学交接: 使用真实的 Web Crypto HMAC-SHA256 令牌生成带签名的结账 URL,并带有 15 分钟临时库存软锁。


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:src/mcp/cryptoAuth.ts 中使用标准 crypto.subtle 实现。生成结账会话时会以密码学方式验证签名。

  • 主动 TTL 库存过期:src/mcp/merchantMcpEngine.ts 中实现。临时预留会在 900 秒(15 分钟)后过期,自动将库存返还至可用库存,并通知客户端 wire HUD。

  • 分层纵深防御:src/mcp/securityGuard.ts 中实现。对 Unicode/零宽混淆进行规范化,并跨客户评论、搜索查询和促销参数进行扫描。

  • 多购物车隔离: 引擎按 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