核心功能
resy-mcp 是一款基于 MCP 协议的第三方 Resy 餐厅预订管理工具，通过逆向 Resy 网页应用的私有 API 实现自然语言交互。核心能力覆盖完整预订生命周期：
- 餐厅搜索：按日期、人数、地理位置、关键词搜索可用餐厅
- 座位预订：智能匹配最近时间段，自动处理支付授权
- 预订管理：查看、取消 upcoming/past 订单
- 收藏系统：维护个人"必吃清单"（Hit List）
- 优先通知：订阅难订餐厅的空位提醒（Priority Notify）
显著优点
1. 零官方 API 依赖：无需 Resy 开发者权限，直接使用公开 web-app key 和用户级邮箱密码认证
2. 自然语言工作流：支持"帮我订今晚 Carbone 两人位"等口语化指令
3. Token 自动管理：惰性登录 + 自动刷新机制，缓存会话 token 至进程结束
4. 复合操作简化：resy_book 内部自动完成查 slot→获取详情→下单的完整链路
5. 地理感知：内置 NYC 默认坐标，支持任意城市定位
潜在局限与风险
| 类别 | 说明 |
|------|------|
| **授权灰色地带** | 明确标注"Use at your own discretion"，Resy 可能随时封禁非官方客户端 |
| **Token 时效性** | Slot `config_token` 仅存活数分钟，无法跨调用缓存 |
| **端点稳定性** | Favorites/Notify 路径为逆向工程，存在 404 失效风险 |
| **支付前置要求** | 必须在 resy.com 网页端预存支付方式，否则预订失败 |
| **API Key 轮换** | 若 Resy 更新前端 bundle，需手动覆盖 `RESY_API_KEY` |
适合人群
- 频繁使用 Resy 预订的纽约/洛杉矶/芝加哥等美国城市食客
- 希望通过 AI 助手批量管理餐厅收藏和候补通知的"订位爱好者"
- 愿意承担非官方工具风险的早期技术采纳者
常规风险
- 账号安全：密码以明文环境变量存储，建议配合 MCP 服务器的密钥管理
- 预订失败：高峰期 slot 竞争激烈，自然语言指令可能因模糊时间导致非最优选择
- 服务中断：Resy 侧变更可导致工具瞬间失效，无 SLA 保障