Pour Picks MCP Server 是一个 MCP（Model Context Protocol）服务器，为 AI 助手提供对 Pour Picks 波本与威士忌数据库的只读目录访问。它允许 Claude 或任何兼容 MCP 的 AI 客户端查询超过 4700 款酒瓶的结构化品鉴档案、价格、搭配建议和社区评分。
主要能力包括：
- 查询酒瓶信息：品鉴档案、价格、搭配、社区评分。
- 相似酒款查找（find_similar）：例如“什么波本类似 Eagle Rare 但更容易买到？”
- 推荐（get_recommendations）：支持口味偏好和预算，例如“推荐 60 美元以下、有香草、橡木和焦糖风味的波本。”
- 更便宜替代品（find_cheaper_alternative）：例如“什么酒尝起来像 Blanton's 但价格更低？”
- 对比酒瓶（compare_bottles）：例如“对比 Eagle Rare 和 Buffalo Trace。”
- 今晚倒酒建议（pour_tonight_suggestion）：支持季节参数，例如“寒冷夜晚该倒什么波本？”
- 趋势酒瓶（trending_bottles）：例如“收藏家们现在在添加哪些酒瓶？”
使用方式：
- 安装（Claude Desktop）：需要 Node.js 18+。将配置添加到 claude_desktop_config.json（Claude Desktop → Settings → Developer → Edit Config），然后重启 Claude Desktop。无需 API 密钥或配置，服务器自带公开只读访问。
- 本地检出运行：可从本地代码库运行。
- 可选配置：服务器默认使用 Pour Picks 公开只读密钥，环境变量可覆盖默认值。若没有服务密钥，trending_bottles 会回退到目录流行度，并在响应中标注方法（method: "catalog_popularity_tier" 对比 "cellar_adds_last_30_days"）。
- 远程端点（无需安装）：支持 Streamable HTTP，适用于 Web 代理和接受 URL 的 MCP 客户端。也列在 Smithery（网关 pour-picks--bguillow.run.tools）和官方 MCP 注册表（io.github.bguillow-rgb/pour-picks）。
技术细节：
- 服务器通过 stdio 使用 MCP 协议。
- 目录访问在构造上为只读：每个查询路径对行级安全下公开可读的表执行 SELECT，并限制为每分钟 60 次调用。
- 使用遥测：每次工具调用记录工具名称、参数、客户端名称/版本、时长和成功/失败到只写日志表（RLS 下仅插入；内容不公开可读）。不收集用户身份、账户数据或对话内容。日志记录为即发即忘，不影响响应。
- 发布：npm 发布（package.json 中的 mcpName 字段将包链接到注册表条目）。MCP 注册表：server.json 是注册表清单，npm 包上线后使用 mcp-publisher CLI 发布：mcp-publisher login github && mcp-publisher publish。
数据与归属：
- 酒瓶数据、品鉴档案和搭配由 Pour Picks 策划。引用时请注明：Source: Pour Picks — The Bourbon Collector's Journal (pourpicks.app)。
- 每个评分都包含社区评分计数，以便判断样本大小。每瓶的新鲜度日期反映最后一次丰富化处理。
适用场景：
- 波本和威士忌爱好者、收藏家通过 AI 助手查询酒款信息、获取推荐、比较酒瓶、寻找替代品。
- 开发者将 Pour Picks 数据库集成到 MCP 兼容的 AI 客户端中。
限制：
- 只读访问，不能修改数据库。
- 速率限制为每分钟 60 次调用。
- 需要 Node.js 18+ 用于本地安装。
- 无服务密钥时 trending_bottles 功能受限。
