elementor-mcp-agent 是一个面向 WordPress Elementor 的机构级 MCP 服务器，旨在让 Claude 或任何 MCP 客户端安全地管理多个 Elementor / Elementor Pro 站点，减少重复性劳动，同时避免破坏页面。项目采用 MIT 许可，由 Mogacode 开发，通过 Claude Code 在约 48 小时内端到端构建，架构、代码、测试和文档均通过 Claude Code 结对编程会话生成。
用途
该工具主要服务于运行多个客户站点的 WordPress 机构，解决多站点工作流中的安全编辑、备份、模板管理和批量操作问题。它强调在每次编辑前进行真实备份，并在编辑产生无效 Elementor 数据时自动回滚。
主要能力
- 多站点管理：枚举站点池、认证探测、健康快照。
- 安全编辑：任何破坏性操作需要两次调用确认（TTL 60 秒）；JSON 验证 + 自动回滚；三级 CSS 刷新回退（REST → wp-cli 原生 → option/meta 删除 → 重新保存）。
- 备份与恢复：每次编辑前通过 WP-CLI 备份 postmeta（SSH 可用时），否则回退到 JSON 文件；支持列出备份、恢复备份（恢复前有安全备份）。
- 模板管理：列出模板（区分 Theme Builder 与常规库）、导出/导入模板、将模板应用到现有页面。
- 小部件级 CRUD：读取、更新设置、删除、复制、交换类型、添加、移动小部件。
- 批量与舰队操作：单站点内所有 Elementor 页面查找替换、跨站点池查找替换（顺序执行，强制 dry-run）、从文件恢复。
- WP-CLI 逃生通道（需要 SSH）：运行任意 wp-cli 命令（检测破坏性模式并确认）、wp search-replace（强制 dry-run）、wp elementor flush-css、插件列表/更新（带确认）。
- 截图与比较：通过无头 Chrome 截取任意 URL 的 PNG，使用 SHA-256 和字节差异比较截图。
- 全局小部件感知：预检检查会警告页面是否引用了共享小部件。
- 写后验证（v1.2）：每个修改小部件的工具在写入后从规范 WP 重新读取页面，并向模型展示持久化状态；如果 verification.matches_requested === false，即使 HTTP 层返回 OK 也视为失败，原始负载保留在 backup_meta_key 中，可通过 restore_elementor_backup 恢复。
使用方式
- 在 https://{your-site}/wp-admin/profile.php#application-passwords-section 生成 WordPress 应用程序密码。
- ssh 块是可选的，但可解锁 8 个额外工具（WP-CLI 逃生通道 + 可靠的自定义 postmeta 备份）。没有 SSH 时 MCP 仍可工作，备份会保存到本地 JSON 文件。
- wp_cli_path 如果省略会自动检测（尝试 wp，然后 ~/bin/wp.phar，然后 ~/wp-cli.phar）。
- 提供 Claude Desktop 配置。
适用场景
适用于需要管理多个 Elementor 站点的机构，进行安全的批量编辑、模板部署、小部件调整、截图验证和版本跟踪。
限制
- 部分功能（如 WP-CLI 逃生通道、可靠的自定义 postmeta 备份）需要 SSH 可用。
- 破坏性操作需要确认，且某些 wp-cli 模式被硬编码阻止（如 db reset --yes / db drop --yes）。
- 项目文档中列出了未来计划功能，如全局样式读写、跨站点 Theme Builder 模板推送、区块/列级操作、WooCommerce 感知工具、视觉差异（像素比较）、计划与 cron 调度等，这些在撰写时可能尚未提供。
- 具体收费、价格、平台支持等细节暂未提供。
