Wordpress MCP Server Zrt

🚀 WordPress MCP サーバー

WordPressウェブサイトにコンテンツを公開できるマシン通信プロトコル（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 / - ルートエンドポイント
• POST /wp-config - 環境変数からWordPressの設定情報を取得する
• POST /get-categories - すべてのWordPressカテゴリを取得する
• POST /get-tags - すべてのWordPressタグを取得する
• POST /test-connection - WordPressの接続状態をテストする
• POST /publish-article - WordPressに記事を公開する

MCPツール

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

カテゴリとタグの管理

WordPress MCPサーバーは高度なカテゴリとタグの管理をサポートしています。

PREPARE_ARTICLE_METADATAツールの使用

このツールを使うと、以下のことができます。

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

例のワークフロー:

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を使用する: image_base64パラメータを提供し、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 - あなたのアプリケーションパスワード

これは、環境変数に設定されている限り、パラメータを明示的に提供せずにツールを呼び出すことができることを意味します。