WordPress MCP Server

WordPress MCP サーバー

WordPress サイトにコンテンツを公開できる Machine Communication Protocol（MCP）サーバーです。

機能

• WordPress に記事を公開
• WordPress への接続をテスト
• WordPress のカテゴリーやタグを作成、取得、管理
• 公開時にカテゴリーやタグを自動的に作成
• URL または Base64 エンコードされたデータによるアイキャッチ画像のサポート
• スタンドアロンの FastAPI サーバーと MCP サーバーの両方として動作
• WordPress の認証情報に対応した環境変数のサポート

セットアップ

1. UV を使用して仮想環境を作成します：

   uv venv
   .venv\Scripts\activate
   

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

   uv pip install -r requirements.txt
   

3. WordPress の認証情報を設定します：

   • .env.example を .env に名前変更します（または新しい .env ファイルを作成します）
   • WordPress サイトの URL、ユーザー名、アプリケーションパスワードを設定します

使い方

MCP サーバーとして

サーバーを MCP モードで実行します：

python main.py --mcp

スタンドアロン API として

サーバーをスタンドアロンの FastAPI アプリケーションとして実行します：

python main.py

API は http://localhost:8000 で利用できます

API エンドポイント

• GET / - ルートエンドポイント
• GET /wp-config - 環境変数から WordPress の設定を取得
• POST /get-categories - WordPress のすべてのカテゴリーを取得
• POST /get-tags - WordPress のすべてのタグを取得
• POST /test-connection - WordPress への接続をテスト
• POST /publish-article - WordPress に記事を公開

MCP ツール

• PUBLISH_ARTICLE - カテゴリー ID とタグ ID を指定して WordPress に記事を公開
• PREPARE_ARTICLE_METADATA - 既存のカテゴリーとタグを確認し、存在しない場合は作成して、それらの ID を返す
• TEST_CONNECTION - WordPress サイトへの接続をテスト

カテゴリーとタグの管理

WordPress MCP サーバーでは、高度なカテゴリーとタグの管理に対応しました：

PREPARE_ARTICLE_METADATA の使用

このツールでは、次のことができます：

1. WordPress サイトにカテゴリーとタグが存在するか確認する
2. 存在しないカテゴリーやタグを自動的に作成する
3. PUBLISH_ARTICLE で使用するすべてのカテゴリーとタグの ID を返す

ワークフローの例：

1. カテゴリー名とタグ名を指定して PREPARE_ARTICLE_METADATA を呼び出す
2. 対応する ID を受け取る
3. その ID を使って PUBLISH_ARTICLE を呼び出し、コンテンツを公開する

アイキャッチ画像のサポート

WordPress MCP サーバーでは、記事へのアイキャッチ画像の追加に対応しました：

画像を指定して PUBLISH_ARTICLE を使用する

次の 2 つの方法で、記事にアイキャッチ画像を追加できます：

1. URL を使用：画像への直接リンクを指定した image_url パラメーターを指定します

   "image_url": "https://example.com/path/to/image.jpg"
   

2. Base64 を使用：Base64 エンコードされた画像データを指定した image_base64 パラメーターを指定します

   "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
   

3. カスタムファイル名：必要に応じて、アップロードする画像のファイル名を指定します

   "image_filename": "my-custom-image-name.jpg"
   

サーバーは次の処理を行います：

• 画像をダウンロードする（URL が指定されている場合）か、Base64 データをデコードします
• 画像を WordPress にアップロードします
• 記事のアイキャッチ画像として設定します
• レスポンスにメディア ID を含めて返します

スタンドアロン API の使用

スタンドアロン API を使用する場合、次のいずれかの方法でアイキャッチ画像を指定できます：

• image フォームフィールドを使ったファイルのアップロード
• image_url フォームフィールドを使った URL の指定

環境変数のサポート

すべてのツールで、.env ファイルの環境変数をデフォルト値として使用できるようになりました：

• WP_SITE_URL - WordPress サイトの URL
• WP_USERNAME - WordPress のユーザー名
• WP_PASSWORD - WordPress のアプリケーションパスワード

環境変数に設定されていれば、これらのパラメーターを明示的に指定せずにツールを呼び出せます。