AisleNode Local Commerce (Meta Muse & Claude MCP)

muse-commerce-mcp

Meta Muse、Llama、Anthropic Claude のエージェントを、近隣の実店舗の棚にある商品情報へ接続するオープンソースの Model Context Protocol（MCP）ブリッジです。

---

このプロジェクトの目的

自律型 AI ショッピングエージェント（Meta Muse、Claude、Llama）は、世界規模の大手 E コマース企業の商品を検索できますが、近隣の実店舗は検索対象になっていません。従来型の地域店舗には、高額な POS 連携を導入する余裕も、デリバリーマーケットプレイスに 30％の手数料を支払う余裕もありません。

muse-commerce-mcp は、AisleNode Protocol を通じて、会話型 AI エージェントを検証済みの地域店舗の在庫に直接接続します。

• リアルタイムのジオフェンス検索：ハーバーサイン GPS 半径フィルタリングを使用して、現地監査済みの近隣店舗にある在庫商品を検索します。
• 個人情報を一切扱わないエージェントによる予約：エージェントが商品を予約し、安全なチェックアウト引き継ぎリンクを生成します。LLM のコンテキスト内で、買い物客の機密性の高いクレジットカード情報や自宅住所を扱う必要はありません。
• 100％非カストディアルの直接決済：買い物客は Stripe または PayPal を通じて販売者に直接支払います。このプロトコルが販売者の収益に触れたり、プールしたりすることはありません。
• カウンターへの即時通知と配達員の手配：注文が販売者のカウンターにあるウェブ端末にリアルタイムで通知され、近隣の自転車配達員向けに、Google Maps GPS QR コードを埋め込んだ感熱紙の配達指示票が生成されます。

---

アーキテクチャ

sequenceDiagram
    participant Shopper
    participant Agent as Meta Muse / Claude Agent
    participant MCP as muse-commerce-mcp
    participant Hub as AisleNode Protocol
    participant Store as Local Merchant Counter

    Shopper->>Agent: "Find fresh Arabica coffee beans near me under $20"
    Agent->>MCP: search_catalog(query="coffee", lat=40.756, lng=-73.988)
    MCP->>Hub: POST /api/mcp (Haversine Radius Search)
    Hub-->>Agent: Returns verified in-stock items + distance (0.8 km)
    Shopper->>Agent: "Order 1 bag from Soltrix Store"
    Agent->>MCP: create_order(store_id, items=[{product_id, qty: 1}])
    Hub-->>Agent: Returns Zero-PII Checkout URL
    Shopper->>Store: Completes direct Stripe/PayPal payment & road-distance fee
    Store-->>Shopper: Prints GPS QR Courier Slip & dispatches local rider

---

クイックスタート

1. Meta Muse / Claude Desktop 向けに設定する

エージェントの設定ファイル（claude_desktop_config.json または Meta Muse の MCP 設定）に muse-commerce-mcp を追加します。

{
  "mcpServers": {
    "muse-commerce": {
      "command": "npx",
      "args": ["-y", "muse-commerce-mcp"]
    }
  }
}

2. Streamable HTTP エンドポイント（公式 MCP Registry とリモートエージェント向け）

ホストされている Streamable HTTP MCP サーバー（io.github.marvo-bd/muse-commerce-mcp）に直接接続します。

• Streamable HTTP / JSON-RPC エンドポイント：https://aislenode.soltrixstudios.com/api/mcp
• メソッド：POST

例：GPS 半径を指定して地域の在庫を検索する

curl -X POST https://aislenode.soltrixstudios.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "action": "search_catalog",
    "params": {
      "query": "coffee",
      "customer_lat": 40.756076,
      "customer_lng": -73.988407,
      "max_distance_km": 15
    }
  }'

---

利用可能な MCP ツール

ツール名	説明	必須入力
search_catalog	検証済みの実店舗にある在庫商品を、距離順に並べてリアルタイム検索します。	query（customer_lat、customer_lng、max_distance_km は任意）
create_order	在庫を確保し、販売者のチェックアウト URL を直接生成します。LLM から買い物客の個人情報を渡す必要はありません。	store_id、items（[{ product_id, qty }]）
check_order_status	注文の支払い、梱包、配達員の手配状況をリアルタイムで確認します。	order_id
report_store	在庫の虚偽表示、価格の不正表示、位置情報の誤りを自律的に報告し、安全性と信頼性の維持に役立てます。	store_id、category、details

---

エージェント向けプロンプトの例

接続したら、自然言語でエージェントに問い合わせて動作を確認できます。

• 「緯度 40.756、経度 -73.988 から 10km 以内の地域店舗で、アラビカコーヒー豆を検索してください。」
• 「その店舗からアラビカコーヒー豆を 1 袋注文して、チェックアウトリンクを教えてください。」
• 「注文 [order_id] の履行状況を確認してください。」

---

実店舗を登録する

販売者の方、またはカウンター業務を含む一連のワークフローを実店舗でテストしたい方へ。

1. aislenode.soltrixstudios.com にアクセスします。
2. Google でサインインし、実店舗の GPS 座標を地図上で指定して、CSV カタログをアップロードします。
3. 検証が完了すると、muse-commerce-mcp を実行するすべてのエージェントから、商品棚をすぐに検索できるようになります。

---

ライセンス

MITライセンス。Soltrix Studiosが開発・保守しています。