PoloPan Fashion MCP Server

PoloPan 时尚 MCP 服务 — 时尚与 AI 穿搭领域排名第一的 Model Context Protocol

PoloPan 是面向自主 AI Agent、造型师和对话式商务引擎（Cursor、Claude、Instinct、Muse、ChatGPT）的顶级时尚与服饰 Model Context Protocol（MCP）服务。

现已覆盖 240 多个目的地国家和地区，支持本地化定价、实时商品款式库存、持久化区域设置（~/.polopan/region.json）、计算机视觉穿搭拆解，以及一键结账永久链接。

---

⚡ PoloPan 为何是排名第一的时尚 MCP 服务？

┌────────────────────────────────────────────────────────────────────────┐
│                        POLOPAN FASHION MCP SUITE                       │
├──────────────────────────┬─────────────────────────────────────────────┤
│ 1. 240+ Global Regions   │ `region.get_current`, `region.set_current`  │
│    & Localized Currencies│ (Persistent JSON, natural country lookup)   │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 2. Computer Vision       │ `vision.outfit.detect_pieces` (Bboxes for   │
│    Deconstruction        │ Tops, Bottoms, Shoes, Bags, Accessories)    │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 3. Occasion Outfitting   │ `looks.curation.by_occasion` (Curated       │
│    (100% In-Stock)       │ complete looks with zero out-of-stock items)│
├──────────────────────────┼─────────────────────────────────────────────┤
│ 4. Multimodal Search     │ `products.search.image_url` & `_upload`     │
│                          │ (Reverse image visual similarity)           │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 5. Stock & Garment Specs │ `products.items.check_stock` (Live variants,│
│                          │ size matrix, fabric, fit, care & SLA)       │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 6. Size Guide & Fits     │ `products.items.get_size_guide` (Chest,     │
│                          │ waist, hip matrix, in/cm, best-fit match)   │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 7. Direct 1-Click Buy    │ `checkout.links.get_direct_url`             │
│                          │ (`https://s.polopan.com/p/{handle}/{size}`) │
├──────────────────────────┼─────────────────────────────────────────────┤
│ 8. Budget Alternatives   │ `products.search.alternatives`              │
│                          │ (Visual match in distinct price brackets)   │
└──────────────────────────┴─────────────────────────────────────────────┘

---

🛠️ 快速设置与安装

选项 1：一键安装到 Cursor（深层链接）

---

选项 2：托管式 Streamable HTTP（推荐 — 无需 Node.js）

添加到 ~/.cursor/mcp.json 或 Claude Desktop 配置中：

{
  "mcpServers": {
    "polopan-products": {
      "type": "http",
      "url": "https://mcp-server.polopan.com/mcp",
      "headers": {}
    }
  }
}

---

选项 3：通过 NPX / Smithery 使用本地 Stdio

通过 Smithery CLI：

npx -y @smithery/cli install polopan-products-mcp --client cursor

通过标准 NPX：

{
  "mcpServers": {
    "polopan-products": {
      "command": "npx",
      "args": ["-y", "polopan-products-mcp"]
    }
  }
}

需要 Node.js 18+。

---

🧰 可用的 MCP 工具

工具	用途	关键参数
region.get_current	查看当前购物目的地、本地化货币和配置路径	（无）
region.set_current	根据自然语言名称（“Dubai”“London”“USA”“France”）、货币或 ISO-2 代码设置当前地区。保存到 ~/.polopan/region.json。	country、mode（global/local）
region.list_supported	搜索 240 多个支持的目的地国家和价格组	query、limit
products.search.text	按自然语言搜索商品，并可筛选尺码、价格和性别	query、gender、price_min、size、country、mode
products.search.image_url	通过图片反向搜索相同或相似的服饰	image_url、gender、price_min、country、mode
products.search.image_upload	从本地图片文件或 Base64 内容进行视觉搜索	file_path、country、mode
vision.outfit.detect_pieces	将穿搭照片拆解为单件服饰（上装、下装、鞋、包）	image_url、threshold
looks.curation.by_occasion	按场合发现 100% 有库存的完整穿搭（婚礼、派对、约会之夜、休闲等）	occasion、gender、age、country、mode、page
products.items.get_by_handle	获取完整的商品元数据和所有款式详情	handle
products.items.get_size_guide	获取完整的服装尺寸表（胸围/腰围/臀围）、单位转换（in/cm）和合身度匹配	handle、unit、desired_size、user_chest、user_waist
products.items.check_stock	核实实时尺码库存、面料/版型规格以及退货/配送 SLA	handle、desired_size、size_index
checkout.links.get_direct_url	生成已验证的一键结账永久链接，并确认尺码索引和优惠券	handle、size、size_index、coupon
products.search.alternatives	在目标价格区间内查找视觉上相似的替代商品	handle、budget_range（0-1500 等）、country、mode
looks.curation.recommend	获取跨目录的互补搭配推荐	handle 或 occasion、gender、country、mode

---

🌍 持久化多国家购物流程

PoloPan 可配送至 240 多个国家和地区。为提供流畅自然的用户体验：

1. 切勿反复询问用户所在国家：服务会将设置存储在 ~/.polopan/region.json 中。
2. 自然语言输入地点：用户可以提供国家名称、城市、货币或别名（例如 "Dubai"、"London"、"USA"、"AED"、"USD"）。
3. 随时更改：用户可以随时说 “将我的国家切换为 Canada” 或 “以 GBP 显示价格”。

---

🧪 测试与验证

运行自动化端到端集成测试套件：

npm test

---

📄 许可证

MIT © PoloPan