MCP Adapter

変更履歴

0.7.1 – 2026-10-15

修正

• Bound stored session initialization parameters to 4 KiB and automatically recover oversized session data, preventing repeated database failures and excessive logging. Affected clients need to reconnect once. Client icons are excluded from storage so large inline icons do not prevent connections.
• Register the installed plugin’s autoloader before checking for bundled copies, allowing version selection before an older bundled class is loaded.
• Unknown ability names from MCP clients no longer generate WordPress developer notices.

変更

• Unavailable abilities return clearer errors with relevant available ability names or a pointer to discovery. Abilities not exposed through MCP return the same ability_not_found error as unknown names.

追加

• A site-owner guide covers connecting an AI client, Application Passwords, and troubleshooting.

0.7.0 – 2026-10-02

破壊的変更

• アダプターが提供する MCP スキーマのリビジョンを 2025-11-25 と 2026-07-28 の2つに限定。2025-06-18 または 2024-11-05 を提示するクライアントも接続でき、2025-11-25 のスキーマで応答する。
• 生成された DTO クラス、McpToolValidator、McpResourceValidator、McpPromptValidator クラス、および mcp_adapter_validation_enabled フィルターを削除。ワイヤー形式の検証は常に選択されたスキーマを通じて実行。
• 無効なプロトコルフィールドを黙って削除または修正しないように変更。対応するリビジョンで表現できないコンポーネントを拒否。
• 独自のトランスポートは HttpRequestHandler または McpWireOrchestrator に処理を委譲する必要がある。JSON-RPC のバッチリクエストを拒否。
• WP\MCP\Cli クラスを final に変更。

追加

• セッションを使用しない server/discover のライフサイクルと新しい HTTP ヘッダーを含む、MCP 2026-07-28 への対応。
• 直接呼び出せるツールが McpInputRequired を返すことで、2026-07-28 では elicitation による入力を要求できるように変更。
• 選択されたスキーマ、トランスポート、セッションデータを保持する、リクエストごとの変更不可のコンテキスト McpRequestContext を追加。

変更

• MCP Adapter を同梱ライブラリとして使用する方法を非推奨に変更。代わりに MCP Adapter プラグインをインストールする。

修正

• mcp-adapter/get-ability-info が空の input_schema を [] ではなく {} としてシリアライズするように修正。
• 別のプラグインが MCP サーバーの初期化より先に Abilities API を初期化した場合でも、デフォルトのアビリティを登録するように修正。

変更の全一覧は、0.7.0 移行ガイドと CHANGELOG.md を参照してください。

0.6.1 – 2026-08-13

修正

• リリース ZIP に含まれないファイルを参照する Jetpack Autoloader のクラスマップを、ZIP に同梱しないように変更。0.6.0 のクラスマップには、WP_CLI や WP_CLI_Command などのテスト専用グローバルクラスが記載され、リリース成果物から除外される tests/phpunit/ 内のファイルに対応付けられていた。そのため、通常の Web リクエストでプラグインが class_exists( 'WP_CLI' ) を呼び出すと、捕捉されない致命的エラーが発生する可能性があった。WP-CLI を利用できない場合、class_exists( 'WP_CLI' ) は false を返すように修正 (#283)。

API、フック、プロトコルの動作に変更はありません。0.6.0からのアップグレードに移行作業は不要です。ソースからビルドした環境や Composer 経由で導入した環境には影響しません。

0.6.0 – 2026-08-12

破壊的変更

• WordPress 6.9以降が必須に。単独の Abilities API プラグインを使ったインストール方法はサポートを終了。
• meta.public: true のアビリティは、meta.mcp.public で明示的に除外されない限り、デフォルトの MCP サーバーを通じて公開されるように変更。既存の権限コールバックと権限チェックは引き続き適用される。
• マルチサイトでは、セッション保存領域がネットワーク共通のキーからサイトごとのキーに変わるため、稼働中の Streamable HTTP セッションはアップグレード後に一度再接続する必要がある。単一サイトには影響しない。
• McpValidator が公開していた MIME 検証ヘルパーを削除。これらを直接呼び出している連携では、用途に応じた MIME 検証を独自に実装する必要がある。

追加

• resources/templates/list に対応し、テンプレートがない場合は空のテンプレート一覧を返すように変更。
• プラグインの PHP ファイルの直接実行を防止。
• 互換性、依存関係、Plugin Check に関する自動チェックの対象を拡大。

変更

• Jetpack Autoloader を使用し、単独のアダプターと別のプラグインに異なるバージョンが同梱されている場合、利用可能な最新の WP\MCP クラスを優先。
• WordPress マルチサイトのサイトごとにセッション保存領域を分離。
• 同時に行われるセッションの変更を回数制限付きの再試行で保護し、あるリクエストが別のセッションを上書きするリスクを軽減。
• Abilities API が WordPress 6.9 以降に含まれることと、アビリティに category フィールドが必要なことをドキュメントで明確化。各種例も改善。

修正

• リソースの内容、埋め込みリソース、コンテンツブロック、プロンプトメッセージの _meta を保持。
• 不正な形式の _meta は、対応するペイロードを破棄せずに省略。
• text/html;profile=mcp-app のようにパラメーターを含む値も、宣言されたとおりに mimeType を出力。
• Blob のみのリソースコンテンツは、正しく処理されます。
• リソース URI のスキームを大文字と小文字を区別せずに照合し、クライアントがスキームを小文字に正規化してもリソースを読み取り可能に。
• スキーマを定義するアビリティの空の引数を正規化し、有効な引数なしのツール呼び出しを実行可能に。
• デフォルトサーバーを選択する際、wp mcp-adapter serve の JSON-RPC 用標準出力に余分な内容が混入しないよう修正。
• 競合するローカルオプションを登録せず、WP-CLI のグローバル引数 --user を使用。

以前のリリースについては CHANGELOG.md を参照してください。