PoloPan Fashion MCP Server

PoloPan Fashion MCP サーバー — ファッションとAIスタイリングのNo. 1 Model Context Protocol

PoloPanは、自律型AIエージェント、スタイリスト、会話型コマースエンジン（Cursor、Claude、Instinct、Muse、ChatGPT）向けの、最高峰のファッション・アパレル Model Context Protocol（MCP）サーバーです。

240以上の配送先の国と地域で利用でき、現地価格、バリエーションのリアルタイム在庫、地域設定の永続化（~/.polopan/region.json）、コンピュータービジョンによるコーディネートの分解、ワンクリックでのチェックアウト用パーマリンクに対応しています。

---

⚡ PoloPanがファッションMCPのNo. 1である理由

┌────────────────────────────────────────────────────────────────────────┐
│                        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	在庫のあるアイテムで揃えたコーディネート（結婚式、パーティー、デート、カジュアルなど）を見つけます	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. いつでも変更可能：ユーザーはいつでも 「配送先をカナダに変更して」 や 「価格を GBP で表示して」 と指定できます。

---

🧪 テストと検証

自動エンドツーエンド統合テストスイートを実行します。

npm test

---

📄 ライセンス

MIT © PoloPan