内容
# Avada MCP
Avada MCP 暴露了 [Avada](https://avada.com/) / Fusion Builder 元素的 Model Context Protocol 工具功能，使 AI 代理可以使用构建器构建 WordPress 页面。
这是一个独立的 WordPress 插件，通过单个 REST 端点使用 **Streamable HTTP** 传输（JSON 响应变体 — 不使用 SSE，不使用单独的 Node 进程）提供 MCP 服务器。
## 工作原理
Fusion Builder 将页面存储为 `post_content` 中的嵌套短代码，每个元素通过 `fusion_builder_map()`（Avada 安装中 124 个元素 / 约 3,000 个参数）自我描述。该插件读取实时元素注册表并将其转换为 MCP 工具模式，然后将页面写回为短代码。
```
AI 代理 ──Streamable HTTP (JSON-RPC 2.0)──▶ POST /wp-json/avada-mcp/v1/rpc
├─ 工具/列表 ← Fusion 元素注册表
└─ 工具/调用 → post_content (短代码)
```
## 要求
- WordPress 6.0+
- PHP 7.4+
- 启用了 Fusion Builder 和 Fusion Core 的 Avada 主题
## 安装
```bash
composer install # 生成 PSR-4 自动加载器
```
然后在 WordPress 中激活插件（或 `wp plugin activate avada-mcp`）。
## 身份验证
激活时，会生成一个身份验证令牌并存储在 `avada_mcp_token` 选项中。可以通过以下方式检索：
```bash
wp option get avada_mcp_token
```
或在 `wp-config.php` 中固定自己的令牌：
```php
define( 'AVADA_MCP_TOKEN', 'your-long-random-token' );
```
将其作为 bearer 令牌发送：
```
Authorization: Bearer <token>
```
还接受登录的管理员（`manage_options`），这对于本地测试很方便。
## MCP 客户端配置
```json
{
"mcpServers": {
"avada": {
"type": "http",
"url": "http://localhost:8080/wp-json/avada-mcp/v1/rpc",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
```
## 工具
| 工具 | 用途 |
|------|---------|
| `list_elements` | 列出可用的元素（名称、标签、描述、参数数量）。 |
| `get_element_schema` | 获取一个元素的完整参数模式（类型、默认值、选项）。 |
| `create_page` | 从 JSON 元素树创建页面，序列化为短代码。 |
| `update_page` | 更新现有页面的标题、状态和/或内容（替换或追加）。 |
| `list_pages` | 列出页面（ID、标题、状态、构建器标志、URL）以发现 ID。 |
| `get_page` | 读取页面并将其内容解析回 JSON 元素树。 |
| `add_media` | 从 URL 或服务器路径将文件上传到媒体库；返回附件 ID + URL。 |
| `list_media` | 列出媒体库项目（ID、标题、URL、MIME、日期），带有搜索/类型过滤器。 |
> **布局提示：** Avada 容器是弹性布局，因此每个 `fusion_builder_row` 成为弹性项目。在一个容器中放置 **一个** `fusion_builder_row`，包含该部分的所有列 — 在一个容器中放置多个行会并排渲染，而不是堆叠。
### `create_page` / `update_page` 树形结构
```jsonc
{
"title": "我的着陆页",
"status": "publish",
"tree": [
{
"element": "fusion_builder_container",
"params": { "background_color": "#0e1116" },
"children": [
{
"element": "fusion_builder_row",
"children": [
{
"element": "fusion_builder_column",
"params": { "type": "1_1" },
"children": [
{ "element": "fusion_title", "content": "你好，世界" },
{ "element": "fusion_button", "params": { "link": "/contact" }, "content": "联系我们" }
]
}
]
}
]
}
]
}
```
## 许可证
MIT
