核心功能
zola-mcp 是一个面向 Zola 婚礼规划平台的 Model Context Protocol (MCP) 服务器，将 Zola 移动端 API 封装为 27 个结构化工具，支持婚礼筹备全流程的自动化数据交互。
工具矩阵
| 模块 | 工具数 | 典型场景 |
|------|--------|----------|
| 供应商管理 | 5 | 搜索、预订、更新、取消婚礼服务商 |
| 预算管理 | 2 | 查看总预算、调整单项费用 |
| 宾客管理 | 4 | 添加家庭单位、更新地址、删除宾客 |
| 座位编排 | 4 | 创建座位图、分配宾客到指定座位 |
| 询价沟通 | 3 | 追踪供应商询盘、标记已读 |
| 活动与RSVP | 3 | 统计回复状态、修改活动时间地点 |
| 礼物登记 | 2 | 查看 registry、追踪收礼与致谢状态 |
| 发现探索 | 4 | 仪表板概览、搜索商户市场、收藏管理 |
技术架构
- API 端点:
mobile-api.zola.com，使用 Bearer JWT 认证 - 凭证机制: 基于
usrHttpOnly Cookie 的一年期刷新令牌，支持 fetchproxy 扩展自动获取或手动 DevTools 复制 - ID 解析: 账户 ID 与 Registry ID 首次调用时自动从 API 解析
显著优势
1. 原生集成: 直接调用官方移动 API，非爬虫方案，数据实时同步
2. 工作流封装: 提供场景化工作流示例（如"谁还没 RSVP"→track_rsvps）
3. 双模式认证: 支持 fetchproxy 浏览器扩展自动续期或 CI 环境手动配置
局限性与风险
- 凭证敏感: 刷新令牌有效期长达一年，泄露可能导致账户长期暴露
- 非官方项目: 由社区开发者 (chrischall) 维护，非 Zola 官方背书
- API 稳定性: 依赖未公开的移动端 API，存在被平台方限制或变更的风险
- 权限边界: 工具设计为读取+有限写入，但
remove_vendor、remove_guest等操作不可逆
适用人群
- 使用 Zola 作为婚礼主平台的准新人
- 需要批量导出/分析婚礼数据的进阶用户
- 希望将婚礼规划接入 AI 工作流的自动化爱好者
安全建议
- 优先使用 fetchproxy 方案避免令牌硬编码
- 定期轮换
ZOLA_REFRESH_TOKEN - CI/CD 环境建议设置
ZOLA_DISABLE_FETCHPROXY=1并配合短期令牌