核心用法
Untappd MCP 是一个专为精酿啤酒爱好者设计的 Model Context Protocol 工具，通过调用 Untappd 移动端 API 实现全功能的啤酒社交体验。用户可通过自然语言查询啤酒评分、探索酒厂与酒吧信息、浏览他人酒单与打卡记录，同时支持在个人账号下发布打卡、点赞（Toast）和评论。工具分为只读与写入两类：只读工具涵盖啤酒/酒厂/场所搜索、用户信息、好友动态、愿望清单等；写入工具采用"确认门控"设计，默认返回预览而不实际执行，需显式设置 confirm: true 才会发布内容，有效防止误操作。
显著优点
1. 智能缓存机制：内置 SQLite 本地缓存（或远程 Durable Object），解决 Untappd API 无法直接回答"用户是否喝过某款酒"的性能瓶颈。通过 untappd_sync_checkins 增量同步历史记录，后续查询无需 API 调用即可瞬时响应，支持菜单交叉比对、新品筛选等高频场景。
2. 精细化权限控制：写入操作强制二次确认，兼顾自动化便利与社交安全。
3. 完整的社交图谱：覆盖好友动态流、点赞、评论等核心互动，满足深度用户需求。
4. 灵活的查询能力：缓存查询支持按酒厂、风格、评分、场所、日期等多维度筛选与排序。
潜在缺点与局限性
- 非官方集成：需通过抓包获取移动端的
CLIENT_ID和CLIENT_SECRET，违反 Untappd 服务条款，存在账号封禁风险。 - 同步成本：历史数据回灌需多次调用，新用户或大量打卡者首次同步耗时较长。
- 功能缺口：暂不支持照片上传、愿望清单增删操作。
- 隐私边界：同步他人数据需对方账号公开或互为好友，且受限于 API 的 friends-only 策略。
适合人群
精酿啤酒爱好者、Untappd 重度用户、酒吧/酒类行业从业者（菜单策划、选品参考），以及希望将啤酒数据整合到个人工作流的技术型用户。
常规风险
- 账号安全风险：凭据存储于本地环境变量，若共享机器需确保文件权限安全。
- API 稳定性风险：非官方端点可能随 App 更新失效。
- 数据准确性风险：缓存数据存在时效性，
freshness与caveat字段提示用户注意"未找到"可能是假阴性。