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

2. 依存関係のインストール:

npm install

3. 環境設定:

cp .env.example .env
# .envファイルを編集してWordPressの認証情報を設定

4. ビルド:

npm run build

5. サーバー起動:

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. 大容量ファイルのアップロード失敗:

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

デバッグモード

詳細ログを有効にする：

npm run debug-mcp

📊 パフォーマンス比較

🤝 貢献

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

開発環境セットアップ

1. サブモジュール付きクローン:

git clone --recursive [your-repo-url]

2. 依存関係のインストール:

npm install

3. 開発モード:

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ファイルを参照してください。

🙏 謝辞

• **@prathammanocha** - オリジナルのwordpress-mcp-server
• WordPress REST API チーム - 優秀なドキュメント
• Model Context Protocol 仕様作成者

🔗 関連プロジェクト

• オリジナルサーバー: prathammanocha/wordpress-mcp-server
• MCP SDK: @modelcontextprotocol/sdk

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