关于 market
Vistoya MCP 是跨已索引商店进行时尚商品与品牌语义发现的服务。它为兼容 MCP 的 Agent 提供排序搜索结果、相似项查询、商品详情和可用筛选条件。
主要功能
- 01跨商店语义搜索商品
- 02按商品属性筛选
- 03查找相似商品
- 04搜索并比较品牌
- 05获取商品详情和筛选项
适用场景
- 01按风格、颜色或价格找服饰
- 02按审美或产地探索品牌
- 03查找与某商品相似的商品
- 04获取选定商品的详情
MCP 相关
通过 Streamable HTTP MCP 端点提供时尚商品和品牌搜索工具。MCP 客户端可发现和筛选商品、查找相似商品或品牌,并获取商品详情。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.vistoya.com/mcpclaude mcp add --transport http vistoya-market https://api.vistoya.com/mcp{"mcpServers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}在 Cursor 中打开{"servers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}{"mcpServers":{"vistoya-market":{"serverUrl":"https://api.vistoya.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
6| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码。当响应显示还有下一页时递增。首先返回 Vistoya 结果;自有结果用尽后,后续页面可能会接着返回可选的外部目录结果。提供方故障不会导致常规发现失败。 |
| brand | string | 否 | 按品牌名称筛选 |
| limit | integer | 否 | 每页条目数(1–20,默认值为 12) |
| query | string | 否 | 自然语言搜索查询——描述越具体,结果越好。可包含带币种符号的价格(例如「white coat under 200 zł」),系统会自动解析。可选:省略时,结果将按下方结构化字段进行筛选,并按新近程度排序。可提供 query、结构化筛选条件或两者。 |
| colors | array | 否 | 按小写颜色筛选,例如:["black", "navy", "sage green"] |
| gender | enum | 否 | 性别筛选条件。women | men | unisex | boys | girls |
| season | enum | 否 | 季节筛选条件。软性描述——仅当用户明确提到季节时才设置。`query` 字段已从语义上涵盖季节;过度指定是导致搜索结果为零的最常见原因。spring | summer | fall | winter | all-season |
| styles | array | 否 | 风格筛选条件(OR 语义——产品的 `styles` 值只要有一个在此列表中即匹配)。传入单个值可按一种风格筛选("styles": ["minimalist"]);传入多个值可覆盖一组相关风格("styles": ["basics", "minimalist", "preppy", "sportswear"],用于 "Casual" 类别)。软性描述——仅当用户明确提到一种或多种风格时才设置。`query` 字段已从语义上涵盖风格;过度指定是导致搜索结果为零的最常见原因。 |
| country | string | 否 | 可选的购物者所在地,格式为 ISO-3166-1 alpha-2 国家/地区代码(例如 "US"、"GB"、"DE")。该信息会记录用于分析,并用于改进后续优惠的地理位置匹配。未知时请省略——不提供可保持当前行为。 |
| pattern | enum | 否 | 图案筛选条件(例如 solid、stripe、checked、floral)。软性描述——仅当用户明确提到图案时才设置。未指定时默认值("solid")会泄漏到查询中并清空候选集;不确定时请省略。solid | stripe | checked | floral | polka dot | camouflage | logo |
| sleeves | enum | 否 | 袖型筛选条件。软性描述——仅当用户明确提到袖型时才设置。不要根据类别或查询推断。sleeveless | short-sleeve | long-sleeve | three-quarter | cap-sleeve | puff | balloon | bishop | bell | dolman |
| category | string | 否 | 类别 slug,例如 "clothing"、"clothing/jackets"、"clothing/jackets/bomber-jackets"。如果末尾片段没有歧义,也接受快捷写法——例如,"loafers-and-slip-ons" 会解析为与 "shoes/loafers-and-slip-ons" 相同,而 "bomber-jackets" 会解析为与 "clothing/jackets/bomber-jackets" 相同。 |
| currency | string | 否 | min_price/max_price 使用的 ISO 4217 货币代码(例如 "PLN"、"EUR"、"GBP")。筛选时会将价格转换为 USD。USD 可省略。 |
| neckline | enum | 否 | 领口筛选。软性描述——仅当用户明确指定领口时才设置。不要根据类别或查询推断。v-neck | crewneck | scoop | square | halter | off-shoulder | one-shoulder | sweetheart | turtleneck | mock-neck | boat-neck | cowl | asymmetric | plunge | high-neck | collared | strapless |
| occasion | enum | 否 | 场合筛选。软性描述——仅当用户明确指定场合时才设置。`query` 字段已通过语义捕获场合;过度指定是导致零结果调用的最常见原因。casual | formal | business | party | outdoor | beach |
| materials | array | 否 | 按小写材质筛选:例如 ["cotton", "silk", "leather"] |
| max_price | number | 否 | 最高价格(使用 "currency" 参数指定的货币;若未指定,则使用 USD) |
| min_price | number | 否 | 最低价格(使用 "currency" 参数指定的货币;若未指定,则使用 USD) |
| silhouette | enum | 否 | 廓形/版型筛选(例如 fitted、slim、regular、relaxed、oversized)。软性描述——仅当用户明确指定版型时才设置。`query` 字段已通过语义捕获廓形;过度指定是导致零结果调用的最常见原因。fitted | slim | regular | relaxed | oversized | tailored | boxy |
| color_match | enum | 否 | 颜色匹配模式。"any"(默认):商品至少包含一种查询颜色。"exact":商品至少有一张图片的颜色仅为查询颜色——用于 "all black" 等单色搜索。any | exact |
| store_domain | string | 否 | 按店铺域名筛选(例如 "thereformation.com")。接受带协议、www、地区子域名或路径的形式——这些形式会经过规范化,以匹配已注册的店铺。 |
| exclude_colors | array | 否 | 排除包含以下颜色的商品:例如 ["white", "beige"] |
| is_sustainable | boolean | 否 | 当用户明确要求带有可持续性声明的商品时设为 true。 |
| available_sizes | array | 否 | 按可选尺码标签筛选,例如 ["s", "m", "38"]。 |
| exclude_materials | array | 否 | 排除包含以下材质的商品:例如 ["polyester", "nylon"] |
详细介绍
Vistoya MCP
在各大时尚商店中进行语义搜索和获取推荐,并以 Model Context Protocol 服务的形式提供。连接任何兼容 MCP 的 AI Agent(Claude、Cursor、VS Code、ChatGPT 等),即可在 Vistoya 市场中发现商品、查找视觉相似商品并探索商店。
- 注册表名称:
io.github.vistoya/market - 端点:
https://api.vistoya.com/mcp - 传输方式: Streamable HTTP
- 网站: https://vistoya.com
快速设置
npx @vistoya/mcp
自动检测并配置 Claude Desktop、Claude Code、Cursor、Windsurf 和 VS Code。运行后,请重启 AI 客户端。
功能
Vistoya 为各类商店的时尚商品建立索引,并使用视觉语言模型生成嵌入。MCP 服务允许 Agent 通过自然语言查询该索引,并对结果进行推理。
工具
| 工具 | 描述 |
|---|---|
discover_products | 在所有已建立索引的商店中进行语义搜索。接受自然语言查询和可选筛选条件(类别、颜色、性别、价格等),并返回排序后的商品。 |
find_similar_products | 根据商品 ID 返回视觉和语义上相似的商品。 |
discover_brands | 对品牌资料进行语义搜索。根据风格、来源地或美学特征查找品牌(例如“意大利街头服饰品牌”“斯堪的纳维亚极简主义品牌”)。 |
find_similar_brands | 根据品牌名称或键,使用品牌资料向量返回相似品牌。 |
get_product | 根据 ID 获取单件商品的完整详情。 |
get_filters | 列出可用的筛选值(类别、颜色、材质、品牌等),让 Agent 了解可筛选的内容。 |
手动安装
Claude Desktop / Claude Code
将以下内容添加到 claude_desktop_config.json(或 Claude Code MCP 配置):
{
"mcpServers": {
"vistoya": {
"url": "https://api.vistoya.com/mcp"
}
}
}
Cursor
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"vistoya": {
"url": "https://api.vistoya.com/mcp"
}
}
}
VS Code(MCP 扩展)
添加到你的 mcp.json:
{
"servers": {
"vistoya": {
"type": "http",
"url": "https://api.vistoya.com/mcp"
}
}
}
通用 stdio 后备方案(尚不支持远程连接的客户端)
使用 mcp-remote 作为桥接工具:
{
"mcpServers": {
"vistoya": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.vistoya.com/mcp"]
}
}
}
示例提示词
连接后,可以尝试:
- “帮我找一件 300 美元以下的黑色皮夹克”
- “给我看看与这件商品相似的款式”
- “你们有哪些适合秋季的舒适毛衣?”
- “帮我找 100 美元以下的跑步短裤”
发现方式
此服务已发布在官方 MCP Registry 中。你可以在此处找到:
https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.vistoya/market
状态
公开预览版。该端点可公开访问,目前无需身份验证。
许可证
MIT — 参见 LICENSE。
联系方式
问题和功能请求:在此代码库中提交 issue。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。