friday-mcp-v2 3.1.2 → 3.1.3

package/dist/wordpress-api.js

@@ -414,10 +414,12 @@ export class FridayWPClient {
      * @param {Buffer} fileBuffer 画像バイナリ
      * @param {string} filename WordPress 上のファイル名（拡張子付き）
      * @param {string} contentType MIME type (e.g. image/jpeg)
+     * @param {{timeoutMs?: number}} options timeout options
      * @returns {object} WP media オブジェクト
      */
-    async uploadMedia(fileBuffer, filename, contentType) {
+    async uploadMedia(fileBuffer, filename, contentType, { timeoutMs } = {}) {
         const url = `${this.wpUrl.replace(/\/$/, '')}/wp-json/wp/v2/media`;
+        const signal = timeoutMs ? AbortSignal.timeout(timeoutMs) : undefined;
         const res = await fetch(url, {
             method: 'POST',
             headers: {
@@ -425,6 +427,7 @@ export class FridayWPClient {
                 'Content-Disposition': `attachment; filename="${encodeURIComponent(filename)}"`,
                 'Content-Type': contentType,
             },
+            signal,
             body: fileBuffer,
         });
         const text = await res.text();
@@ -455,6 +458,42 @@ export class FridayWPClient {
         });
     }
 
+    /**
+     * メディア単体を取得
+     * @param {number} mediaId メディアID
+     * @returns {object} WP media オブジェクト
+     */
+    async getMedia(mediaId) {
+        return this.wpCoreRequest(`/wp/v2/media/${mediaId}`);
+    }
+
+    /**
+     * メディアを ID 配列で取得
+     * 100件超は 100件チャンクに分割して取得しマージする (Phase 2 列挙パス)。
+     * @param {number[]|number} mediaIds メディアID配列
+     * @param {object} [options]
+     * @param {string} [options.mediaType] 'image' 等の media_type フィルタ。未指定なら全タイプ
+     *   （move 検証など既存呼び出しは未指定で全タイプ検証を維持する）
+     * @returns {object[]} WP media オブジェクト配列
+     */
+    async getMediaByIds(mediaIds, { mediaType } = {}) {
+        const ids = Array.isArray(mediaIds) ? mediaIds : [mediaIds];
+        if (ids.length === 0) return [];
+        const CHUNK = 100;
+        const out = [];
+        for (let i = 0; i < ids.length; i += CHUNK) {
+            const chunk = ids.slice(i, i + CHUNK);
+            const params = new URLSearchParams({
+                include: chunk.join(','),
+                per_page: String(chunk.length),
+            });
+            if (mediaType) params.set('media_type', mediaType);
+            const res = await this.wpCoreRequest(`/wp/v2/media?${params.toString()}`);
+            if (Array.isArray(res)) out.push(...res);
+        }
+        return out;
+    }
+
     /**
      * メディアライブラリを検索（画像のみ）
      * @param {string} query 検索キーワード
@@ -462,13 +501,20 @@ export class FridayWPClient {
      * @returns {object[]} メディアオブジェクト配列
      */
     async searchMedia(query, perPage = 10, includeIds = null) {
+        const hasInclude = Array.isArray(includeIds) && includeIds.length > 0;
+        // include 指定(スコープ検索)時のみ最大100。グローバル検索は 1-20 契約を維持 (#9)
+        const cap = hasInclude ? 100 : 20;
         const params = new URLSearchParams({
             media_type: 'image',
-            per_page: String(Math.min(Math.max(1, perPage), 20)),
+            per_page: String(Math.min(Math.max(1, perPage), cap)),
         });
         if (query) params.set('search', query);
-        if (includeIds && includeIds.length > 0) {
-            params.set('include', includeIds.slice(0, 100).join(','));
+        if (hasInclude) {
+            // 呼び出し側が 100件チャンクに分割する前提。違反は黙って切らず明示エラー (#10)
+            if (includeIds.length > 100) {
+                throw new Error(`searchMedia の includeIds は100件以下にチャンクして渡してください (受領: ${includeIds.length}件)`);
+            }
+            params.set('include', includeIds.join(','));
         }
         return this.wpCoreRequest(`/wp/v2/media?${params.toString()}`);
     }
@@ -491,6 +537,115 @@ export class FridayWPClient {
         return json.success ? json.data.attachment_ids : null;
     }
 
+    /**
+     * Uncategorized 等の件数取得
+     * @param {number} folderId 0=Uncategorized, -1=全総数, >0=通常フォルダ
+     * @returns {number|null} 件数。token 未設定/失敗時は null
+     */
+    async getFileBirdAttachmentCount(folderId) {
+        if (!this.filebirdToken) return null;
+        const url = `${this.wpUrl}/wp-json/filebird/public/v1/attachment-count/?folder_id=${folderId}&token=${this.filebirdToken}`;
+        const res = await fetch(url);
+        if (!res.ok) return null;
+        const json = await res.json();
+        return json.success ? json.data.count : null;
+    }
+
+    /**
+     * FileBird フォルダ作成
+     * 注意: 親存在検証なし・同名は "name (1)" 自動リネーム (プラグイン Api.php:103 / Folder.php:453)
+     * @param {string} name フォルダ名
+     * @param {number} parentId 親 folder id (0=ルート)
+     * @returns {object|null} { id } 。token 未設定時は null。失敗時は throw
+     */
+    async createFileBirdFolder(name, parentId = 0) {
+        if (!this.filebirdToken) return null;
+        const url = `${this.wpUrl}/wp-json/filebird/public/v1/folders?token=${this.filebirdToken}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name, parent_id: parentId }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            const err = new Error(`FileBird createFolder failed (HTTP ${res.status}): ${text.slice(0, 300)}`);
+            err.statusCode = res.status;
+            throw err;
+        }
+        const json = await res.json();
+        return json.success ? json.data : null;
+    }
+
+    /**
+     * 添付メディアをフォルダに割り当て
+     * 注意: folder は数値 id のみ (パス不可)・ID 存在検証なし・folder=-1 も通過 (プラグイン Api.php:117)
+     * @param {number[]|number} ids 添付 ID (配列または単一)
+     * @param {number} folderId 割当先 folder id
+     * @returns {boolean|null} 成否。token 未設定時は null。失敗時は throw
+     */
+    async setFileBirdAttachmentFolder(ids, folderId) {
+        if (!this.filebirdToken) return null;
+        const url = `${this.wpUrl}/wp-json/filebird/public/v1/folder/set-attachment?token=${this.filebirdToken}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ ids, folder: folderId }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            const err = new Error(`FileBird setAttachment failed (HTTP ${res.status}): ${text.slice(0, 300)}`);
+            err.statusCode = res.status;
+            throw err;
+        }
+        const json = await res.json();
+        return json.success === true;
+    }
+
+    // ========================================
+    // FileBird フォルダ rename / delete (Phase 3)
+    // admin namespace filebird/v1 を App Password (wpCoreRequest) で叩く。
+    // public token は使わない (認証主体を実行ユーザーに統一)。
+    // ========================================
+
+    /**
+     * FileBird フォルダツリー取得 (admin namespace)
+     * public getFileBirdFolders と別経路。tree はノードに data-count を持たず、
+     * 件数は attachmentsCount で別途返る (呼び出し側で id マージする)。
+     * @returns {{ tree: object[], allAttachmentsCount: number, attachmentsCount: object }}
+     */
+    async getFileBirdFoldersAdmin() {
+        return this.wpCoreRequest('/filebird/v1/get-folders');
+    }
+
+    /**
+     * FileBird フォルダ名変更 (admin namespace)
+     * 注意: parent は移動用ではなく重複チェック用。現在の parentId をそのまま渡す。
+     * @param {number} folderId 対象フォルダ id
+     * @param {number} currentParentId 現在の親 id (重複チェック用)
+     * @param {string} newName 新フォルダ名
+     * @returns {boolean} 成功時 true。同名時は WP_Error('folder_name_exist') が throw される
+     */
+    async renameFileBirdFolder(folderId, currentParentId, newName) {
+        return this.wpCoreRequest('/filebird/v1/update-folder', {
+            method: 'POST',
+            body: JSON.stringify({ id: folderId, parent: currentParentId, title: newName }),
+        });
+    }
+
+    /**
+     * FileBird フォルダ削除 (admin namespace)
+     * FileBird 側で子フォルダへ再帰カスケード削除する (ids は単一で渡す)。
+     * 添付ファイル本体は削除されず Uncategorized に残る (fbv / fbv_attachment_folder のみ削除)。
+     * @param {number} folderId 対象フォルダ id
+     * @returns {object} countAttachments 構造 (削除後の件数)
+     */
+    async deleteFileBirdFolder(folderId) {
+        return this.wpCoreRequest('/filebird/v1/delete-folder', {
+            method: 'POST',
+            body: JSON.stringify({ ids: [folderId] }),
+        });
+    }
+
     // ========================================
     // ASP Link Management
     // ========================================
@@ -512,6 +667,28 @@ export class FridayWPClient {
         });
     }
 
+    async updateAspLink(id, data) {
+        return this.request(`/asp-links/${id}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+
+    async bulkCreateAspLinks(items) {
+        return this.request('/asp-links/bulk', {
+            method: 'POST',
+            body: JSON.stringify({ items }),
+        });
+    }
+
+    async resolveAspLinksBulk(aspIds) {
+        const list = Array.isArray(aspIds) ? aspIds : [];
+        if (list.length === 0) return { items: {} };
+        const query = new URLSearchParams();
+        query.set('asp_ids', list.join(','));
+        return this.request(`/asp-links/bulk?${query.toString()}`);
+    }
+
     /**
      * 設定オブジェクトからインスタンスを生成（ConnectionRegistry 用）
      * @param {{ url: string, user: string, pass: string }} config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "friday-mcp-v2",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "description": "WordPress MCP Server for Claude Code - REST API direct communication",
   "type": "module",
   "main": "dist/mcp-server.js",
@@ -21,11 +21,14 @@
   ],
   "author": "",
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "marked": "^15.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "marked": "^18.0.3",
     "node-fetch": "^3.3.2",
     "node-html-parser": "^7.1.0",
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
   }
 }