Respira for WordPress

このリポジトリが何であるか、何でないか

このリポジトリは、Respira WordPress MCPサーバーの公開リストです。サーバーソースはnpmで@respira/wordpress-mcp-serverとして配布されています。そのラッパーコードはMITライセンスであり、読んだり、フォークしたり、ベンダー化したりすることができます。

サーバーはRespira WordPressプラグインのクライアントであり、スタンドアロン製品ではありません。実際に動作させるには以下が必要です：

• サイトにインストールされたRespira for WordPressプラグイン

• ライセンスに紐づく有効なRespira APIキー

プラグインはオープンソースではありません。 商用ライセンスで配布されています。無料トライアルはrespira.pressで、カードは不要です。有料プランは月額9ユーロからです。

要するに、npx -yで実行するラッパーはオープンです。その背後にある製品はオープンではなく、それは意図的です。商用依存のない自己完結型の「AIがWordPressを編集する」スタックを求めるなら、これはそれではありません。プラグインは一人の人物によってフルタイムで開発・保守されており、ライセンス料がその原資です。

セキュリティレポートについてはSECURITY.mdを参照してください。

Related MCP server: elementor-mcp-agent

Respiraが他と違う点

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

Respiraは、AIエージェントにビルダー自身のデータ構造へのネイティブアクセスを提供するWordPressプラグインを同梱しており、さらにライブサイトへの書き込みを安全に行えるようにするセーフティレールも備えています。

クイックスタート

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

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

2. AIツールを接続

最速の方法は、respira.press/dashboard/mcpで生成されたコマンドを使用することです。サイトとキーが自動的に入力されます。手動設定は以下です。

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

~/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/mcp.jsonを作成します：

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

上記と同じ形です。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"

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サイトではコマースツールは表示されません。検出はフェイルオープンです。判断できない場合は完全なリストが表示されます。

サポートされている17のページビルダー

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

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

ツールの対象範囲

完全なリファレンスはdocsにあります。ファミリーは以下のとおりです：

すべてのツールはrespira_*という名前を使用します。従来のwordpress_*エイリアスは非推奨であり、削除される予定です。

数値の意味

このページの数値は、完全に有効化されたサイトでのカタログを表しており、クライアントが表示する内容ではありません。

実際のtools/listは319未満を返しますが、これは機能の欠落ではなく正しい動作です。サーバーはサイトごとにカタログをコンテキストフィルタリングするため、BricksツールがElementorサイトに届くことはなく、WooCommerceがない場合はコマースツールは非表示になります。ページビルダーのないブロックテーマサイトでは、コアツールが約28個少なくなります。

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スタックと連携し、それを迂回しません。

Inhaleは、Respiraアカウントなしで小さなアビリティセットを登録する無料のコンパニオンプラグインです。何よりも先にAbilitiesパスを試したい場合に便利です。

インストールオプション

npx

npx -y @respira/wordpress-mcp-server

インストール不要で、試用に適しています。欠点は、インストールの中断、外付けドライブの切断、ウイルス対策による隔離の後にnpxキャッシュが破損する可能性があり、結果として生じるENOENTエラーが紛らわしいことです。トラブルシューティングを参照してください。

グローバルインストール（最も安定）

npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

npxキャッシュを完全に回避します。日常的な使用にはこちらが適しています。

CLIオプション

環境変数

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILEとRESPIRA_CONFIG_B64はマルチサイト用の代替手段です。

ヘルスチェック

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

Nodeバージョン、設定ファイル、サイト接続、プラグインバージョン、API互換性、利用可能なアップデートをチェックし、各チェックについて実行可能な対応策付きで合格または不合格を報告します。CIパイプライン用に--jsonを追加します。

トラブルシューティング

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

{ "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つすべてを1回の呼び出しで報告します。

一部のサイトでは、プラグインやテーマのリライトルールが/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キャッシュが破損しています。一般的な原因：インストールの中断、インストール中の外付けドライブの切断、ウイルス対策による隔離、または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サーバーは資格情報を透過的に渡すだけで、保存も検証も行いません。

脆弱性はsecurity@respira.pressに報告してください。完全なポリシーはSECURITY.mdにあります。

リンク

• ウェブサイト

• ドキュメント

• プラグインのダウンロード

• MCPセットアップ

• スキルカタログ

• Abilities

• WooCommerceアドオン

• アクセシビリティスキャナーアドオン

• サポート

Respiraの入手先

ライセンス

MIT © Respira