核心功能
resy-mcp 是一款基于 MCP 协议的自然语言餐厅预订管理工具，专为 Resy 平台（美国主流高端餐厅预订服务）设计。用户可通过自然语言指令完成从搜索餐厅到完成预订的全流程，无需手动操作 Resy App 或网站。
主要能力
| 模块 | 功能 |
|------|------|
| **餐厅搜索** | 按日期、人数、地理位置、关键词搜索可用餐厅，返回带实时空位信息的 venue 列表 |
| **智能预订** | 一键订位，支持指定时间偏好（如"19:00 左右"），自动匹配最接近时段 |
| **订单管理** | 查看、取消 upcoming/past 预约，支持 `resy_token` 精准操作 |
| **收藏夹** | 管理"Hit List"收藏餐厅，快速访问常去餐厅 |
| **Priority Notify** | 订阅热门餐厅空位提醒，自动邮件通知（抢订难订餐厅的关键功能） |
显著优点
1. 自然语言交互："帮我订明晚 Carbone 两个人"即可触发完整预订流程
2. 全功能覆盖：搜索→订位→管理→提醒，覆盖 Resy 核心场景
3. 自动化抢位：resy_book 自动刷新 config_token，避免手动操作时 token 过期
4. 地理灵活：默认纽约，支持任意坐标定位
局限与风险
| 问题 | 说明 |
|------|------|
| **非官方 API** | 使用 Resy 私有 Web API，存在被封禁或接口变更风险 |
| **账号安全** | 需明文存储邮箱密码，建议专用账号/启用 2FA |
| **地域限制** | Resy 主要覆盖美国大城市，国际用户受限 |
| **支付依赖** | 需预存支付方式，工具本身不处理支付 |
| **Token 时效** | 搜索结果的 `config_token` 数分钟内失效，不能跨会话复用 |
适用人群
- 高频外食者：每周多次预订，需批量管理
- 难订餐厅追逐者：依赖 Priority Notify 抢订热门时段
- 效率优先用户：偏好自然语言替代 App 多点操作
- 商务/社交秘书：为他人批量安排餐厅
使用建议
建议先用 resy_search_venues 确认可用性，再用 resy_book 完成预订。对于热门餐厅，务必提前设置 Priority Notify。由于 API 非官方，建议监控 GitHub 仓库更新，及时应对 Resy 接口变更。