Estroni Storefront

Estroni Storefront — MCP 服务

面向 Estroni 店铺的只读 Model Context Protocol 服务，提供澳大利亚美利奴羊毛和低毒性女装运动服。

让 AI Agent（Claude、ChatGPT、Cursor、Copilot 等）能够搜索商品目录、获取商品详情、列出系列，并读取配送／退货政策。专为 由 Agent 驱动的商品发现与调研打造，不支持结账——根据政策，Estroni 的结账流程仅供人工操作。

• 注册表名称： io.github.estroni/storefront
• 传输方式： Streamable HTTP（MCP 协议 2025-06-18）
• 端点： https://mcp.estroni.com.au/mcp
• 运行时： Cloudflare Workers
• 源代码： github.com/estroni/storefront-mcp

---

工具

工具	返回内容
search_products	最多返回 10 条与关键词查询匹配的商品摘要（标题、澳元价格、图片、库存情况、URL）
get_product	根据 URL handle 获取完整商品详情——款式、价格、SKU、描述 HTML、图片
list_collections	列出所有公开系列及其标题、handle、URL 和商品数量
get_policies	配送／退款／隐私／条款 URL，以及机器人／Agent 政策文本

这四种工具均为只读。它们封装了 Shopify 公开的店铺 JSON 端点——调用 Agent 无需身份验证。

---

安装

Claude Desktop / Cursor / Claude Code

添加到 MCP 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，或 Cursor 中的 mcp.json）：

{
  "mcpServers": {
    "estroni-storefront": {
      "url": "https://mcp.estroni.com.au/mcp"
    }
  }
}

重启客户端。四种工具将显示在 estroni-storefront 服务下。

ChatGPT / Anthropic Claude.ai（自定义连接器）

设置 → 连接器 → 添加自定义连接器 → 粘贴 https://mcp.estroni.com.au/mcp。

在终端中测试

# initialize
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# list tools
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# call search_products
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"merino"}}}'

---

Agent 提示词示例

“帮我在 Estroni 找一件售价低于 150 澳元的长袖美利奴羊毛打底衫。” → 调用 search_products({query: "merino long sleeve base layer"})，筛选并汇总结果。

“Estroni 的退货期限是多久？” → 调用 get_policies()，提供退款政策 URL 和一行摘要。

“展示 ‘Merino activewear’ 系列中所有有货的商品。” → list_collections() → 对每个 handle 调用 get_product() → 根据 variants[].available 筛选。

---

机器人和 Agent 政策

Estroni 欢迎 Agent 以只读方式访问，用于搜索商品目录、调研商品和获取政策。

端到端的“代我购买”Agent若在没有最终人工审核步骤的情况下完成付款，不允许在 Estroni.com.au 上使用。

推荐购买商品的 Agent 必须在继续结账前，提供配送和退款政策 URL（由 get_policies 返回），供人工审核。

另请参阅：estroni.com.au/robots.txt — Content-Signal: search=yes, ai-input=no, ai-train=no。

---

开发

git clone https://github.com/estroni/storefront-mcp.git
cd storefront-mcp
npm install
npm run dev          # wrangler dev — local Worker on http://localhost:8787
npm run typecheck    # tsc --noEmit
npm run deploy       # wrangler deploy → estroni-mcp.workers.dev

MCP 线路协议采用手动实现（官方 @modelcontextprotocol/sdk 仅提供 Node 专用传输方式；Workers 需要自行实现）。实现刻意保持精简——src/index.ts 中约 300 行代码。

---

许可证

MIT — 详见 LICENSE。

由 Estroni 构建 · 联系方式：[email protected]