ItchWPMCP

Codex/ClaudeがWordPress REST APIを通じてWordPressコンテンツをクエリおよび編集するためのローカルMCPサーバー。

REST APIが有効で、アプリケーションパスワード認証をサポートしているすべてのWordPressサイトで使用できます。

セットアップ

1. WordPressのアプリケーションパスワードを作成します： WordPress管理画面 -> ユーザー -> プロフィール -> アプリケーションパスワード

2. .env.example を .env にコピーし、以下を記入します：

   WP_BASE_URL=https://your-wordpress-site.example
   WP_USERNAME=your-wordpress-username
   WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
   WP_ALLOW_PRODUCTION_WRITES=false

3. 依存関係をインストールします：

   npm install

4. サーバーを実行します：

   $env:NODE_OPTIONS='--use-system-ca'
   npm start

   WindowsでNodeがシステム証明書ストアを必要とする場合、NODE_OPTIONS=--use-system-ca が役立つことがあります。

Related MCP server: mcp-wordpress

ツール

• wordpress_list_pages: WordPressページの一覧を表示します。

• wordpress_get_page: IDでページを取得します。

• wordpress_create_page: ページを作成します（デフォルトは下書きステータス）。

• wordpress_clone_page: 既存のページを複製して新しい下書きページを作成します。

• wordpress_update_page: タイトル、コンテンツ、抜粋、スラッグ、ステータス、親、またはメニュー順序を更新します。

• wordpress_update_page_status: ページステータスのみを更新します。

• wordpress_delete_page: 確認付きでページをゴミ箱へ移動または削除します。

• wordpress_list_posts: WordPress投稿の一覧を表示します。

• wordpress_get_post: IDで投稿を取得します。

• wordpress_create_post: 投稿を作成します（デフォルトは下書きステータス）。

• wordpress_update_post: 投稿を更新します。

• wordpress_delete_post: 確認付きで投稿をゴミ箱へ移動または削除します。

• wordpress_list_media: メディアライブラリのアイテム一覧を表示します。

• wordpress_upload_media: ローカルファイルをメディアライブラリにアップロードします。

• wordpress_list_categories: 投稿カテゴリーの一覧を表示します。

• wordpress_create_category: 投稿カテゴリーを作成します。

• wordpress_list_tags: 投稿タグの一覧を表示します。

• wordpress_create_tag: 投稿タグを作成します。

• wordpress_list_plugins: 認証済みユーザーに権限がある場合、プラグインの一覧を表示します。

• wordpress_update_plugin_status: インストール済みのプラグインを有効化または無効化します。

• wordpress_get_settings: 一般サイト設定を読み取ります。

• wordpress_update_settings: 選択した一般サイト設定を更新します。

• wordpress_list_users: 認証済みユーザーに権限がある場合、ユーザーの一覧を表示します。

• wordpress_list_menus: RESTエンドポイントが利用可能な場合、メニューの一覧を表示します。

• wordpress_list_menu_items: RESTエンドポイントが利用可能な場合、メニューアイテムの一覧を表示します。

• wordpress_rest_request: 高度なREST APIエスケープハッチ。

書き込みツールはステージングURLで有効になっています。WP_BASE_URL が本番環境に変更された場合、.env で WP_ALLOW_PRODUCTION_WRITES=true が設定されていない限り、書き込みはブロックされます。

他のWordPressサイトを使用する

そのWordPressサイトの管理画面でアプリケーションパスワードを作成し、.env を更新します：

WP_BASE_URL=https://another-wordpress-site.example
WP_USERNAME=your-wordpress-username
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
WP_ALLOW_PRODUCTION_WRITES=false

本番URLで意図的に書き込みツールを有効にしたい場合を除き、WP_ALLOW_PRODUCTION_WRITES=false を維持してください。

他の人に移植する

1. この ItchWPMCP フォルダーを相手のコンピューターにコピーするか、プライベート/パブリックリポジトリとして公開します。

2. フォルダー内で npm install を実行します。

3. .env.example から .env ファイルを作成します。

4. 相手のWordPress管理画面でアプリケーションパスワードを作成します： ユーザー -> プロフィール -> アプリケーションパスワード

5. 相手のサイトURL、ユーザー名、アプリパスワードを .env に入力します。

6. 相手のMCPクライアントにMCPサーバーを登録します。

.env ファイルをコミットしないでください。アプリケーションパスワードは各ユーザー/サイトのローカルに保持する必要があります。

Codex設定

~/.codex/config.toml に以下を追加します：

[mcp_servers.itch_wp_mcp]
command = "node"
args = ["C:\\path\\to\\ItchWPMCP\\src\\server.js"]
enabled = true
startup_timeout_sec = 20
tool_timeout_sec = 60

[mcp_servers.itch_wp_mcp.env]
WP_BASE_URL = "https://your-wordpress-site.example"
WP_USERNAME = "your-wordpress-username"
WP_APP_PASSWORD = "xxxx xxxx xxxx xxxx xxxx xxxx"
WP_ALLOW_PRODUCTION_WRITES = "false"
NODE_OPTIONS = "--use-system-ca"

Windowsでは、Nodeのフルパスを使用する方が信頼性が高い場合があります：

command = "C:\\Program Files\\nodejs\\node.exe"

Claude Desktop設定

Claude Desktopの claude_desktop_config.json の mcpServers に以下を追加します：

{
  "mcpServers": {
    "itch_wp_mcp": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\path\\to\\ItchWPMCP\\src\\server.js"
      ],
      "env": {
        "WP_BASE_URL": "https://your-wordpress-site.example",
        "WP_USERNAME": "your-wordpress-username",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WP_ALLOW_PRODUCTION_WRITES": "false",
        "NODE_OPTIONS": "--use-system-ca"
      }
    }
  }
}

Windowsの場合、Claude Desktopの設定は通常ここにあります：

%APPDATA%\Claude\claude_desktop_config.json

設定を変更した後は、Claude Desktopを再起動してください。

マルチサイト設定

すべてのWordPressサイトに対して個別のItchWPMCPコピーは必要ありません。コードベースを1つ保持し、それぞれ異なる環境変数を持つ複数のMCPサーバーを登録してください。

Codexマルチサイトの例

[mcp_servers.wp_erm_staging]
command = "C:\\Program Files\\nodejs\\node.exe"
args = ["C:\\Users\\hesha\\Documents\\GitHub\\ItchWPMCP\\src\\server.js"]
enabled = true
startup_timeout_sec = 20
tool_timeout_sec = 60

[mcp_servers.wp_erm_staging.env]
WP_BASE_URL = "https://staging.erm.buzzinn.co"
WP_USERNAME = "erm-admin"
WP_APP_PASSWORD = "xxxx xxxx xxxx xxxx xxxx xxxx"
WP_ALLOW_PRODUCTION_WRITES = "false"
NODE_OPTIONS = "--use-system-ca"

[mcp_servers.wp_client_site]
command = "C:\\Program Files\\nodejs\\node.exe"
args = ["C:\\Users\\hesha\\Documents\\GitHub\\ItchWPMCP\\src\\server.js"]
enabled = true
startup_timeout_sec = 20
tool_timeout_sec = 60

[mcp_servers.wp_client_site.env]
WP_BASE_URL = "https://client-site.example"
WP_USERNAME = "client-admin"
WP_APP_PASSWORD = "xxxx xxxx xxxx xxxx xxxx xxxx"
WP_ALLOW_PRODUCTION_WRITES = "false"
NODE_OPTIONS = "--use-system-ca"

Claudeマルチサイトの例

{
  "mcpServers": {
    "wp_erm_staging": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\hesha\\Documents\\GitHub\\ItchWPMCP\\src\\server.js"],
      "env": {
        "WP_BASE_URL": "https://staging.erm.buzzinn.co",
        "WP_USERNAME": "erm-admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WP_ALLOW_PRODUCTION_WRITES": "false",
        "NODE_OPTIONS": "--use-system-ca"
      }
    },
    "wp_client_site": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\hesha\\Documents\\GitHub\\ItchWPMCP\\src\\server.js"],
      "env": {
        "WP_BASE_URL": "https://client-site.example",
        "WP_USERNAME": "client-admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WP_ALLOW_PRODUCTION_WRITES": "false",
        "NODE_OPTIONS": "--use-system-ca"
      }
    }
  }
}

.env ファイルはローカルのフォールバックとしてのみ機能します。CodexまたはClaudeによって提供される場合、サイトごとのMCP環境変数が優先されます。

安全性モデル

• 新しいページ/投稿はデフォルトで draft（下書き）になります。

• 破壊的なツールには confirmDelete=true が必要です。

• WP_ALLOW_PRODUCTION_WRITES=true が設定されていない限り、ステージング環境以外への書き込みはブロックされます。

• wordpress_rest_request は /wp-json/ 以下のパスのみを許可します。