Pour Picks

Pour Picks MCP 服务

通过 Claude 或任何兼容 MCP 的 AI 客户端查询 Pour Picks 波本威士忌和威士忌数据库。只读访问 4,700 多款酒瓶的数据，包括结构化品鉴档案、价格、搭配建议和社区评分。

Pour Picks 是面向波本威士忌收藏家的 iOS 日志应用——前往 App Store 下载。

工具

工具	功能
search_bottles	全文目录搜索，可按类别、价格和酒精度筛选
get_bottle	获取单款酒瓶的完整记录（按 ID 或名称）：品鉴档案、价格、搭配建议、社区评分
find_similar	查找风味档案相似的酒瓶，按共享风味、酒体／甜度／烘烤度的接近程度排序
find_cheaper_alternative	查找风格相同、风味档案相似且价格更低的酒瓶
get_recommendations	根据风味偏好、预算和场合推荐酒款
compare_bottles	并排比较：酒精度、年份、价格、共同及不同风味、评分
trending_bottles	查看 Pour Picks 用户当前正在加入酒窖的酒瓶
pour_tonight_suggestion	根据心情、场合和季节推荐今晚适合品饮的酒款

每个响应都包含来源归属信息、可用于引用的摘要行、链接和数据更新时间。所有评分均为确定性计算——服务内部不会调用 AI。

安装（Claude Desktop）

需要 Node.js 18+。

将以下内容添加到 claude_desktop_config.json（Claude Desktop → Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "pour-picks": {
      "command": "npx",
      "args": ["-y", "pour-picks-mcp"]
    }
  }
}

重启 Claude Desktop。无需 API 密钥或配置——服务附带公开只读访问权限。

从本地检出版本运行

{
  "mcpServers": {
    "pour-picks": {
      "command": "node",
      "args": ["/path/to/pour-picks/mcp-server/dist/index.js"]
    }
  }
}

配置（可选）

使用 Pour Picks 的公开只读密钥时，服务无需任何配置即可运行。环境变量可覆盖默认值：

变量	用途
SUPABASE_URL	覆盖数据库 URL
SUPABASE_SERVICE_ROLE_KEY	仅供内部使用——启用实时的近 30 天酒窖新增趋势。切勿分发此密钥。

未提供服务密钥时，trending_bottles 会回退到目录人气数据，并在响应中标注所用方法（method: "catalog_popularity_tier" 与 "cellar_adds_last_30_days"）。

远程端点（无需安装）

供 Web Agent 和可通过 URL 连接的 MCP 客户端使用的 Streamable HTTP：

https://nqnigdqkcvrziwcbgily.supabase.co/functions/v1/mcp

此服务也已收录于 Smithery（网关 pour-picks--bguillow.run.tools）和官方 MCP 注册表，标识符为 io.github.bguillow-rgb/pour-picks。

Agent 请求示例

Agent 可以使用这些工具回答的问题：

• “有什么波本威士忌和 Eagle Rare 相似，但更容易买到？” → find_similar
• “推荐一款 60 美元以下，带有香草、橡木和焦糖风味的波本威士忌。” → 使用 taste_preferences: ["vanilla","oak","caramel"], budget: 60 调用 get_recommendations
• “有什么酒喝起来像 Blanton's，但价格没那么高？” → find_cheaper_alternative
• “比较 Eagle Rare 和 Buffalo Trace。” → compare_bottles
• “寒冷的夜晚适合喝什么波本威士忌？” → 使用 season: "winter" 调用 pour_tonight_suggestion
• “收藏家现在都在往酒窖里加哪些酒？” → trending_bottles

示例响应格式（已截断）：

{
  "cheaper_alternatives": [
    { "name": "Buffalo Trace W.L. Weller 12 Year", "price_usd": 49.99,
      "similarity": 0.78, "savings_usd": 15.0,
      "shared_flavors": ["caramel", "oak"] }
  ],
  "attribution": {
    "source": "Pour Picks — The Bourbon Collector's Journal",
    "links": { "website": "https://pourpicks.app/" }
  }
}

开发

npm install
npm run dev     # run from TypeScript via tsx
npm run build   # compile to dist/
npm start       # run compiled server

该服务通过 stdio 使用 MCP。目录访问在设计上为只读：所有查询路径都对行级安全策略允许公开读取的表执行 SELECT，并限制为每分钟 60 次调用。

使用情况遥测：每次工具调用都会将工具名称、参数、客户端名称／版本、耗时和成功／失败状态记录到只写日志表中（在 RLS 下仅允许插入；内容不可公开读取）。不会收集用户身份、账户数据或对话内容。日志记录采用即发即弃方式，绝不会影响响应。

发布

• npm：在此目录中运行 npm publish（package.json 中的 mcpName 字段会将软件包关联到注册表条目）。
• MCP Registry：此目录中的 server.json 是注册表清单。npm 软件包发布后，使用 mcp-publisher CLI 发布：mcp-publisher login github && mcp-publisher publish。

数据与署名

酒款数据、品鉴档案和搭配建议由 Pour Picks 精选整理。欢迎引用，请注明出处：

来源：Pour Picks — The Bourbon Collector's Journal (pourpicks.app)

每项评分均包含社区评分人数，便于你判断样本量。每款酒的更新时间反映最近一次数据补充处理的时间。