核心功能
zola-mcp 是一个 Model Context Protocol (MCP) 服务器，为 Zola 婚礼规划平台提供 27 个可直接调用的工具集，实现婚礼筹备全流程的自动化管理。
供应商管理（5 工具）：浏览、搜索、新增、修改及移除婚礼供应商，支持通过 search_storefronts 在市场中发现本地服务商。
宾客与 RSVP（4+3 工具）：完整的宾客群组管理，包括添加家庭单位、更新地址、追踪各活动的 RSVP 状态，并支持座位图表的自动化编排（list_seating_charts、assign_seat）。
财务与登记（2+2 工具）：预算明细追踪与单项更新，配合婚礼礼物登记册管理及致谢状态追踪。
沟通与发现（3+4 工具）：供应商询价对话管理（标记已读、获取完整聊天记录），以及婚礼仪表板概览与收藏夹功能。
显著优点
- 原生移动 API 直连：通过
mobile-api.zola.com调用官方未公开的移动接口，数据实时同步，绕过网页端限制 - 自动化程度高：支持复杂工作流编排，如 "查找未入座宾客→获取座位图→自动分配座位" 的多步骤链式操作
- 灵活认证机制：支持 fetchproxy 扩展自动获取 HttpOnly Cookie，或手动 DevTools 提取 JWT（约 1 年有效期），兼顾便利性与 CI/无头环境兼容性
- 账户自治：自动从 API 解析
account_id与registry_id，降低配置负担
潜在局限与风险
- 非官方实现：依赖逆向工程的私有 API，Zola 可随时更改端点或引入速率限制/封禁策略
- 长期令牌安全：JWT refresh token 有效期长达一年，泄露后攻击窗口期极长；虽为 HttpOnly Cookie，但通过 fetchproxy 或手动导出时仍存在暴露风险
- 数据完整性责任：自动化更新（如预算修改、宾客删除）无二次确认机制，误操作可能导致婚礼关键数据丢失
- 平台锁定：深度绑定 Zola 生态，数据导出或迁移能力受限
适用人群
- 正在使用 Zola 进行婚礼规划、寻求自动化效率提升的准新人
- 婚礼策划师或虚拟助手，需要批量管理多客户婚礼数据
- 开发者希望将婚礼筹备集成至个人知识管理或家庭自动化工作流
安全建议
- 优先使用 fetchproxy 模式避免长期令牌硬编码
- 在共享环境中设置
ZOLA_DISABLE_FETCHPROXY=1防止意外令牌泄露 - 定期轮换 refresh token（通过重新登录 Zola 网站）
- 对
update_budget_item、remove_guest等破坏性操作实施人工复核层