Toyshub

Toys Hub MCP サーバー

アルバニアとコソボを代表するオンライン玩具店であるToys Hubのオンライン玩具カタログ（toyshub.al）向けの、読み取り専用のModel Context Protocolサーバーです。

Claude Desktop、Cursor、Continue、Cline、Windsurf、ChatGPT deep-research などのAIクライアントから、最新の在庫を閲覧したり、アルバニア・レク（ALL）での価格を確認したり、アルバニア語または英語で商品詳細を調べたりできます。

インストール不要、APIキー不要です。 サーバーは https://toyshub.al/mcp で通常のHTTPS経由で動作します。MCPクライアントにURLを指定するだけです。

---

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "toyshub": {
      "url": "https://toyshub.al/mcp"
    }
  }
}

Claude Desktopを再起動します。メッセージボックスの横に🔌インジケーターが表示されます。

Cursor / Continue / Cline / Windsurf

ほとんどのMCP対応IDEは、同じURL形式の設定を使用できます。クライアントの「Add MCP server」UIを開き、次の内容を貼り付けてください。

https://toyshub.al/mcp

トランスポート：HTTP（POST JSON-RPC 2.0）。認証は不要です。

ターミナルからの簡単なテスト

curl -X POST https://toyshub.al/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

---

ツール

ツール	説明
search_products(query, category?, limit?, lang?)	キーワードやカテゴリでカタログを検索します。名前、価格、在庫、画像、URLを含む商品を最大50件返します。lang: "sq"を指定するとアルバニア語、lang: "en"（デフォルト）を指定すると英語で利用できます。
get_product(slug, lang?)	商品詳細ページの全データを取得します。説明、SKU、在庫状況、すべての画像、タグ、推奨年齢層が含まれます。スラッグはsearch_productsが返すurlから取得できます。
list_categories(lang?)	すべての商品カテゴリと、それぞれのスラッグ、名前、商品数を返します。最初に呼び出すと、search_productsで有効なcategoryの値を確認できます。
get_store_info()	通貨、配送地域（アルバニア＋コソボ）、支払い方法、営業時間、連絡先メールアドレスなどの固定情報を返します。配送、返品、問い合わせに関する質問に使用してください。

例：贈り物を探すエージェント

User: "Find a magnetic building toy for a 6-year-old, under 7000 lek"

Agent calls search_products(query: "magnetic", limit: 5)
  → 3 results with prices 2,800 / 6,600 / 7,200 ALL
Agent calls get_product(slug: "magnetic-blocks-129pcs", lang: "en")
  → ageMin: 3, ageMax: 10, price: 6,600 — fits the brief.

Agent replies: "Magnetic blocks 129pcs at 6,600 ALL fits perfectly — 
ages 3-10, in stock. https://toyshub.al/products/magnetic-blocks-129pcs"

---

Toys Hubについて

• ウェブサイト：toyshub.al
• 配送地域：アルバニアとコソボ
• 通貨：アルバニア・レク（ALL）
• 支払い方法：代金引換、クレジットカード／デビットカード
• 言語：アルバニア語（sq）、英語（en）
• 連絡先：[email protected]

実装

このサーバーは、Toys HubのECバックエンドと同じ場所に配置されたSymfonyコントローラーとして実装されています。実際のハンドラーのソースは非公開ですが、インターフェース（このリポジトリ）と稼働中のエンドポイント（/mcp）は公開されており、安定しています。

initialize、tools/list、tools/call、pingを含むMCP 2024-11-05仕様に準拠しています。エラーには標準のJSON-RPC 2.0エラーコード（-32600から-32603まで）を使用します。4つのツールはすべて読み取り専用で、Cookieも送信されないため、CORSは制限なし（Access-Control-Allow-Origin: *）です。

ライセンス

MIT