Swervie

Swervie MCP 服务

面向 AI Agent，跨所有零售商为每款产品提供一个评分答案。
远程 MCP 服务 · Streamable HTTP · 无需身份验证 · 无需 API 密钥 · 免费

开发者文档 · 工具参考 · 连接客户端 · 响应格式 · 数据处理

---

https://us-central1-swervie-prod.cloudfunctions.net/mcp

Swervie 是一个为助手打造的跨零售商产品目录。提出普通的购物问题，即可获得每款产品一个整合评分答案：实时价格、可比较的规格、基于评价得出的评分及原文证据引述，以及每个卖家的购买链接。无需面对八条重复商品信息和过时的榜单文章。

• 整合。 同一款产品在不同零售商的商品信息会合并为一行。不同品牌销售的白牌仿制品也会归为一组。
• 结构化。 每个类别都有自己的规格模式；规格从制造商页面、零售商商品信息和规格表中提取，并附有来源信息。
• 评分。 每款产品都有质量评分和价值评分，以及由真实评价引述佐证的细分评分。
• 确定且精简。 服务路径中不使用大模型。答案由预先计算的流水线生成：约 4k 个 token，完整商品列表的响应时间不到一秒。
• 可在支持 MCP Apps 的宿主中交互。 结果以商品列表呈现，提供排序控件、按卖家区分的优惠和评价证据（io.modelcontextprotocol/ui 扩展）；其他场景则一律返回纯 JSON。

目前覆盖范围：300 多个类别，从扫地机器人和电视到意式浓缩咖啡机、床垫和徒步靴，涉及数百家卖家。实时列表见 swervie.xyz/llms.txt。

快速开始

Claude Code

claude mcp add --transport http swervie https://us-central1-swervie-prod.cloudfunctions.net/mcp

Cursor、Windsurf、VS Code、Claude Desktop、ChatGPT、Gemini CLI 等： 请参阅 docs/clients.md。所有配置都只需一行，即上面的 URL，无需请求头或密钥。

curl

MCP=https://us-central1-swervie-prod.cloudfunctions.net/mcp
H=(-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream')

# Handshake: server info, capabilities, agent instructions
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# A whole shopping answer in one call
curl -s -X POST $MCP "${H[@]}" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"65 inch OLED TV under $1500","limit":3}}}'

更多示例见 examples/：使用官方 SDK 的 Node 客户端、Python 客户端，以及上面的 curl 脚本。

工具

工具	类型	功能
search_products	读取	一步完成查询。将自由文本查询解析为指定产品、“A 与 B”比较，或带筛选条件和排序偏好的类别商品列表。返回 interpretation 回执。
lookup_product	读取	按名称、ASIN、UPC/EAN/GTIN 或品牌 + 型号查询单款产品。提供完整详情、所有卖家报价，以及该产品在所属商品列表中的排名。
find_category	读取	返回匹配的类别及其筛选条件说明：每项可筛选规格的类型、单位、允许值和重要性，以及价格区间。
browse_category	读取	返回类别的排序商品列表，支持明确筛选条件（硬性条件）和偏好（软性条件），并可按价值、质量或价格排序。
get_products	读取	获取最多 25 个 ID 的完整详情：所有规格及来源信息、带证据引述的评价细分评分，以及所有报价。

每个工具均为只读并带有注解（title、readOnlyHint: true、 openWorldHint: true），因此宿主可在无需确认提示的情况下调用。 该服务只提供数据：不会代替用户写入任何内容，其指令和结果也都不会指示模型。根据在线服务生成的完整输入模式和说明，见 docs/tools.md。

典型对话

1. “帮我找一台低于 1,500 美元的 65 英寸 OLED 电视” → search_products → 按排名排列的商品列表 包含价格、购买链接和佣金披露。
2. “这些商品中哪款更适合玩游戏？” → get_products → 刷新率、VRR、 HDMI 2.1，以及评测者对输入延迟的评价。
3. “Sony A95L 有没有哪个地方卖得更便宜？” → lookup_product → 所有卖家的报价， 以及它在商品列表中的排名和得分更高的替代商品。

服务会在 initialize 时提供 instructions，其中说明了各个工具及其结果所包含的字段，因此客户端无需设计提示词。

用户签名（可选，不含个人身份信息）

每个工具都接受可选的 user_signature：一个不透明、稳定且匿名化的 ID，可为每位购物者分配独立的速率限制配额（而非按会话或出口 IP 共用配额），并归因其对购买链接的点击。推荐的生成方式：

user_signature = "sv1-" + sha256hex("swervie/v1|" + id).slice(0, 24)

其中，id 是用户最稳定的标识符，经过规范化处理（转为小写、去除首尾空格；优先使用电子邮件，并去掉 + 标签）。切勿发送原始标识符。如果没有可用标识符，请使用 "sv1r-" + 一个为该用户保留的 UUID，或省略此字段。每个会话都变化的值会被视为每个会话中的新购物者。如果误传了原始电子邮件或电话号码，服务会在存储任何内容之前对其进行哈希处理。

限制、联盟链接和隐私

• 速率限制。 匿名级别：每个客户端（签名、会话或 IP）每分钟 60 次请求、每天 2,000 次请求；共享 Agent 平台出口 IP 的上限会相应提高。平台可使用独立配额的合作伙伴密钥：请联系 [email protected]。
• 购买链接属于联盟链接。 每个包含 buy_url 的响应也包含一段面向购物者的 disclosure 文本。佣金绝不会影响排名、得分或展示的商品。
• 无需账户，不提供结账或支付。 购买操作会跳转至零售商自己的页面。
• 存储内容。 每次调用的工具名称、查询、类别和商品 ID、存在时的签名，以及速率限制计数器。不会存储用户拥有的任何内容，也不会存储代表用户撰写的任何内容。

详情见 docs/data-handling.md。相关政策： 隐私 · 条款 · 披露。

本仓库包含的内容

本仓库是 Swervie MCP 服务的公开主页：包含文档、注册清单（server.json）、客户端配置、示例和供目录使用的品牌素材。服务代码运行在 Swervie 主单体仓库中的 Google Cloud Function 上，不在此处发布。托管端点是受支持的使用方式。欢迎提交问题和功能请求。

服务版本通过 initialize 报告（serverInfo.version）。协议版本为 2025-06-18。传输方式：Streamable HTTP，无状态。

变更：v1.6.0（2026-10）移除了两个非破坏性写入工具（record_selection、submit_feedback），并将服务说明和结果备注改写为对数据的描述；现在服务从头到尾均为只读。

许可证

本仓库中的文档、示例和素材采用 MIT 许可证（© Plum Applications, Inc.）。托管服务的使用受条款约束。