mcpField
R
Respira For Wordpress

Respira For Wordpress

ローカル
respira.press開発ツール102 日前に更新

Respira For Wordpress について

Respira For Wordpress は、AI エージェントでサイトを管理するユーザー向けの WordPress MCP サーバーです。Respira プラグインと API キーが必要で、ページビルダーのネイティブ構造を編集でき、スナップショットやロールバックなどの保護機能を備えています。

主な機能

  1. 0119 種類のページビルダーに対応
  2. 02ページ要素の検索と編集
  3. 03宣言的な構造からページを作成
  4. 04HTML や Figma をネイティブ形式に変換
  5. 05書き込み前のスナップショットと復元
  6. 06ツール単位のアクセス管理

活用シーン

  1. 01Elementor や Divi のページ編集
  2. 02HTML や Figma からページを生成
  3. 03ページのアクセシビリティ監査と修正
  4. 04本番サイトの編集前にスナップショットを作成

MCP 対応

MCP クライアントに WordPress のページ、ビルダー、サイト管理ツールを提供します。Respira for WordPress プラグインと有効な API キーが必要で、ホスト型のリモート MCP サーバーも利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": [
"-y",
"@respira/wordpress-mcp-server"
],
"env": {
"WORDPRESS_URL": "<WORDPRESS_URL>",
"WORDPRESS_API_KEY": "<WORDPRESS_API_KEY>"
}
}
}
}
起動コマンドnpx -y @respira/wordpress-mcp-server
設定が必要な環境変数
WORDPRESS_URL
WORDPRESS_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@respira/wordpress-mcp-server

ツール

200

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
detailenumいいえ応答の詳細レベル:"basic"(デフォルト)または "full"。basic | full
site_idstringいいえ任意。この呼び出しに限り、グローバルな現在のサイトを変更せずにアクティブサイトを上書きします。複数の Cowork チャットで異なる WordPress サイトを並行して扱う場合、各チャットがツール呼び出しごとに対象サイトを固定するために使用します。

詳細

WordPress 用 Respira

Respira WordPress MCP サーバー

19 種類のページビルダーに対応する MCP ツールと WordPress Abilities。WordPress の AI インフラストラクチャ層です。
要素単位の編集、ページ全体の作成、HTML や Figma からネイティブビルダーへの変換、デザインの方向性、サイトメモリ、アクセシビリティとセキュリティのスキャン、ツールごとのガバナンス、スナップショットとロールバックに対応します。

npm バージョン npm ダウンロード数 ツールカタログ 19 種類のページビルダー TypeScript

ウェブサイト • ドキュメント • プラグイン • MCP のセットアップ • スキル • サポート


このリポジトリの内容と、対象外のもの

このリポジトリは、Respira WordPress MCP サーバーの公開リスティングです。サーバーのソースは npm で @respira/wordpress-mcp-server として公開されています。このラッパーコードは MIT ライセンスで提供されており、自由に閲覧、フォーク、またはベンダーに組み込んでいただけます。

このサーバーはRespira WordPress プラグインのクライアントであり、単独で使える製品ではありません。実際に動作させるには、以下が必要です。

  • サイトに Respira for WordPress プラグインをインストールすること
  • ライセンスに紐付いた有効な Respira API キー

プラグインはオープンソースではありません。 商用ライセンスで提供されています。respira.press で無料トライアルをご利用いただけます。クレジットカードは不要です。有料プランは月額 9 EUR からです。

つまり、npx -y で実行するラッパーはオープンですが、その背後にある製品はオープンではありません。これは意図的なものです。商用依存のない、自己完結型の「AI が WordPress を編集する」スタックをお求めの場合、これは該当しません。このプラグインは一人の開発者が専任で開発・保守しており、ライセンス料金がその運営を支えています。

セキュリティに関する報告は SECURITY.md をご覧ください。


Respiraの特長

ほとんどのWordPress MCPサーバーはREST APIをラップしています。投稿や固定ページは作成できますが、実際のサイトのコンテンツが存在するページビルダーにはアクセスできません。

Respiraは、AIエージェントがページビルダー独自のデータ構造にネイティブアクセスできるWordPressプラグインと、公開中のサイトへの書き込みを安全に行うための保護機能を提供します。

機能RespiraREST APIラッパー
ページビルダーのサポート19種類なし
要素単位の検索/更新/移動/削除はいいいえ
宣言型の構造からページ全体を構築はいいいえ
HTMLまたはFigmaをネイティブなページビルダー出力に変換はいいいえ
デザイン方針(サイト全体のアートディレクション)はいいいえ
エージェントのセッションをまたいで保持されるサイトメモリはいいいえ
アクセシビリティのスキャンと自動修正はいいいえ
セキュリティ監査とコアの強化はいいいえ
書き込みの前に毎回スナップショットを作成し、いつでもロールバック可能はいいいえ
編集前に複製する安全機能はいいいえ
wp-adminからツールごとにガバナンスを設定はいいいえ
WordPress Abilities APIとWebMCPはいまれ
WooCommerce(商品、注文、在庫、ストアフロント)はい(アドオン)いいえ

クイックスタート

1. WordPressプラグインをインストールする

respira.press/pluginからダウンロードしてWordPressにアップロードし、有効化します。次に、Respira > API Keysに移動し、キーを生成します。

2. AIツールを接続する

最も簡単なのは、respira.press/dashboard/mcpで生成されたコマンドを使う方法です。サイトとキーが自動的に入力されます。手動で設定する場合は、以下を参照してください。

Claude Code
claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server
Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または%APPDATA%\Claude\claude_desktop_config.json(Windows)に追加します。

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}
Cursor

プロジェクト内に.cursor/mcp.jsonを作成します。

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}
Codex, Windsurf, and other clients

上記と同じ形式です。Codexでは~/.codex/config.tomlのTOMLを使用します。

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

または、add-mcpにツールを検出させます。

npx add-mcp "npx -y @respira/wordpress-mcp-server"
ChatGPT and remote clients

RespiraはOAuth対応のホスト型リモートMCPサーバーとしても動作するため、ローカルでNodeプロセスを実行する必要はありません。クライアントごとのセットアップ手順はrespira.press/mcpにあります。

3. サイトを追加する

ウィザードを実行します。

npx @respira/wordpress-mcp-server --setup

または、~/.respira/config.jsonを自分で作成します。

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true
    }
  ]
}

AIツールを再起動して、編集を始めましょう。

クライアントのツール数上限に達しましたか?

MCPクライアントによっては、有効にできるツール数が100個などに制限されています。Respiraが公開するツールはそれよりはるかに多いため、設定にenabledToolsを追加し、一覧に表示するツールだけを指定してください。

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

サイト管理ツール(respira_list_sites、respira_switch_site、respira_get_active_site)は常に含まれます。一覧にないツールも、直接呼び出せば利用できます。このフィルターは、公開するツールの表示のみを制御します。

さらに、サーバーはサイトで実際に稼働している機能に基づいてツール一覧をフィルタリングします。WooCommerceを使っていないDiviサイトには、コマース関連のツールは表示されません。検出に失敗した場合も利用できるように設計されており、判定できないときはすべてのツールが表示されます。


19 個の対応ページビルダー

level は Respira の書き込み深度を示すものであり、ビルダーの品質を示すものではありません。

ビルダーレベル備考
BricksDeepグローバルクラス、テーマスタイル、ACSS、コンポーネント、クエリループ、BEM の lint
ElementorFullネイティブ API、ランタイム制御レジストリ
DiviFullDivi 4 と Divi 5、Divi 5 の 40 以上のモジュール定義
OxygenFullClassic と Oxygen 6
GutenbergFullブロックレジストリ、FSE テンプレート、パターン、ナビゲーション
FlatsomeFullショートコードのラウンドトリップ編集、55 要素のインテリジェンス
Beaver BuilderSmartツリーユーティリティ、静的スキーマ
BreakdanceSmartツリーユーティリティ、静的スキーマ
BrizySmartツリーユーティリティ
WPBakerySmartツリーユーティリティ
SpectraSmartブロックターゲット
Kadence BlocksSmartブロックターゲット
GenerateBlocksSmartブロックターゲット
GreenShiftSmartブロックターゲット
Visual ComposerSmart書き込み機能は限定的
Thrive ArchitectSmartテキスト編集
SeedProdSmart監査のみ
YOOtheme ProFullレイアウトは YOOtheme 独自の形式で読み書きし、ビルダーを通じて保存
AvadaFullAvada Builder のショートコード、グローバルパレットとタイポグラフィ、Layouts と Library(プラグイン 9.2.6 以降)

複数のビルダーを使用するサイトでは、サイト単位ではなくページ単位で処理します。


ツールの対象範囲

完全なリファレンスはドキュメントにあります。ツール群は以下のとおりです。

ファミリー機能
ページ、投稿、カスタム投稿ビルダー対応のペイロード、アウトライン、複製、翻訳を使って読み取りと書き込みを行います
要素の操作ID、タイプ、クラス、コンテンツテキストで単一要素を検索、更新、移動、複製、並べ替え、削除します
ページ構築宣言的な構造からrespira_build_pageでページを構築するほか、ウィジェットを1行で追加するショートカット(見出し、ボタン、画像、フォーム、スライダー、料金表など)を利用できます
変換CSS の抽出、レスポンシブ対応のマッピング、忠実度スコアを備えた、HTML からネイティブビルダーへの変換。バンドルされたスキルを使って、Figma から Bricks、Divi、Elementor、Gutenberg に変換できます
デザインの方向性サイト全体のアートディレクションを保存、適用、有効化、エクスポートできます。確定前にプレビューし、同じ方向性を別のサイトに適用できます
デザイントークンDTCG トークンを作成、更新、インポートし、デザインシステムをテーマに同期します
サイトメモリーrespira_remember、respira_forget、respira_list_memory。エージェントのセッション間で保持される、サイトに関する情報です
プレイブックエージェントが作成、取得、実行できる、名前付きの再利用可能な手順です
スナップショット書き込みの前に毎回自動で作成し、2つのスナップショットを比較して、いずれかに復元できます
分析SEO、AEO、可読性、RankMath、構造化データ、画像、Core Web Vitals、PageSpeed
SEO プラグインタイトル、説明、フォーカスキーワード、canonical、robots を Yoast SEO、Rank Math、SEOPress、All in One SEO 4 の各プラグイン専用フィールドに書き込み、読み戻します。Yoast のターム SEO と検索外観のツールも利用できます
更新とバックアップ保留中の更新を一覧表示し、担当者が確認したバージョンのみをインストールします。プラグインの更新は、まず Duplicator、BackWPup、UpdraftPlus のいずれかで新しいバックアップを作成する必要があります。その後、4つのヘルスチェックを実施し、いずれかに失敗した場合は wordpress.org から以前のバージョンを戻して、処理結果を記録します
ビルダーの移行Elementor から Bricks、Divi から Bricks、WPBakery から Gutenberg など、16種類の無料移行スキル
アクセス制御アクセスプロファイル(Everything、Content、読み取り専用の Observe)、ツールごとの切り替え、下書きと SEO フィールドに制限された Publish only キーを利用できます。これらの設定はすべての接続で維持されます
アクセシビリティページをスキャンし、スキャン結果を一覧表示して、修正を適用できます
セキュリティセキュリティ監査、検証、コアの強化、デバッグログの読み取り
テーマとテンプレートFSE テンプレート、テンプレートパーツ、パターン、ナビゲーション、テーマビルダーのテンプレート、テーマファイルの読み取りと書き込み
サイト構造カスタム投稿タイプ、タクソノミー、ACF フィールドグループ、メニュー、メガメニュー、ターム
メディアアップロード、URL からのサイドロード、メタデータの一括更新、自動でクレジット表記を付ける Openverse のストック画像検索
一括操作1回の呼び出しで最大100ページを処理し、スナップショットを必須で作成します
マルチサイト1つの設定から複数のサイトを一覧表示、切り替え、操作できます
WooCommerceカタログ、価格、在庫、注文、ストアフロントのデザインに対応するストアツールは、有料アドオンで利用できます

すべてのツール名にはrespira_*を使用します。従来のwordpress_*エイリアスは非推奨で、今後削除されます。

数値の意味

現在の件数はライブツールカタログに掲載されているもので、リリースごとにコードから集計されます。製品全体および各プランのMCPツール、WooCommerceアドオンのツール、WordPress Abilitiesが含まれます。これらはすべての機能が有効になったサイトのカタログを示すものであり、クライアントに表示される件数ではありません。

ライブのtools/listが返す件数はカタログの総数より少なくなりますが、これは機能の欠落ではなく、正しい動作です。サーバーはサイトごとにコンテキストに応じてカタログをフィルタリングするため、BricksのツールがElementorサイトに表示されることはなく、WooCommerceがない場合はコマースツールも非表示になります。ページビルダーを使用していないブロックテーマのサイトでは、コアツールはさらに少なくなります。

Abilitiesレジストリはコンテキストに応じたフィルタリングを行わないため、同じサイトでAbilitiesの件数がツールの件数を正当に上回ることがあります。この2つは直接比較できません。

同梱スキル

このパッケージには、ツールを組み合わせて活用するためのレシピであるRespiraのClaude Codeスキルが含まれています。ページビルダーの移行(DiviからBricks、ElementorからGutenberg、WPBakeryからBricksなど)、Figmaからビルダーへの変換、サイト監査、SEOとAEOのチェック、WooCommerceのワークフローなどがあります。

npx @respira/wordpress-mcp-server install-skills

respira.press/skillsでカタログをご覧ください。


安全性

本番稼働中のサイトへの書き込みこそが、最大の課題です。そのための安全策は次のとおりです。

  1. 変更の前に毎回スナップショットを作成します。 respira_restore_snapshotで復元し、respira_diff_snapshotsで比較できます。
  2. 編集前に複製します。 エージェントがコピーを編集する間、元のサイトは変更されません。
  3. ツールごとのガバナンス。 管理者はwp-adminから個々のツールを有効または無効にできます。ガバナンスはREST経由、Abilities API経由、WebMCPのいずれにも適用されます。
  4. 読み取り専用モード。 エージェントをサイトに接続し、書き込みを許可せずに閲覧させることができます。
  5. アクティビティログ。 すべての呼び出しが記録され、wp-adminとrespira_list_activityから確認できます。

WordPress AIエコシステム

Respiraは、公式のWordPress AIスタックを迂回せず、それと連携して動作します。

経路仕組み要件
スタンドアロンMCP(このパッケージ)npx @respira/wordpress-mcp-serverNode 20+、Respiraプラグイン
リモートMCPOAuth対応のホスト型エンドポイント。ローカルプロセスは不要Respiraプラグイン、アカウント
WordPress Abilities APIRespiraのすべてのツールをAbilityとして登録し、自動検出WP 6.9+、Respiraプラグイン
MCP AdapterWP-CLI STDIO経由でAbilitiesを公開WP 6.9+、MCP Adapterプラグイン
WebMCPChrome Abilities APIを介したブラウザネイティブのMCPChrome 146+、Respiraプラグイン

Inhaleは、Respiraアカウントなしで少数のAbilitiesを登録する無料のコンパニオンプラグインです。まずはAbilities経由の方法を試したい場合にご利用ください。


インストール方法

npx
npx -y @respira/wordpress-mcp-server

インストール不要で、試すのに適しています。一方で、インストールの中断、外付けドライブの切断、ウイルス対策ソフトによる隔離などにより、npxのキャッシュが破損し、原因が分かりにくいENOENTエラーが発生することがあります。トラブルシューティングをご覧ください。

グローバルインストール(最も安定)
npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

npxのキャッシュを完全に回避できます。日常的な使用に適した方法です。

CLIオプション
フラグエイリアス説明
--setup-s対話形式のセットアップウィザード
--list-l設定済みサイトの一覧を表示
--test-t接続をテスト
--doctor-dヘルス診断。機械可読形式の出力には--jsonを追加
--install-config検出されたクライアント用のMCP設定を書き込み
install-skills同梱スキルをローカルのスキルディレクトリにコピー
--stdioMCP Adapter用のSTDIOトランスポート
--version-vバージョンを表示
--help-hヘルプ
環境変数
export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

複数サイトを設定する場合は、RESPIRA_CONFIG_FILEとRESPIRA_CONFIG_B64を使用できます。


Grok Build プラグイン

このリポジトリは、Grok Build 用の Respira プラグインのソースでもあります。このプラグインは、意図的に小規模にしています。含まれるファイルは次の 2 つだけです。

  • .grok-plugin/plugin.json:マニフェスト。
  • .mcp.json:MCP サーバーの定義。npx -y @respira/wordpress-mcp-server を実行します。この README で説明しているものと同じパッケージです。

スキル、コマンド、エージェント、フック、インストールスクリプトはありません。

初回使用前に。 サイトに Respira for WordPress プラグインをインストールし、npx @respira/wordpress-mcp-server --setup を一度実行してください。これによりサイトリストが ~/.respira/config.json に書き込まれます。サーバーは Grok Build の起動時にこのファイルを読み込みます。このファイルにサイトが登録されていない場合、サーバーは 1 つのツール respira_redeem_token だけを起動します。このツールは respira.press/dashboard/mcp のセットアップコードを受け取り、サイトリストを書き込みます。

サーバーが呼び出すネットワークエンドポイント。

エンドポイント用途
/wp-json/respira/v1/ にある、お客様自身の WordPress サイトすべてのツール呼び出しは、設定ファイルに登録されたサイト上の Respira プラグインへのリクエストです。サイトコンテンツを読み書きするものはほかにありません。
https://www.respira.pressセットアップコードとサイトリストの交換、サイトリストの更新、ツール呼び出しごとの使用記録 1 件(ツール名、サイト、バージョン、所要時間。ページコンテンツや会話は含みません)。RESPIRA_USAGE_OPT_OUT=1 を設定すると、使用記録を無効にできます。不具合レポートは、依頼した場合にのみ送信されます。
https://registry.npmjs.orgパッケージの新しいバージョンがあるかどうかを確認します。RESPIRA_MCP_DISABLE_UPDATE_CHECK=1 を設定すると、確認を無効にできます。

認証情報。 サイトごとに Respira サイトキーが 1 つあり、お使いのマシンの ~/.respira/config.json に保存されます(単一サイトの場合は WORDPRESS_URL と WORDPRESS_API_KEY を使用します)。キーはリクエストヘッダーに含めて、対応するサイトにのみ送信されます。WordPress プラグインがキーを検証します。サーバーが SSH キー、.env ファイル、その他のトークンを読み取ることはありません。

プラグインを使わない場合。 Grok Build からサイトに直接アクセスすることもできます。その場合はサイトごとにコマンドを 1 つ実行します。respira.press/integrations/grok をご覧ください。


ヘルスチェック

npx @respira/wordpress-mcp-server --doctor

Node のバージョン、設定ファイル、サイトへの接続、プラグインのバージョン、API の互換性、利用可能なアップデートを確認し、各チェックの合否と、対処に役立つ情報を報告します。CI パイプラインでは --json を追加してください。


トラブルシューティング

Windows:「npx」が認識されない

フルパスを使用してください。

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

または、npm install -g @respira/wordpress-mcp-server でグローバルにインストールし、{ "command": "respira-wordpress-mcp" } を使用してください。

接続に失敗する
  1. WordPress > Respira > API Keys で API キーを確認してください
  2. URL に https:// が含まれている必要があります
  3. プラグインが有効化されている必要があります
  4. ホストが REST API をブロックしていないか確認してください

respira_diagnose_connection を実行すると、4 項目すべてを一度に確認できます。

JSON ではなく HTML が返される、または呼び出すたびにホームページへリダイレクトされる

一部のサイトでは、プラグインやテーマのリライトルールによって /wp-json/[anything] が捕捉され、?rest_route= クエリ変数を付けずにパスが index.php に書き換えられます。その後、WordPress はホームページに 301 リダイレクトします(リダイレクトの連鎖で x-redirect-by: WordPress が確認できます)。その結果、MCP サーバーは JSON の代わりに HTML を受け取ります。

サーバーはこれを自動検出し、サイトのルートに対して ?rest_route=... を使って呼び出しを再試行します。JSON が返された場合は、以降の呼び出しをすべて、セッション終了まで同じ方法でルーティングします。初回の有効化時に、stderr に警告が 1 回表示されます。

リライトによるシャドーイングが発生していると分かっている場合は、forceRestRoute を使って検査を省略できます。

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

respira_diagnose_connection は両方の形式を検査し、rest_route_fallback_worked、rest_route_fallback_active、force_rest_route_configured を報告します。

ツールが表示されない
  1. ウィンドウだけでなく、AI ツールを完全に再起動してください
  2. 設定ファイルの JSON 構文を検証してください
  3. クライアントの設定ファイルの場所を確認してください
  4. npx @respira/wordpress-mcp-server --test を実行してください

クライアントが有効なツールの数を制限している場合は、上記の enabledTools を参照してください。

/_npx/ または node_modules に関する ENOENT エラー

npx キャッシュが破損しています。よくある原因は、インストールの中断、インストール中の外付けドライブの切断、ウイルス対策ソフトによる隔離、または npx の実行中に npm cache clean を実行したことです。

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

セキュリティ

API キーの検証は WordPress プラグイン側で行われます。MCP サーバーは認証情報を受け渡すだけで、保存も検証もしません。

脆弱性は [email protected] まで報告してください。ポリシーの全文は SECURITY.md をご覧ください。


リンク

Respira の掲載先

ディレクトリ掲載先
npm@respira/wordpress-mcp-server
Official MCP Registryio.github.webmyc/respira-wordpress
Smitherysmithery.ai
Glamaglama.ai/mcp/servers
mcp.somcp.so
cursor.directorycursor.directory

ライセンス

MIT © Respira


コードから数えた全ツールカタログはこちら:respira.press/tools。WordPress 向けの AI インフラストラクチャ層です。
respira.press

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。