Skip to main content
Glama
Redser06

Merchant Web MCP

by Redser06

Merchant Web MCP — エージェント分析・運用性プロトタイプ

あらゆるeコマースストアを、AIショッピングエージェントにとって観測可能・測定可能・取引可能なプラットフォームへと変えます。

Build & Test Protocol Spec License


[!NOTE] プロトタイプ&シミュレーションに関するお知らせ: このリポジトリには、提案中のBigCommerce / Merchant Web MCPプラグインアーキテクチャのインタラクティブなシミュレーションコックピットとプロトタイプが含まれています。シミュレーションエンジンはクライアントサイドで動作し、シミュレートされたレイテンシ、本物のWeb Crypto HMAC-SHA256署名、実際の15分TTL在庫予約タイマー、そしてエグゼクティブ向けのエージェント意図分析ダッシュボードを備えています。


🎯 中核となる課題と価値提案

短期的な現実:エージェントトラフィックへの盲点

現在、マーチャントはAIショッピングエージェント(ChatGPT Agent、Claude、Perplexity、Apple Intelligence)に対して盲目です。ボットが商品ページをスクレイピングするとき:

  • トラフィックは単純なWebスクレイパーと区別がつきません。

  • ビジュアルスクレイピングは1ページあたり6,000〜10,000トークンを消費し、ReactのハイドレーションやDOMの再設計で頻繁に壊れます。

  • マーチャントには、エージェントがどの商品を検索しているか、どのクエリが失敗するか、どのような商業需要が捕捉されずに素通りしているかについて、まったく可視性がありません

ソリューション:BigCommerce Merchant Web MCP

  1. エージェント意図分析(すぐに得られるSaaS価値): 入ってくるエージェントセッション、ツール実行、検出された意図価値(£124k以上のパイプライン)、プロバイダー別内訳、カタログ需要ギャップを捕捉します。

  2. 決定論的MCPインターフェース: 構造化されたJSON-RPCツール(search_productsget_product_detailscheck_variant_stockapply_promotionsadd_to_cart_sessioncreate_checkout_session)を公開します。

  3. 暗号学的に検証されたハンドオフ: 本物のWeb Crypto HMAC-SHA256トークンを使用して、15分間の一時的在庫ソフトロックを伴う署名済みチェックアウト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に通知します。

  • 多層防御(Defense-in-Depth): 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