MCP Avada Builder Pro

Avada Fusion Builder的高级MCP集成，具有完整的短代码解析和元素管理功能。

版本：3.3.3

______________________________________________________________________

身份和隶属关系

这是一个 独立社区项目.
它是 不隶属于ThemeFusion/Avada，也不由其背书或维护.
所有产品名称和商标均归其各自所有者所有。

______________________________________________________________________

概述

MCP Avada Builder Pro通过WordPress abilities API和MCP协议提供全面的功能，以编程方式控制Avada Fusion Builder。特征：

递归短代码解析器 -处理深层嵌套结构，包括内部行/列
完全层次结构支持 -容器>行>列>元素（包括内部行/列）
56种元素类型 -Fusion Builder元素的完整注册表，包括 fusion_imageframe
通道保护 -未注册的元素类型保留为原始短代码（无数据丢失）
基于路径的元素访问 -独特的路径，如 container_0/row_0/column_0/fusion_text_1
媒体字段验证 -对image_id、图像URL、图库id进行严格验证
结构验证 -替换内容在写入之前验证结构模式
写入路径ID稳定性 -每次写入操作后返回规范路径
数据丢失防护 -所有突变的干运行验证可防止沉默元素丢失
审计日志 -所有突变都记录到带有时间戳/用户/操作的post-meta中
页面结构健康检查 -验证标签平衡、重复、往返保真度
短代码树修复 -对格式错误的短代码树进行初步修复

______________________________________________________________________

能力（共28项）

核心页面+元素管理

avada-pro/get-info -获取构建器/主题/插件版本和元素计数。
avada-pro/get-page-structure -获取页面的完整解析结构。
avada-pro/list-all-elements -列出所有页面元素（可选类型筛选器）。
avada-pro/add-container -添加一个容器（可选带有行/列）。
avada-pro/add-element -将元素添加到容器/行/列坐标中。
avada-pro/update-element -按路径更新元素内容/属性。
avada-pro/delete-element -按路径删除元素。
avada-pro/replace-content -替换结构对象中的整个页面内容（使用结构验证和备份）。
avada-pro/list-element-types -列出所有静态元素类型（56）。
avada-pro/clean-duplicates -删除页面中的重复元素。

布局操作

avada-pro/restructure-layout -根据匹配的内容重构目标行。
avada-pro/duplicate-element -将元素克隆到位。
avada-pro/move-element -在容器/行/列之间移动元素。
avada-pro/find-element -按类型/内容/属性搜索页面元素。
avada-pro/bulk-update -在一次保存中更新多个元素（事务性、全部或无）。
avada-pro/select-columns -通过作用域选择器（容器标签/索引、行、列索引、属性、包含的元素类型）选择列。
avada-pro/bulk-update-columns -通过选择器或显式路径批量修补列属性（支持模拟运行）。
avada-pro/clone-column-style -使用保留键将源列样式克隆到目标（支持模拟运行）。
avada-pro/clone-element-style -将源元素样式属性克隆到目标元素（支持模拟运行）。
avada-pro/enforce-responsive-policy -批量应用桌面/平板电脑/移动列宽策略（支持模拟运行）。

页面生命周期

avada-pro/create-page -在启用Avada的情况下创建草稿/已发布页面/帖子。
avada-pro/list-pages -列出Avada Builder处于活动状态的帖子/页面。

元素模式反思

avada-pro/get-element-schema -获取短代码的运行时/静态参数架构。
avada-pro/get-element-defaults -从FusionSC/runtime参数中获取运行时默认值。
avada-pro/list-element-categories -列出类别+每个类别的元素。
avada-pro/search-elements -按关键字/类别搜索可用元素类型。

验证与修复（v3.2.0）

avada-pro/validate-page-structure -健康检查：标签平衡、重复、往返保真度、构建器状态。返回健康评分。
avada-pro/repair-shortcode-tree -修复格式错误的短代码树（默认情况下为模拟运行）。删除重复项，清理空容器，创建备份。

______________________________________________________________________

支持的元素类型（共56种）

布局元素

fusion_builder_container -主包装
fusion_builder_row -行组织者
fusion_builder_column -立柱布局
fusion_accordion -可折叠部分
fusion_toggle -单切换
fusion_tabs -标签界面
fusion_tab -个人选项卡
fusion_tooltip -悬停工具提示
fusion_popover -点击弹出窗口
fusion_modal -弹出模式
fusion_modal_text_link -模态触发链接
fusion_viewport -可见性控制

内容元素

fusion_text -文本块
fusion_title -标题（H1-H6）
fusion_button -带链接的按钮
fusion_separator -视觉分隔器
fusion_alert -通知框
fusion_code -代码块
fusion_code_block -代码块包装器
fusion_syntax_highlighter -高级代码
fusion_table -数据表
fusion_tagline -标注框
fusion_checklist -样式化列表
fusion_content_boxes -内容网格
fusion_content_box -独立盒子
fusion_blog -博客文章
fusion_portfolio -投资组合项目
fusion_portfolio_masonry -砌体布置
fusion_faq -常见问题解答部分
fusion_counter -动画计数器
fusion_counters -多个计数器
fusion_progress -进度条
fusion_testimonial -客户见证
fusion_testimonials -推荐滑块
fusion_pricing_table -定价栏
fusion_pricing_column -单层
fusion_pricing_price -价格显示
fusion_pricing_button -CTA按钮
fusion_person -团队简介

媒体元素

fusion_image -图片
fusion_imageframe -具有样式和效果的图像框架
fusion_images -图像轮播
fusion_gallery -图片库
fusion_video -视频嵌入
fusion_audio -音频播放器
fusion_map -谷歌地图
fusion_fontawesome -图标
fusion_slider -内容滑块
fusion_post_slider -帖子滑块
fusion_rev_slider -旋转滑块
fusion_layerslider -图层滑块
fusion_fusion_slider -Fusion滑块
fusion_post_grid -立柱网格

排版元素

fusion_google_fonts -字体导入
fusion_highlight -文本高亮显示
fusion_dropcap -大写首字母

社会因素

fusion_social_links -社交图标

______________________________________________________________________

列类型

支持所有Avada列布局： 1_1, 1_2, 2_3, 1_3, 3_5, 1_4, 3_4, 1_5, 2_5, 4_5, 1_6, 5_6

______________________________________________________________________

元素路径

每个元素都有一个唯一的路径：

container_{index}/row_{index}/column_{index}/{element_type}_{index}

例子： container_0/row_0/column_0/fusion_text_2

在写入操作之后，a canonical_path 返回反映实际持久路径的值（在保存周期内稳定）。

______________________________________________________________________

安全特性

数据丢失防护 -每个突变都会在写入前后验证短代码标签计数。阻止可能丢失元素的操作。
结构验证 - replace-content 在接受之前验证容器/行/列层次结构。
媒体验证 - image_id 根据媒体库进行验证，验证URL，检查库ID。
事务性批量更新 -全有或全无验证：要么所有更新都通过，要么不应用任何更新。
自动备份 - replace-content 和 repair-shortcode-tree 在执行破坏性操作之前，将备份存储在post-meta中。
审计日志 -所有突变都记录了时间戳、用户、能力和动作描述（每个帖子最后100个事件）。
通道元素 -在解析/生成周期中，未注册的短代码作为原始文本保留。

______________________________________________________________________

需求

WordPress 5.8+
Avada主题7.0+
Avada Builder插件3.0+
能力API插件

先决条件和MCP适配器设置

要将MCP Avada Builder Pro与AI代理或外部自动化一起使用，您必须具备：

WordPress MCP适配器插件 (mcp适配器)
能力API插件 (能力api)
Avada主题 (7.0+)
Avada生成器插件 (3.0+)

1.安装所需插件

API能力

- 下载自 - 上传到 wp-content/plugins/ 并激活

MCP适配器

- 下载自 - 上传到 wp-content/plugins/ 并激活

Avada主题和构建器

- 通过ThemeForest或您喜欢的方法安装 - 激活主题和构建器插件

MCP Avada Builder Pro （此插件）

- 上传到 wp-content/plugins/ 并激活

2.验证能力暴露

激活后，MCP Avada Builder Pro的能力将通过以下方式展示：

WordPress REST API：

- GET /wp-json/wp-abilities/v1/abilities （列出能力） - POST /wp-json/wp-abilities/v1/abilities/{id}/invoke （奔跑能力）

MCP适配器：

- GET /wp-json/mcp/mcp-adapter-default-server （MCP工具发现）

测试：

curl http://your-site.local/wp-json/wp-abilities/v1/abilities | jq '.[] | select(.meta.mcp.public == true)'

你应该看到所有 avada-pro/* 列出并可调用的能力。

3.AI代理/自动化设置

使用wordpress API URL、用户名和密码配置MCP客户端（例如@automatic/MCP-wordpress-remote）。看 .mcp.json 例如config。

______________________________________________________________________

安装

将插件上传到 wp-content/plugins/
通过WordPress管理员激活
能力将自动注册

______________________________________________________________________

贡献者快速入门

分叉存储库。
从以下位置创建分支 main.
做出有针对性的改变。
运行PHP lint：

- php -l mcp-avada-builder-pro.php - php -l includes/class-avada-parser.php - php -l includes/class-avada-elements.php

使用模板打开PR。

请参阅：

结构化编辑模式（示例）

1）真相卡复制源（列）

使用 clone-column-style 与：

- source_column_path：例如。 container_5/row_0/column_1 - selector：作用域为目标节 - preserve_attributes：例如。 type, type_medium, type_small, first, last, class, id - dry_run: true 首先，然后 false

2）跨多张卡的阴影同步

使用 bulk-update-columns:

- selector：目标卡 - column_attributes: { "box_shadow_horizontal": "2", "box_shadow_vertical": "2" } - dry_run: true 第一

3）响应式堆叠规范化

使用 enforce-responsive-policy:

- desktop: "keep" - tablet: "1_2" - mobile: "1_1" - 选择器作用于目标卡集

4）元素级样式克隆（图标/标题/图像）

使用 clone-element-style:

- source_element_path：例如第一张卡 fusion_title/fusion_fontawesome/fusion_image 元素 - selector.element_type：目标元素类型相同 - preserve_attributes：保留内容标识密钥（例如图像/链接/文本特定的attr） - dry_run: true 第一

______________________________________________________________________

更新日志

3.3.3

修正了解析器行为 fusion_image 内部简码 fusion_images 不会被解析为独立元素。
防止在结构化页面更新后，在图像转盘下方重新引入重复的大图像块。
强化转盘编辑工作流程，实现可重复的构建器安全突变。

3.3.1

添加 avada-pro/clone-element-style 用于使用保留键控件进行真值源元素属性克隆。
添加 avada-pro/enforce-responsive-policy 用于批量桌面/平板电脑/移动设备宽度策略执行。
为样式克隆工作流中的结构化元素定位添加了选择器助手。
添加了批量样式和响应式规范化的模拟运行优先工作流示例。
添加了OSS基线文档和GitHub模板(LICENSE, CONTRIBUTING, SECURITY，问题/PR模板，CI PHP lint工作流）。

3.3.0

添加 avada-pro/select-columns 用于按容器标签/索引、行/索引、attr和元素存在进行范围列查询。
添加 avada-pro/bulk-update-columns 在差速器前后进行干式运行。
添加 avada-pro/clone-column-style 带有保留键控制和模拟运行预览。

3.2.0

解析器修复：修复了所有前缀冲突正则表达式模式（fusion_image/imageframe/images、tab/tab、counter/counters、content_box/content_boxes等）
解析器修复：容器解析器现在使用递归 parse_nested_shortcode 而不是非贪婪正则表达式
媒体验证：在add元素和update元素中添加了对image_id、图像URL、画廊image_ids的严格验证
写入路径稳定性：所有写入操作现在都返回 canonical_path 保存后重新读取
更换硬化的内容物：结构模式验证、空内容拒绝、替换前自动备份
新能力: validate-page-structure -带有标签平衡、重复、往返保真度的健康检查
新能力: repair-shortcode-tree -先进行干式修复，去除重复部分并清理空容器
注册表：已添加 fusion_imageframe 到静态元素注册表（共56种）
版本：提升至3.2.0（共23种能力）

3.1.2

强化权限回调，对所有12个帖子特定能力进行输入验证
添加了元素类型和属性验证助手
批量更新的事务安全性（全验证或全无验证）
所有突变操作的审计日志系统

3.1.0

添加了模式自检功能： get-element-schema, get-element-defaults, list-element-categories, search-elements

3.0.0

添加了高级编辑功能： create-page, list-pages, duplicate-element, move-element, find-element, bulk-update, restructure-layout

2.0.0

最初的Pro版本具有解析器、层次结构管理和核心CRUD功能。

______________________________________________________________________

作者

arnelG

GitHub：@wikiwyrhead

______________________________________________________________________

许可证

GNU通用公共许可证v2.0或更高版本（GPL-2.0或更高）。\ 看许可证.

MCP Avada Builder Pro

快速接入

详细介绍