Perfume Picks MCP 是一个 MCP（Model Context Protocol）服务器，用于让 AI 助手查询 Perfume Picks 香水数据库。它从 Claude 或任何兼容 MCP 的 AI 客户端提供对 13,000+ 款香水的只读访问，数据包括完整的香调金字塔、香调类别（accords）、精选平替（dupes）以及社区穿着数据。
用途 该服务面向需要香水信息检索的 AI 工作流，可让 AI 助手回答关于香水相似性、平替、推荐、成分组合和穿着建议的问题。
主要能力
- 查询 13,000+ 款香水，包含香调金字塔、香调类别、精选平替和社区穿着数据。
- 支持的工具能力包括：查找平替（find_dupes，带匹配百分比）、获取推荐（get_recommendations，可按场合或偏好香调筛选）、查找相似香水（find_similar）、获取今晚穿着建议（what_to_wear_tonight，基于社区称赞数据评分）、比较香水（compare_fragrances）等。
- 所有评分均为确定性算法，服务端不进行任何 AI 调用。
- 所有工具均标注为只读/幂等。
- 每个响应包含来源署名、可引用的摘要行、链接和数据更新日期。
使用方式
- 安装：需要 Node.js 18+。在 Claude Desktop 配置文件中添加相关配置（Claude Desktop → Settings → Developer → Edit Config），然后重启 Claude Desktop。无需 API 密钥或额外配置，服务器自带公开只读访问。
- 可选配置：可通过环境变量覆盖默认值（仅显式环境变量，该包从不读取 .env 文件）。若没有服务密钥，trending_fragrances 回退到目录流行度，并在响应中标注该方法。
- 远程端点：提供 Streamable HTTP，适用于 Web 智能体和接受 URL 的 MCP 客户端，无需安装。该服务也在 Smithery 和官方 MCP 注册表（io.github.bguillow-rgb/perfume-picks）中列出。
- 通信方式：服务器通过 stdio 使用 MCP 协议。目录访问在构造上就是只读的：每个查询路径对行级安全下公开可读的表执行 SELECT，并限速为每分钟 60 次调用。
适用场景
- 寻找类似某款香水的替代品，例如“What smells like Baccarat Rouge 540 without the price tag?” 返回精选平替及匹配百分比。
- 按场合或香调组合推荐香水，例如“Recommend a fragrance for a summer wedding.” 或“What fragrances have bergamot, vanilla, and amber?”。
- 查找与指定香水相似的产品，例如“What perfume is similar to Bleu de Chanel?”。
- 获取约会等场景的穿着建议，例如“What should I wear on a date tonight?”，依据社区称赞数据评分。
- 比较两款香水，例如“Compare Sauvage and Bleu de Chanel.”。
限制与数据说明
- 服务为只读，不提供写入或修改功能。
- 速率限制为每分钟 60 次调用。
- 使用遥测：每次工具调用记录工具名、参数、客户端名称/版本、耗时和成功/失败到只写日志表（在 RLS 下仅插入；内容不公开可读；90 天后清除）。不收集用户身份、账户数据或对话内容。日志记录为即发即忘，不影响响应。
- 香水数据、香调金字塔、平替匹配和社区评分由 Perfume Picks 策划。可自由引用并注明来源：“Source: Perfume Picks — Fragrance DNA & Collection Journal (perfumepicks.app)”。
- 每款香水的更新日期反映最后一次数据更新时间。
- Perfume Picks 是 iOS 端香氛 DNA 与收藏日志应用，可在 App Store 获取。
