Wordpress Wae

🚀 WordPress功能扩展插件

这是一款全面的WordPress功能插件，用于集成模型上下文协议（MCP）。它提供了精心设计的45种功能，使AI代理能够以编程方式与WordPress进行交互。

✨ 主要特性

• 45种WordPress功能：分为8个逻辑组。
• 完整的CRUD操作：可对页面、文章、模式、用户和媒体进行创建、读取、更新和删除操作。
• 古腾堡编辑器集成：支持模式管理和块验证。
• 插件与主题管理：可列出、激活和停用插件，获取主题信息。
• 用户管理：基于角色的权限管理。
• 媒体处理：支持上传、列出和检索媒体文件。
• 分类操作：可对类别和标签进行操作。
• 高级功能：包括批量操作、模式导入/导出和项目克隆。
• 安全保障：具备功能检查和输入验证。
• MCP协议支持：通过MCP公开可用功能。

📦 安装指南

前提条件

1. WordPress 6.9+（包含功能API）
2. MCP适配器插件（从GitHub发布页面下载）

安装步骤

1. 安装并激活MCP适配器插件。
2. 将此插件文件夹放置在wp-content/plugins/目录下。
3. 通过WordPress管理界面激活该插件。
4. 创建一个应用密码用于API认证（用户 > 编辑用户 > 应用密码）。

MCP客户端配置

使用以下代码配置你的MCP客户端（如VS Code、Claude Desktop等）：

{
  "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"
      }
    }
  }
}

⚠️ 重要提示

如果你的WordPress网站使用SSL，请在URL中使用HTTPS。

💻 使用示例

基础用法

所有功能都通过MCP自动公开，具备完整的输入/输出模式定义、适当的权限检查、全面的错误处理和结构化的响应格式。

以下是一个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"
      }
    }
  }
}

📚 详细文档

功能概述

第一组：页面管理（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 - 删除文章

第二组：古腾堡模式与块（11 - 17）

• mcp-wp/list-patterns - 列出所有古腾堡模式
• 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功能API
• 加载功能定义

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

• 45次wp_register_ability()调用
• 分为8个逻辑组
• 每个功能都包含输入/输出模式
• 具备适当的权限和验证回调

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

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

🔧 技术细节

安全考虑

• 所有输入都经过清理（如sanitize_text_field、wp_kses_post等）。
• 对每个操作进行用户功能检查。
• 只有经过认证的用户才能使用功能。
• 应用了适当的WordPress转义。
• 元字段键经过清理。
• 分类输入经过验证。

测试

该插件包含诊断和测试脚本：

快速诊断

bash diagnose.sh

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

完整测试套件

bash tests.sh

通过MCP协议测试所有45种功能。

通过MCP进行手动测试

1. 初始化会话并获取工具列表。
2. 使用MCP协议调用工具。
3. 工具名称使用下划线：mcp-wp-create-page（而非mcp-wp/create-page）。

以下是创建页面的示例：

# 获取会话
SESSION=$(curl -k -s -i -X POST "https://your-site.com/wp-json/mcp/mcp-adapter-default-server" \
  -u "username:password" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
  | grep -i 'mcp-session-id' | cut -d' ' -f2 | tr -d '\r')

# 创建页面
curl -k -s -X POST "https://your-site.com/wp-json/mcp/mcp-adapter-default-server" \
  -u "username:password" \
  -H 'Content-Type: application/json' \
  -H "Mcp-Session-Id: $SESSION" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"mcp-wp-create-page","arguments":{"title":"My Page","content":"Page content","status":"publish"}}}'

📄 许可证

本插件采用MIT许可证，详情请参阅LICENSE文件。

贡献说明

欢迎对插件进行改进并添加更多功能。请确保：

• 所有功能遵循现有模式。
• 输入/输出模式完整。
• 具备适当的功能检查。
• 输入验证全面。
• 代码遵循WordPress编码标准。

版本信息

版本：1.0.0