Airano MCP Bridge -- WordPress 插件

开发者	airano
更新时间	2026年5月11日 01:20
PHP版本:	7.4 及以上
WordPress版本:	6.9
版权:	GPLv2 or later
版权网址:	版权信息

Airano MCP Bridge is the official companion plugin for MCP Hub (source) — the AI-native management hub for WordPress, WooCommerce, and self-hosted services. It extends the WordPress REST API with dedicated routes that AI agents (Claude, ChatGPT, Cursor, VS Code Copilot) and the MCP Hub server rely on:

SEO meta routes — read and write Rank Math SEO and Yoast SEO metadata for posts, pages, and WooCommerce products.
Media upload helper routes — accept raw-binary uploads via php://input, which bypasses the upload_max_filesize PHP limit (still bounded by post_max_size). Unlocks reliable hero-image and large-asset uploads for AI-agent workflows.
Capability probe — reports the effective PHP + WordPress upload limits so MCP Hub can pick the right upload path automatically.

Features:

Rank Math SEO Support — Full access to all Rank Math meta fields
Yoast SEO Support — Full access to all Yoast SEO meta fields
WooCommerce Compatible — Works with product post types
MCP Hub media pipeline — bypasses upload_max_filesize for AI-agent uploads
Secure — Requires WordPress Application Password + capability checks on every route
Auto-Detection — Automatically detects active SEO plugin and advertises capabilities
Zero Configuration — Works out of the box after activation

REST API Endpoints: SEO meta (namespace airano-mcp-bridge/v1)

GET/POST /wp-json/airano-mcp-bridge/v1/posts/{id}/seo — Post SEO data
GET/POST /wp-json/airano-mcp-bridge/v1/pages/{id}/seo — Page SEO data
GET/POST /wp-json/airano-mcp-bridge/v1/products/{id}/seo — Product SEO data (WooCommerce)
GET /wp-json/airano-mcp-bridge/v1/status — Plugin status + active SEO plugins

MCP Bridge helpers (namespace airano-mcp/v1, added in 2.0.0)

GET /wp-json/airano-mcp/v1/upload-limits — Effective PHP + WP upload limits
POST /wp-json/airano-mcp/v1/upload-chunk — Raw-body media upload (bypasses upload_max_filesize)
GET /wp-json/airano-mcp/v1/capabilities — Effective capabilities + feature flags + available routes (added in 2.1.0)
POST /wp-json/airano-mcp/v1/bulk-meta — Batch post/product meta writes in a single HTTP round-trip (added in 2.2.0)
GET /wp-json/airano-mcp/v1/export — Structured JSON export: posts, pages, products + media + terms + meta, with post_type/status/since/limit/offset paging (added in 2.3.0)
POST /wp-json/airano-mcp/v1/cache-purge — Auto-detects active cache plugins (LiteSpeed, WP Rocket, W3TC, Super Cache, Fastest Cache, SG Optimizer) and invokes their purge API; always flushes object cache (added in 2.4.0)
POST /wp-json/airano-mcp/v1/transient-flush — Native transient cleanup with scope=expired/all/pattern (glob); optional site-transient handling on multisite (added in 2.5.0)
GET /wp-json/airano-mcp/v1/site-health — Unified site-health snapshot: PHP/MySQL/WP versions, extensions, disk free, active plugins + theme, writability checks (added in 2.6.0)
GET|POST|DELETE /wp-json/airano-mcp/v1/audit-hook — Configure + query a webhook that forwards WordPress action events to MCP Hub (HMAC-SHA256 signed, non-blocking) (added in 2.7.0)
POST /wp-json/airano-mcp/v1/regenerate-thumbnails — Regenerate attachment sub-sizes via wp_generate_attachment_metadata for a list of IDs or in paged batch mode (added in 2.8.0)
POST /wp-json/airano-mcp/v1/upload-and-attach — Raw-body upload + metadata + attach-to-post + set-featured in a single REST call (added in 2.9.0). Query params: attach_to_post, set_featured, title, alt_text, caption, description. Permission: upload_files + edit_post on the target post.

Designed for MCP Hub — the AI-native management hub for WordPress and self-hosted services. Try the live platform · Source on GitHub.

2.10.3

WordPress.org review fix: rename main class from the generic SEO_API_Bridge to Airano_MCP_Bridge per the wp.org "unique prefixes" guideline. The class is only instantiated from this file's bootstrap line and is never referenced by callers (the plugin's public surface is its REST routes, not its PHP class), so this is an internal refactor with no behaviour change.

2.10.2

WordPress.org review fixes:
Drop the unused wp-admin/includes/media.php includes from /upload-chunk and /upload-and-attach. The code only uses helpers from file.php (wp_tempnam, wp_handle_sideload) and image.php (wp_generate_attachment_metadata) — media.php was a needless direct core include.
Split /upload-and-attach permission_callback into its own method (require_upload_and_attach_capability) that explicitly enforces current_user_can('edit_post', $attach_to_post) at the route gate when attach_to_post is supplied (no longer hidden inside the callback body), and rejects set_featured requests that don't include a target post.
No behaviour changes for clients sending well-formed requests.

2.10.1

Fix: capabilities and site-health routes now share a single source of truth for the routes bitmap (previously duplicated with conflicting values for audit_hook and missing upload_and_attach). Both endpoints now read from the shared route-map constant.

2.10.0

POST /wp-json/airano-mcp/v1/upload-and-attach now honours an Idempotency-Key request header. A retry within 24 hours with the same key returns the already-created attachment (_idempotent_replay: true) rather than creating a duplicate -2.webp orphan. Protects against client-timeout regressions where a successful upload was retried because the response was lost.

2.9.0

Added POST /wp-json/airano-mcp/v1/upload-and-attach — same raw-body semantics as /upload-chunk, but accepts query params (attach_to_post, set_featured, title, alt_text, caption, description) and applies them in one PHP round-trip. Saves 2-3 REST calls per upload. Per-target permission enforced via current_user_can('edit_post', attach_to_post).
status + capabilities routes now advertise upload_and_attach: true alongside the existing capability flags.

2.8.0

Added POST /wp-json/airano-mcp/v1/regenerate-thumbnails — rebuild attachment sub-sizes via wp_generate_attachment_metadata() after an upload or format conversion changes source pixels. Supports two modes: { "ids": [...] } for targeted regeneration (up to 50 per call) and { "all": true, "offset": N, "limit": M } for paged batches (max 50 per page, with has_more + next_offset for pagination). Non-image attachments are skipped; per-item permission check via current_user_can('edit_post', $attachment_id). Permission: upload_files or manage_options.

2.7.0

Added GET|POST|DELETE /wp-json/airano-mcp/v1/audit-hook — configure a webhook that forwards WordPress action events (post transitions, deletions, user events, plugin activations, theme switches) to MCP Hub for unified auditing. Each event is signed with HMAC-SHA256 using a shared secret and posted non-blocking via wp_remote_post so the admin UI stays snappy. Secret is stored in wp_options and never echoed back in GET responses (only the last 4 characters are returned). Permission: manage_options.

2.6.0

Added GET /wp-json/airano-mcp/v1/site-health — single-envelope health snapshot: WordPress version/multisite/locale, PHP version + critical extensions, server software + disk free, MySQL/MariaDB version + charset, active plugins list (with versions), active + parent theme, writability checks (wp-content, uploads) and SSL status. Replaces 5+ separate REST calls with a single request. Permission: manage_options.

2.5.0

Added POST /wp-json/airano-mcp/v1/transient-flush — native PHP transient cleanup. Scopes: expired (default, calls delete_expired_transients()), all (delete every _transient_% row), or pattern (glob match, e.g. rank_math_*). Optional include_site_transients for multisite. Response includes deleted_count + capped deleted_sample for observability. Permission: manage_options.

2.4.0

Added POST /wp-json/airano-mcp/v1/cache-purge — auto-detects active page-cache plugins (LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Optimizer) and triggers their purge API. Always calls wp_cache_flush() for object caches. Permission: manage_options. Removes the need for Docker-socket + WP-CLI to flush caches on managed hosts.

2.3.0

Added GET /wp-json/airano-mcp/v1/export — structured JSON export of posts, pages, and WooCommerce products (not WXR). Query params: post_type, status, since, limit (max 500), offset, include_media, include_terms, include_meta. Response includes posts + referenced media + taxonomy terms + post meta in a single envelope, plus has_more / next_offset for pagination. Permission: edit_posts.

2.2.0

Added POST /wp-json/airano-mcp/v1/bulk-meta — writes many post_meta / product_meta entries in a single REST request. Capped at 500 items per call; each item is permission-checked via current_user_can('edit_post', $post_id). Null meta values delete the key. Status endpoint now advertises capabilities.bulk_meta = true and the capabilities probe reports routes.bulk_meta = true.

2.1.0

Added GET /wp-json/airano-mcp/v1/capabilities — reports the effective capabilities of the calling application password, plus feature flags (Rank Math / Yoast / WooCommerce / multisite) and the list of companion routes this version actually ships. Consumed by MCP Hub's capability probe so per-user clients only see tools they're actually authorised to use.
Status endpoint now advertises capabilities.capabilities = true.

2.0.0

Rebrand: "Airano MCP SEO Meta Bridge" → "Airano MCP Bridge". The companion plugin is no longer SEO-only.
Added GET /wp-json/airano-mcp/v1/upload-limits — returns effective PHP + WP upload limits for MCP Hub probes.
Added POST /wp-json/airano-mcp/v1/upload-chunk — raw-body upload route that bypasses upload_max_filesize.
Status endpoint now includes capabilities: { seo_meta, upload_limits, upload_chunk }.
Plugin folder / slug unchanged: airano-mcp-bridge (permanent on wordpress.org).

1.3.0

Added REST API endpoints for posts, pages, and products (GET/POST operations)
Added authentication requirement for all endpoints
Fixed rank_math_title meta key registration

1.2.0

Enhanced WooCommerce product support
Improved MariaDB compatibility

1.1.0

Added status endpoint for plugin detection
Improved error handling

1.0.0

Initial release with Rank Math and Yoast SEO support

Airano MCP Bridge

标签

下载

详情介绍:

安装:

升级注意事项:

常见问题:

更新日志: