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