Wordpress Wae

🚀 WordPress Abilities Extended

WordPress Abilities Extendedは、Model Context Protocol (MCP) との統合を可能にする包括的なWordPress機能拡張プラグインです。AIエージェントがプログラムでWordPressとやり取りできるように、45の精心設計された機能を提供します。

✨ 主な機能

• 45のWordPress機能：8つの論理的なグループに整理されています。
• 完全なCRUD操作：ページ、投稿、パターン、ユーザー、メディアに対する操作が可能です。
• Gutenberg統合：パターン管理とブロック検証機能があります。
• プラグインとテーマ管理：インストールされているプラグインの一覧表示、有効化、無効化、テーマ情報の取得ができます。
• ユーザー管理：ロールベースの権限設定が可能です。
• メディア処理：メディアファイルのアップロード、一覧表示、詳細取得ができます。
• タクソノミー操作：カテゴリとタグに対する操作が可能です。
• 高度な機能：バッチ操作、パターンのインポート/エクスポート、アイテムの複製などがあります。
• 適切なセキュリティ：機能チェックと入力検証により、セキュリティが確保されています。
• MCPプロトコルサポート：MCPを介して公開される機能があります。

機能の概要

グループ1: ページ管理 (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 - 投稿を削除します。

グループ2: 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を検証します。

グループ3: ユーザーと権限 (18 - 22)

• mcp-wp/list-users - WordPressのユーザーを一覧表示します。
• mcp-wp/get-user - ユーザーの詳細を取得します。
• mcp-wp/get-current-user - 認証されたユーザーを取得します。
• mcp-wp/create-user - 新しいユーザーを作成します。
• mcp-wp/edit-user - ユーザー情報を更新します。

グループ4: プラグインとテーマ (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 - テーマの機能を取得します。

グループ5: 設定と構成 (29 - 31)

• mcp-wp/get-settings - WordPressの設定を取得します。
• mcp-wp/get-gutenberg-settings - ブロックエディターの設定を取得します。
• mcp-wp/get-site-stats - サイトの統計情報を取得します。

グループ6: メディアとアセット (32 - 34)

• mcp-wp/upload-media - メディアファイルをアップロードします。
• mcp-wp/list-media - メディアを一覧表示します。
• mcp-wp/get-media - メディアの詳細を取得します。

グループ7: タクソノミー (35 - 38)

• mcp-wp/list-categories - 投稿のカテゴリを一覧表示します。
• mcp-wp/list-tags - 投稿のタグを一覧表示します。
• mcp-wp/create-category - カテゴリを作成します。
• mcp-wp/create-tag - タグを作成します。

グループ8: 高度な機能 (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 - ページ/投稿を複製します。

📦 インストール

前提条件

1. WordPress 6.9以上 (Abilities APIを含む)
2. MCP Adapterプラグイン (GitHub releases からダウンロード)

手順

1. MCP Adapterプラグインをインストールして有効化します。
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"
      }
    }
  }
}

📚 詳細ドキュメント

ファイル構造

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つの論理的なグループに整理されています。
• 各機能には入力/出力スキーマが含まれています。
• 適切な権限と検証コールバックがあります。

ヘルパークラス (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"}}}'

バージョン

バージョン: 1.0.0

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

コントリビューション

改善や追加機能の提供は歓迎します。以下の点を確認してください。

• すべての機能が既存のパターンに従っていること。
• 入力/出力スキーマが完全であること。
• 適切な権限チェックが行われていること。
• 入力検証が包括的であること。
• コードがWordPressのコーディング標準に従っていること。