MCP WordPress Post Server

Manage WordPress posts and upload images directly from file paths.

GitHub

MCP WordPress Post Server

WordPress投稿管理に特化したファイルパス方式画像アップロード機能を持つMCP（Model Context Protocol）サーバーです。

本プロジェクトは@prathammanocha氏の優秀なwordpress-mcp-serverをベースに、画像処理機能を大幅に改善したものです。

✨ 主な機能

🖼️ 高度な画像アップロードシステム

  • ファイルパス方式: ファイルシステムへの直接アクセス（Base64エンコード不要）
  • 大容量ファイル対応: WordPressの制限内でデータ損失なしに処理
  • multipart/form-data: WordPress標準メディアアップロードAPI使用
  • 自動最適化: WordPress内蔵画像処理機能を活用
  • レスポンシブ画像: 異なる画面サイズ用のsrcsetを自動生成

📝 投稿管理機能

  • 投稿作成: 複数画像添付対応
  • 投稿更新: 既存投稿の編集
  • 投稿一覧: ページネーション対応
  • 投稿詳細取得: フルコンテンツ表示
  • 下書き/公開ワークフロー: ステータス管理

🔧 技術的改善点

  • メモリ使用量33%削減: Base64エンコードの排除
  • データ整合性: Base64方式で発生していた95-98%のデータ損失を解決
  • エラーハンドリング: ファイル存在確認やアップロード検証の充実
  • デバッグログ: トラブルシューティング用の詳細ログ

🚀 クイックスタート

前提条件

  • Node.js v18以上
  • REST API有効なWordPressサイト
  • WordPressアプリケーションパスワード

インストール

  1. リポジトリのクローン:
git clone [your-repo-url]
cd mcp-wordpress-post
  1. 依存関係のインストール:
npm install
  1. 環境設定:
cp .env.example .env
# .envファイルを編集してWordPressの認証情報を設定
  1. ビルド:
npm run build
  1. サーバー起動:
npm start

📖 使用方法

MCP設定

MCPクライアントの設定ファイルに追加してください：

{
  "mcpServers": {
    "wordpress-post": {
      "command": "node",
      "args": ["/path/to/mcp-wordpress-post/build/posts-only.js"]
    }
  }
}

画像付き投稿の作成

改善された画像アップロードシステムではファイルパスを使用します：

// 新しいファイルパス方式（推奨）
{
  "tool": "create-post",
  "title": "画像付きの投稿",
  "content": "この画像をご覧ください: {IMAGE1}",
  "images": [{
    "filePath": "/絶対パス/to/image.png",
    "filename": "カスタム名.png", // 省略可能
    "placeholder": "{IMAGE1}"
  }]
}

利用可能なツール

create-post

画像添付対応の新規WordPress投稿作成

パラメータ:

  • siteUrl (文字列): WordPressサイトURL
  • username (文字列): WordPressユーザー名
  • password (文字列): アプリケーションパスワード
  • title (文字列): 投稿タイトル
  • content (文字列): 画像プレースホルダーを含む投稿内容
  • status (列挙型): "draft" | "publish" | "private" (デフォルト: "draft")
  • images (配列, 省略可能): filePath、placeholder、省略可能なfilenameを持つ画像オブジェクト

list-posts

ページネーション対応でWordPress投稿を取得

get-post

特定の投稿の詳細情報を取得

update-post

既存のWordPress投稿を更新

🔄 Base64方式からの移行

Base64ベースのシステムから移行する場合：

従来方式（Base64 - 非推奨）:

images: [{
  data: "iVBORw0KGgoAAAANSUhEUgAAAAE...", // 大きなBase64文字列
  filename: "image.png",
  placeholder: "{IMAGE1}"
}]

新方式（ファイルパス - 現在）:

images: [{
  filePath: "/path/to/image.png",              // ファイルシステムパス
  filename: "カスタム名.png",                  // 省略可能なカスタム名
  placeholder: "{IMAGE1}"
}]

🐛 トラブルシューティング

よくある問題

  1. ファイルが見つからないエラー:

    • ファイルパスが絶対パスであることを確認
    • ファイルのアクセス権限を確認

  2. 大容量ファイルのアップロード失敗:

    • WordPressのupload_max_filesize設定を確認
    • post_max_sizeとmemory_limitを確認

  3. 画像が表示されない:

    • プレースホルダーの形式が正確に一致していることを確認
    • /tmp/mcp-debug.logのデバッグログを確認

デバッグモード

詳細ログを有効にする：

npm run debug-mcp

📊 パフォーマンス比較

項目Base64方式ファイルパス方式
メモリ使用量高い (+33%)効率的
データ損失大容量ファイルで95-98%0%
処理速度遅い高速
ファイルサイズ制限実用的には~100KBWordPress制限まで

🤝 貢献

このプロジェクトはprathammanocha/wordpress-mcp-serverの基盤の上に構築されています。

開発環境セットアップ

  1. サブモジュール付きクローン:
git clone --recursive [your-repo-url]
  1. 依存関係のインストール:
npm install
  1. 開発モード:
npm run dev

テスト

機能をテストするためのデバッグスクリプトを実行：

npm run debug-playwright  # WordPress統合テスト
npm run debug-mcp        # MCPサーバーテスト

📊 解決された問題

Base64方式の問題点

  • 98%のデータ損失: 85KB → 1.5KB という深刻な問題
  • メモリ効率の悪さ: 33%の無駄なメモリ使用
  • 処理速度の低下: エンコード/デコード処理のオーバーヘッド

ファイルパス方式の利点

  • データ損失ゼロ: 85KB → 50KB（正常な最適化）
  • メモリ効率: Base64エンコード処理の排除
  • 高速処理: ファイル直接読み取りによる高速化
  • 安定性: WordPress標準API使用による安定動作

📄 ライセンス

MIT License - 詳細はLICENSEファイルを参照してください。

🙏 謝辞

🔗 関連プロジェクト

より良いWordPress自動化のために ❤️ で作成

Server Terkait