AisleNode Local Commerce (Meta Muse & Claude MCP)

muse-commerce-mcp

开源的模型上下文协议（MCP）桥接工具，将 Meta Muse、Llama 和 Anthropic Claude Agent 连接到实时的社区零售店货架。

---

为什么要开发这个项目

自主 AI 购物 Agent（Meta Muse、Claude、Llama）可以搜索全球电商巨头，但社区实体店对它们而言仍然隐形。传统本地商店负担不起昂贵的 POS 集成，也不愿向外卖平台支付 30% 的佣金。

muse-commerce-mcp 通过 AisleNode 协议，将对话式 AI Agent 直接连接到经过验证的本地零售库存：

• 实时地理围栏发现：使用 Haversine GPS 半径筛选，在经过实地审核的社区商店中查询有货商品。
• 零个人身份信息的 Agent 预订：Agent 可预订商品并生成安全的结账跳转链接，无需在大模型上下文中处理购物者的敏感信用卡信息或家庭地址。
• 100% 非托管式直接结算：购物者通过 Stripe 或 PayPal 直接向商家付款。协议绝不接触或汇集商家收入。
• 即时柜台通知与配送调度：订单实时响铃通知商家的柜台 Web 终端，并生成热敏调度单，其中嵌入了供本地自行车配送员使用的 Google Maps GPS 二维码。

---

架构

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

将 muse-commerce-mcp 添加到 Agent 配置文件（claude_desktop_config.json 或 Meta Muse MCP 配置）：

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

2. Streamable HTTP 端点（官方 MCP 注册表与远程 Agent）

直接连接到托管的 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。大模型无需获取购物者个人身份信息。	store_id、items（[{ product_id, qty }]）
check_order_status	实时查询订单付款、打包和配送调度状态。	order_id
report_store	针对虚假库存、欺骗性定价或错误坐标进行自动化信任与安全举报。	store_id、category、details

---

Agent 提示词示例

连接后，可使用自然语言查询测试你的 Agent：

• “搜索纬度 40.756、经度 -73.988 周边 10km 内的本地商店，查找阿拉比卡咖啡豆。”
• “从那家商店订购 1 袋阿拉比卡咖啡豆，并把结账链接发给我。”
• “查询订单 [order_id] 的履行状态。”

---

接入实体零售店

你是商家，或正在测试完整的实体柜台端到端工作流吗？

1. 访问 aislenode.soltrixstudios.com
2. 使用 Google 登录，标记实体店铺的 GPS 坐标，并上传 CSV 商品目录。
3. 验证通过后，所有运行 muse-commerce-mcp 的 Agent 都能立即发现你的货架。

---

许可证

MIT License。由 Soltrix Studios 构建并维护。