产品概述

wordpress-wae（WordPress Abilities Extended）是一个专为 Model Context Protocol (MCP) 集成设计的 WordPress 插件。该插件提供了 45 个精心设计的能力，使 AI 代理能够以编程方式与 WordPress 进行全面交互。

核心功能

八大功能组别

第一组：页面与文章管理（1-10）

• mcp-wp/create-page – 创建新页面
• mcp-wp/edit-page – 修改页面
• mcp-wp/get-page – 获取页面详情
• mcp-wp/list-pages – 带过滤的页面列表
• mcp-wp/delete-page – 删除页面
• mcp-wp/create-post – 创建文章
• mcp-wp/edit-post – 修改文章
• mcp-wp/get-post – 获取文章详情
• mcp-wp/list-posts – 带过滤的文章列表
• mcp-wp/delete-post – 删除文章

第二组：Gutenberg 模式与区块（11-17）

• mcp-wp/list-patterns – 列出所有 Gutenberg 模式
• mcp-wp/get-pattern – 获取特定模式
• mcp-wp/create-pattern – 创建新模式
• mcp-wp/edit-pattern – 修改模式
• mcp-wp/delete-pattern – 删除模式
• mcp-wp/get-block-types – 列出可用区块
• mcp-wp/validate-blocks – 验证区块 JSON

第三组：用户与权限管理（18-22）

• mcp-wp/list-users – 列出 WordPress 用户
• mcp-wp/get-user – 获取用户详情
• mcp-wp/get-current-user – 获取认证用户
• mcp-wp/create-user – 创建新用户
• mcp-wp/edit-user – 更新用户信息

第四组：插件与主题管理（23-28）

• mcp-wp/list-plugins – 列出已安装插件
• mcp-wp/get-plugin – 获取插件详情
• mcp-wp/activate-plugin – 激活插件
• mcp-wp/deactivate-plugin – 停用插件
• mcp-wp/get-theme – 获取主题信息
• mcp-wp/get-theme-supports – 获取主题功能

第五组：设置与配置（29-31）

• mcp-wp/get-settings – 获取 WordPress 设置
• mcp-wp/get-gutenberg-settings – 获取区块编辑器配置
• mcp-wp/get-site-stats – 获取站点统计

第六组：媒体与资源（32-34）

• mcp-wp/upload-media – 上传媒体文件
• mcp-wp/list-media – 列出媒体
• mcp-wp/get-media – 获取媒体详情

第七组：分类法管理（35-38）

• mcp-wp/list-categories – 列出文章分类
• mcp-wp/list-tags – 列出文章标签
• mcp-wp/create-category – 创建分类
• mcp-wp/create-tag – 创建标签

第八组：高级功能（39-45）

• mcp-wp/custom-rest-call – 自定义 REST API 调用
• mcp-wp/query-posts-advanced – 高级文章查询
• mcp-wp/batch-update – 批量更新多个项目
• mcp-wp/export-pattern – 导出模式为 JSON
• mcp-wp/import-pattern – 从 JSON 导入模式
• mcp-wp/get-pattern-usage – 查找模式使用情况
• mcp-wp/clone-item – 复制页面/文章

技术架构

文件结构

mcp-wp-capabilities/
├── mcp-wp-capabilities.php    # 主插件文件
├── data/
│   ├── abilities.php          # 能力 1-10（页面/文章管理）
│   ├── abilities-11-45.php    # 能力 11-45（剩余组别）
│   └── class-ability-helpers.php  # 通用操作辅助类
├── README.md                 # 文档文件
└── .git                      # 版本控制

架构组件

插件入口点（mcp-wp-capabilities.php）

• 注册能力类别
• 钩入 WordPress Abilities API
• 加载能力定义

能力组（data/abilities.php & data/abilities-11-45.php）

• 45 个 wp_register_ability() 调用
• 按 8 个逻辑组组织
• 每个能力包含输入/输出 schema
• 适当的权限和验证回调

辅助类（data/class-ability-helpers.php）

• 所有能力的通用工具
• 用户能力检查
• 文章/页面对象检索
• 响应格式化
• 区块验证
• 模式管理辅助

安全特性

• 输入净化：所有输入都经过严格净化处理（sanitize_text_field, wp_kses_post 等）
• 权限检查：每个操作都进行用户能力验证
• 认证要求：仅认证用户可使用能力
• WordPress 转义：应用适当的 WordPress 转义
• 元字段验证：元字段键经过净化
• 分类法验证：分类法输入经过验证

部署要求

前提条件

• WordPress 6.9+（包含 Abilities API）
• MCP Adapter 插件（从 GitHub releases 下载）

安装步骤

1. 安装并激活 MCP Adapter 插件
2. 将插件文件夹放入 wp-content/plugins/
3. 通过 WordPress 后台激活插件
4. 创建应用密码用于 API 认证（用户 > 编辑用户 > 应用密码）

MCP 客户端配置

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

使用方式

MCP 协议调用

所有能力通过 MCP 自动暴露：

• 完整的输入/输出 schema 定义
• 适当的权限检查
• 全面的错误处理
• 结构化响应格式

示例 MCP 调用：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mcp-adapter-execute-ability",
    "arguments": {
      "ability_name": "mcp-wp/create-page",
      "parameters": {
        "title": "My Page",
        "content": "Page content",
        "status": "publish"
      }
    }
  }
}

测试与诊断

快速诊断

diagnose.sh

检查 WordPress 连接性、REST API、MCP 命名空间和能力发现。

完整测试套件

tests.sh

通过 MCP 协议测试所有 45 个能力。

手动测试

支持通过 MCP 协议进行手动测试，包括会话初始化和工具调用。

版本信息

• 版本：1.0.0
• 许可证：MIT License