核心用法
Untappd MCP 是一个深度整合全球知名啤酒评分社交平台 Untappd 的个人代理工具，允许用户通过自然语言查询和操作自己的 Untappd 账户。
信息检索：支持搜索啤酒（untappd_search_beer）、酒厂（untappd_search_brewery）和饮酒场所（untappd_search_venue），获取详细信息；可查看任意公开用户的个人资料、历史打卡记录、愿望清单、获得徽章、好友列表等。
社交互动：提供写操作功能，包括发布啤酒打卡（untappd_checkin，支持0-5星评分、文字评论、定位场所）、为好友打卡点赞（untappd_toast）和留言评论（untappd_add_comment）。所有写操作均采用"确认门控"设计——首次调用仅返回预览，需显式设置 confirm: true 才会真正执行，避免误操作。
智能缓存系统：针对 Untappd API 无法高效回答"用户是否喝过某款啤酒"的局限，内置 SQLite 本地缓存机制。通过 untappd_sync_user_beers 和 untappd_sync_checkins 分页同步历史数据后，可用 untappd_cache_has_had、untappd_top_not_had 等工具瞬间查询，无需重复调用 API。特别适合场景：面对酒单快速筛选"还没喝过的高分款"。
显著优点
- 功能完整性：覆盖读、写、缓存三大维度，是个人用户在 Untappd 生态中最全面的自动化工具
- 防误设计：写操作强制二次确认，降低社交尴尬风险
- 本地缓存优化：解决平台 API 设计缺陷，使历史查询从"不可能任务"变为毫秒级响应
- 数据新鲜度透明：每次缓存查询返回
freshness元数据，明确告知数据完整度，避免假阴性
潜在缺点与局限
- 密钥获取门槛高：必须使用
UNTAPPD_CLIENT_ID和UNTAPPD_CLIENT_SECRET，而官方不公开提供；需用户自行拦截 iPad 应用流量提取，技术门槛高且可能违反平台服务条款 - 非官方集成：基于逆向工程的内置移动 API（v4），稳定性无保障，存在被平台封禁风险
- 写操作范围受限：暂不支持照片上传、愿望清单增删等功能
- 他人数据受限：非好友用户的完整历史打卡无法同步（API 仅返回约50条）
- 隐私风险：需明文存储账户密码于环境变量，且所有打卡、评论均发布至公开社交动态
适合人群
- Untappd 重度用户，希望高效管理个人饮酒记录与社交互动
- 啤酒爱好者，常需在酒吧快速查询酒款评分或筛选未尝试酒款
- 数据导向型用户，希望分析个人饮酒历史（搭配缓存查询工具）
常规风险
- 账户安全风险：凭证以明文环境变量存储，若部署环境不安全可能导致账号被盗
- 平台封禁风险：非官方 API 使用可能触发 Untappd 的反爬虫机制
- 社交风险：确认门控虽防误发，但二次确认机制若被绕过或滥用，仍可能发布不当内容至公开动态
- 数据准确性风险：缓存数据依赖手动同步，若未及时更新，"未喝过"结论可能为假阴性