mcpField
M
market

market

远程服务
github.com/vistoya搜索与检索05 周前更新
代码仓库

关于 market

Vistoya MCP 是跨已索引商店进行时尚商品与品牌语义发现的服务。它为兼容 MCP 的 Agent 提供排序搜索结果、相似项查询、商品详情和可用筛选条件。

主要功能

  1. 01跨商店语义搜索商品
  2. 02按商品属性筛选
  3. 03查找相似商品
  4. 04搜索并比较品牌
  5. 05获取商品详情和筛选项

适用场景

  1. 01按风格、颜色或价格找服饰
  2. 02按审美或产地探索品牌
  3. 03查找与某商品相似的商品
  4. 04获取选定商品的详情

MCP 相关

通过 Streamable HTTP MCP 端点提供时尚商品和品牌搜索工具。MCP 客户端可发现和筛选商品、查找相似商品或品牌,并获取商品详情。

配置

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

服务地址https://api.vistoya.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

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

工具

6
参数类型必填说明
pageinteger否页码。当响应显示还有下一页时递增。首先返回 Vistoya 结果;自有结果用尽后,后续页面可能会接着返回可选的外部目录结果。提供方故障不会导致常规发现失败。
brandstring否按品牌名称筛选
limitinteger否每页条目数(1–20,默认值为 12)
querystring否自然语言搜索查询——描述越具体,结果越好。可包含带币种符号的价格(例如「white coat under 200 zł」),系统会自动解析。可选:省略时,结果将按下方结构化字段进行筛选,并按新近程度排序。可提供 query、结构化筛选条件或两者。
colorsarray否按小写颜色筛选,例如:["black", "navy", "sage green"]
genderenum否性别筛选条件。women | men | unisex | boys | girls
seasonenum否季节筛选条件。软性描述——仅当用户明确提到季节时才设置。`query` 字段已从语义上涵盖季节;过度指定是导致搜索结果为零的最常见原因。spring | summer | fall | winter | all-season
stylesarray否风格筛选条件(OR 语义——产品的 `styles` 值只要有一个在此列表中即匹配)。传入单个值可按一种风格筛选("styles": ["minimalist"]);传入多个值可覆盖一组相关风格("styles": ["basics", "minimalist", "preppy", "sportswear"],用于 "Casual" 类别)。软性描述——仅当用户明确提到一种或多种风格时才设置。`query` 字段已从语义上涵盖风格;过度指定是导致搜索结果为零的最常见原因。
countrystring否可选的购物者所在地,格式为 ISO-3166-1 alpha-2 国家/地区代码(例如 "US"、"GB"、"DE")。该信息会记录用于分析,并用于改进后续优惠的地理位置匹配。未知时请省略——不提供可保持当前行为。
patternenum否图案筛选条件(例如 solid、stripe、checked、floral)。软性描述——仅当用户明确提到图案时才设置。未指定时默认值("solid")会泄漏到查询中并清空候选集;不确定时请省略。solid | stripe | checked | floral | polka dot | camouflage | logo
sleevesenum否袖型筛选条件。软性描述——仅当用户明确提到袖型时才设置。不要根据类别或查询推断。sleeveless | short-sleeve | long-sleeve | three-quarter | cap-sleeve | puff | balloon | bishop | bell | dolman
categorystring否类别 slug,例如 "clothing"、"clothing/jackets"、"clothing/jackets/bomber-jackets"。如果末尾片段没有歧义,也接受快捷写法——例如,"loafers-and-slip-ons" 会解析为与 "shoes/loafers-and-slip-ons" 相同,而 "bomber-jackets" 会解析为与 "clothing/jackets/bomber-jackets" 相同。
currencystring否min_price/max_price 使用的 ISO 4217 货币代码(例如 "PLN"、"EUR"、"GBP")。筛选时会将价格转换为 USD。USD 可省略。
necklineenum否领口筛选。软性描述——仅当用户明确指定领口时才设置。不要根据类别或查询推断。v-neck | crewneck | scoop | square | halter | off-shoulder | one-shoulder | sweetheart | turtleneck | mock-neck | boat-neck | cowl | asymmetric | plunge | high-neck | collared | strapless
occasionenum否场合筛选。软性描述——仅当用户明确指定场合时才设置。`query` 字段已通过语义捕获场合;过度指定是导致零结果调用的最常见原因。casual | formal | business | party | outdoor | beach
materialsarray否按小写材质筛选:例如 ["cotton", "silk", "leather"]
max_pricenumber否最高价格(使用 "currency" 参数指定的货币;若未指定,则使用 USD)
min_pricenumber否最低价格(使用 "currency" 参数指定的货币;若未指定,则使用 USD)
silhouetteenum否廓形/版型筛选(例如 fitted、slim、regular、relaxed、oversized)。软性描述——仅当用户明确指定版型时才设置。`query` 字段已通过语义捕获廓形;过度指定是导致零结果调用的最常见原因。fitted | slim | regular | relaxed | oversized | tailored | boxy
color_matchenum否颜色匹配模式。"any"(默认):商品至少包含一种查询颜色。"exact":商品至少有一张图片的颜色仅为查询颜色——用于 "all black" 等单色搜索。any | exact
store_domainstring否按店铺域名筛选(例如 "thereformation.com")。接受带协议、www、地区子域名或路径的形式——这些形式会经过规范化,以匹配已注册的店铺。
exclude_colorsarray否排除包含以下颜色的商品:例如 ["white", "beige"]
is_sustainableboolean否当用户明确要求带有可持续性声明的商品时设为 true。
available_sizesarray否按可选尺码标签筛选,例如 ["s", "m", "38"]。
exclude_materialsarray否排除包含以下材质的商品:例如 ["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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。