核心用法
resy-mcp 是一个MCP服务器,让用户通过自然语言与Resy餐厅预订平台交互。它封装了Resy网页应用的私有API,支持完整预订生命周期管理:搜索餐厅、查看可订时段、直接预订、管理收藏夹(Hit List)以及设置Priority Notify候补通知。
典型工作流:
- 预订指定餐厅:
resy_search_venues查找venue_id →resy_book执行预订(支持desired_time近似匹配) - 探索附近空位:提供lat/lng坐标搜索特定日期可用餐厅
- 取消预订:
resy_list_reservations获取resy_token →resy_cancel执行取消 - 难订餐厅监控:
resy_add_notify设置时段通知,Resy邮件提醒放位
显著优点
- 自然语言交互:用日常对话完成复杂预订操作,降低使用门槛
- 功能完整:覆盖搜索、预订、取消、收藏、候补通知全链路
- 智能容错:
resy_book自动刷新短时效config_token,支持时间近似匹配 - 地理位置灵活:默认纽约坐标,支持任意城市经纬度
- Token自动管理:惰性登录+自动重登机制,无需手动处理会话
潜在缺点与局限性
- 非官方API:使用Resy私有网页端点,存在随时失效风险;作者明确标注"Use at your own discretion"
- 功能边界依赖逆向工程:收藏夹和Priority Notify路径为逆向所得,可能因Resy更新而404
- 地域限制:默认纽约坐标,其他城市需显式提供坐标
- 支付强依赖:必须先在resy.com绑定支付方式,否则预订失败
- 无实时推送:候补通知通过Resy邮件,非MCP实时回调
适合人群
- 高频Resy用户,希望通过对话快速完成预订管理
- 追求热门餐厅(如Carbone、4 Charles Prime Rib)的食客,需自动化监控放位
- 已熟悉MCP生态,愿意承担非官方API风险的早期采用者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 账号安全 | 需明文存储Resy邮箱密码于环境变量,存在泄露风险 |
| API稳定性 | 私有端点无SLA保障,Resy可随时封禁或变更 |
| 预订冲突 | config_token分钟级过期,高并发场景可能竞争失败 |
| 合规灰色地带 | 违反Resy服务条款潜在风险,长期可用性存疑 |