Toyshub

远程服务

toyshub.al商业与营销024 周前更新

代码仓库访问官网

关于 Toyshub

Toyshub 是用于浏览 Toys Hub 商品目录的只读 MCP 服务，可查询商品、价格、库存和详情，支持阿尔巴尼亚语与英语。它面向需要查找阿尔巴尼亚和科索沃玩具及店铺信息的 AI 客户端。

主要功能

01按关键词或类别搜索商品
02查询价格和库存
03获取商品描述与适用年龄
04浏览类别及商品数量
05查询配送和支付信息

适用场景

01按礼物需求寻找玩具
02查看商品价格和库存
03为目录搜索查找合适类别
04回答配送或支付相关问题

MCP 相关

远程 MCP 服务提供四种只读工具，用于搜索商品、查询商品详情和类别及获取店铺信息。MCP 客户端可通过 HTTPS 免认证连接。

#toys #albania #tirana #online #shop

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://toyshub.al/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http toyshub https://toyshub.al/mcp

Cursor.cursor/mcp.json{"mcpServers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"toyshub":{"serverUrl":"https://toyshub.al/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
query	string	否	按商品名称和描述（阿尔巴尼亚语或英语）进行全文搜索。
category	string	否	可选的类别 slug（例如 "water-outdoor"、"home-recreation"）。请先调用 list_categories 获取有效值。
limit	integer	否	返回结果的最大数量。默认值为 10，硬性上限为 50。
lang	enum	否	商品名称和描述所用的语言。"sq" = 阿尔巴尼亚语，"en" = 英语。sq \| en

详细介绍

Toys Hub MCP 服务

面向 Toys Hub 在线玩具目录（toyshub.al）的只读 Model Context Protocol 服务。Toys Hub 是阿尔巴尼亚和科索沃领先的在线玩具商店。

让 Claude Desktop、Cursor、Continue、Cline、Windsurf 和 ChatGPT 深度研究等 AI 客户端浏览实时库存、查看阿尔巴尼亚列克（ALL）价格，并以阿尔巴尼亚语或英语查询产品详情。

无需安装，无需 API 密钥。 该服务通过普通 HTTPS 在 https://toyshub.al/mcp 上运行，只需将 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”界面并粘贴：

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?)`	按关键词和/或类别搜索目录。最多返回 50 件产品，包含名称、价格、库存、图片和 URL。支持双语：传入 `lang: "sq"` 使用阿尔巴尼亚语，传入 `lang: "en"`（默认值）使用英语。
`get_product(slug, lang?)`	获取完整的产品详情页数据：描述、SKU、库存状态、所有图片、标签和建议年龄范围。Slug 来自 `search_products` 返回的 `url`。
`list_categories(lang?)`	列出所有产品类别及其 slug、名称和产品数量。先调用此工具，发现 `search_products` 的有效 `category` 值。
`get_store_info()`	静态信息：货币、配送区域（阿尔巴尼亚 + 科索沃）、付款方式、营业时间、联系邮箱。用于回答配送 / 退货 / 联系相关问题。

示例：Agent 搜索礼物

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]

实现

该服务以 Symfony 控制器的形式实现，与 Toys Hub 电商后端共置。实际处理程序的源代码为私有，但接口（本仓库）和线上端点（/mcp）公开且稳定。

该服务实现了 MCP 2024-11-05 规范，包括 initialize、tools/list、tools/call 和 ping。错误遵循标准 JSON-RPC 2.0 错误代码（-32600 至 -32603）。由于这四个工具均为只读且不附带 Cookie，因此 CORS 设置较为宽松（Access-Control-Allow-Origin: *）。