mcp-wordpress 2.4.2 → 2.5.0

package/src/tools/media.ts

@@ -1,30 +1,26 @@
 import * as fs from "fs";
 import { WordPressClient } from "../client/api.js";
-import {
-  MediaQueryParams,
-  UpdateMediaRequest,
-  UploadMediaRequest,
-} from "../types/wordpress.js";
+import { MediaQueryParams, UpdateMediaRequest, UploadMediaRequest } from "../types/wordpress.js";
 import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Comprehensive media management tools for WordPress sites.
- * 
+ *
  * This class provides complete media library functionality including:
  * - Listing media items with advanced filtering and search
  * - Uploading new media files with validation and optimization
  * - Retrieving detailed media information and metadata
  * - Updating media properties like title, description, and alt text
  * - Deleting media items with safety checks
- * 
+ *
  * Supports all WordPress media types including images, videos, audio files,
  * and documents with proper MIME type validation and security checks.
- * 
+ *
  * @example
  * ```typescript
  * const mediaTools = new MediaTools();
  * const tools = mediaTools.getTools();
- * 
+ *
  * // Upload an image
  * const client = new WordPressClient(config);
  * const result = await mediaTools.handleUploadMedia(client, {
@@ -33,29 +29,34 @@ import { getErrorMessage } from "../utils/error.js";
  *   alt_text: "Description of the image"
  * });
  * ```
- * 
+ *
  * @since 1.0.0
  * @author MCP WordPress Team
  */
 export class MediaTools {
   /**
    * Retrieves the complete list of media management tools available for MCP.
-   * 
+   *
    * Returns an array of tool definitions for comprehensive media library management.
    * Each tool includes parameter validation, security checks, and detailed error handling.
-   * 
+   *
    * @returns {Array<MCPTool>} Array of MCPTool definitions for media management
-   * 
+   *
    * @example
    * ```typescript
    * const mediaTools = new MediaTools();
    * const tools = mediaTools.getTools();
    * console.log(tools.length); // 5 tools: list, get, upload, update, delete
    * ```
-   * 
+   *
    * @since 1.0.0
    */
-  public getTools(): any[] {
+  public getTools(): Array<{
+    name: string;
+    description: string;
+    parameters?: Array<{ name: string; type?: string; description?: string; required?: boolean; enum?: string[]; items?: unknown }>;
+    handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
+  }> {
     return [
       {
         name: "wp_list_media",
@@ -111,8 +112,7 @@ export class MediaTools {
           {
             name: "alt_text",
             type: "string",
-            description:
-              "Alternative text for the media item (for accessibility).",
+            description: "Alternative text for the media item (for accessibility).",
           },
           {
             name: "caption",
@@ -178,8 +178,7 @@ export class MediaTools {
           {
             name: "force",
             type: "boolean",
-            description:
-              "If true, permanently delete. If false, move to trash. Defaults to false.",
+            description: "If true, permanently delete. If false, move to trash. Defaults to false.",
           },
         ],
         handler: this.handleDeleteMedia.bind(this),
@@ -187,35 +186,26 @@ export class MediaTools {
     ];
   }
 
-  public async handleListMedia(
-    client: WordPressClient,
-    params: MediaQueryParams,
-  ): Promise<any> {
+  public async handleListMedia(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const queryParams = params as MediaQueryParams;
     try {
-      const media = await client.getMedia(params);
+      const media = await client.getMedia(queryParams);
       if (media.length === 0) {
         return "No media items found matching the criteria.";
       }
       const content =
         `Found ${media.length} media items:\n\n` +
-        media
-          .map(
-            (m) =>
-              `- ID ${m.id}: **${m.title.rendered}** (${m.mime_type})\n  Link: ${m.source_url}`,
-          )
-          .join("\n");
+        media.map((m) => `- ID ${m.id}: **${m.title.rendered}** (${m.mime_type})\n  Link: ${m.source_url}`).join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list media: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleGetMedia(
-    client: WordPressClient,
-    params: { id: number },
-  ): Promise<any> {
+  public async handleGetMedia(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const { id } = params as { id: number };
     try {
-      const media = await client.getMediaItem(params.id);
+      const media = await client.getMediaItem(id);
       const content =
         `**Media Details (ID: ${media.id})**\n\n` +
         `- **Title:** ${media.title.rendered}\n` +
@@ -223,9 +213,7 @@ export class MediaTools {
         `- **Type:** ${media.media_type} (${media.mime_type})\n` +
         `- **Date:** ${new Date(media.date).toLocaleString()}\n` +
         (media.alt_text ? `- **Alt Text:** ${media.alt_text}\n` : "") +
-        (media.caption.rendered
-          ? `- **Caption:** ${media.caption.rendered}\n`
-          : "");
+        (media.caption.rendered ? `- **Caption:** ${media.caption.rendered}\n` : "");
       return content;
     } catch (error) {
       throw new Error(`Failed to get media item: ${getErrorMessage(error)}`);
@@ -234,14 +222,15 @@ export class MediaTools {
 
   public async handleUploadMedia(
     client: WordPressClient,
-    params: UploadMediaRequest & { file_path: string },
-  ): Promise<any> {
+    params: Record<string, unknown>,
+  ): Promise<unknown> {
+    const uploadParams = params as unknown as UploadMediaRequest & { file_path: string };
     try {
-      if (!fs.existsSync(params.file_path)) {
-        throw new Error(`File not found at path: ${params.file_path}`);
+      if (!fs.existsSync(uploadParams.file_path)) {
+        throw new Error(`File not found at path: ${uploadParams.file_path}`);
       }
 
-      const media = await client.uploadMedia(params);
+      const media = await client.uploadMedia(uploadParams);
       return `✅ Media uploaded successfully!\n- ID: ${media.id}\n- Title: ${media.title.rendered}\n- URL: ${media.source_url}`;
     } catch (error) {
       throw new Error(`Failed to upload media: ${getErrorMessage(error)}`);
@@ -250,24 +239,23 @@ export class MediaTools {
 
   public async handleUpdateMedia(
     client: WordPressClient,
-    params: UpdateMediaRequest & { id: number },
-  ): Promise<any> {
+    params: Record<string, unknown>,
+  ): Promise<unknown> {
+    const updateParams = params as unknown as UpdateMediaRequest & { id: number };
     try {
-      const media = await client.updateMedia(params);
+      const media = await client.updateMedia(updateParams);
       return `✅ Media ${media.id} updated successfully.`;
     } catch (error) {
       throw new Error(`Failed to update media: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleDeleteMedia(
-    client: WordPressClient,
-    params: { id: number; force?: boolean },
-  ): Promise<any> {
+  public async handleDeleteMedia(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const { id, force } = params as { id: number; force?: boolean };
     try {
-      await client.deleteMedia(params.id, params.force);
-      const action = params.force ? "permanently deleted" : "moved to trash";
-      return `✅ Media item ${params.id} has been ${action}.`;
+      await client.deleteMedia(id, force);
+      const action = force ? "permanently deleted" : "moved to trash";
+      return `✅ Media item ${id} has been ${action}`;
     } catch (error) {
       throw new Error(`Failed to delete media: ${getErrorMessage(error)}`);
     }

package/src/tools/pages.ts

@@ -1,9 +1,5 @@
 import { WordPressClient } from "../client/api.js";
-import {
-  CreatePostRequest,
-  PostQueryParams,
-  UpdatePostRequest,
-} from "../types/wordpress.js";
+import { CreatePageRequest, PostQueryParams as PageQueryParams, UpdatePageRequest } from "../types/wordpress.js";
 import { getErrorMessage } from "../utils/error.js";
 
 /**
@@ -15,7 +11,12 @@ export class PageTools {
    * Retrieves the list of page management tools.
    * @returns An array of MCPTool definitions.
    */
-  public getTools(): any[] {
+  public getTools(): Array<{
+    name: string;
+    description: string;
+    parameters?: Array<{ name: string; type?: string; description?: string; required?: boolean; enum?: string[]; items?: unknown }>;
+    handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
+  }> {
     return [
       {
         name: "wp_list_pages",
@@ -119,8 +120,7 @@ export class PageTools {
           {
             name: "force",
             type: "boolean",
-            description:
-              "If true, permanently delete. If false, move to trash. Defaults to false.",
+            description: "If true, permanently delete. If false, move to trash. Defaults to false.",
           },
         ],
         handler: this.handleDeletePage.bind(this),
@@ -141,35 +141,26 @@ export class PageTools {
     ];
   }
 
-  public async handleListPages(
-    client: WordPressClient,
-    params: PostQueryParams,
-  ): Promise<any> {
+  public async handleListPages(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const queryParams = params as unknown as PageQueryParams;
     try {
-      const pages = await client.getPages(params);
+      const pages = await client.getPages(queryParams);
       if (pages.length === 0) {
         return "No pages found matching the criteria.";
       }
       const content =
         `Found ${pages.length} pages:\n\n` +
-        pages
-          .map(
-            (p) =>
-              `- ID ${p.id}: **${p.title.rendered}** (${p.status})\n  Link: ${p.link}`,
-          )
-          .join("\n");
+        pages.map((p) => `- ID ${p.id}: **${p.title.rendered}** (${p.status})\n  Link: ${p.link}`).join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list pages: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleGetPage(
-    client: WordPressClient,
-    params: { id: number },
-  ): Promise<any> {
+  public async handleGetPage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const { id } = params as { id: number };
     try {
-      const page = await client.getPage(params.id);
+      const page = await client.getPage(id);
       const content =
         `**Page Details (ID: ${page.id})**\n\n` +
         `- **Title:** ${page.title.rendered}\n` +
@@ -182,65 +173,52 @@ export class PageTools {
     }
   }
 
-  public async handleCreatePage(
-    client: WordPressClient,
-    params: CreatePostRequest,
-  ): Promise<any> {
+  public async handleCreatePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const createParams = params as unknown as CreatePageRequest;
     try {
-      const page = await client.createPage(params);
+      const page = await client.createPage(createParams);
       return `✅ Page created successfully!\n- ID: ${page.id}\n- Title: ${page.title.rendered}\n- Link: ${page.link}`;
     } catch (error) {
       throw new Error(`Failed to create page: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleUpdatePage(
-    client: WordPressClient,
-    params: UpdatePostRequest & { id: number },
-  ): Promise<any> {
+  public async handleUpdatePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const updateParams = params as unknown as UpdatePageRequest & { id: number };
     try {
-      const page = await client.updatePage(params);
+      const page = await client.updatePage(updateParams);
       return `✅ Page ${page.id} updated successfully.`;
     } catch (error) {
       throw new Error(`Failed to update page: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleDeletePage(
-    client: WordPressClient,
-    params: { id: number; force?: boolean },
-  ): Promise<any> {
+  public async handleDeletePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const { id, force } = params as { id: number; force?: boolean };
     try {
-      await client.deletePage(params.id, params.force);
+      await client.deletePage(id, force);
       const action = params.force ? "permanently deleted" : "moved to trash";
-      return `✅ Page ${params.id} has been ${action}.`;
+      return `✅ Page ${id} has been ${action}.`;
     } catch (error) {
       throw new Error(`Failed to delete page: ${getErrorMessage(error)}`);
     }
   }
 
-  public async handleGetPageRevisions(
-    client: WordPressClient,
-    params: { id: number },
-  ): Promise<any> {
+  public async handleGetPageRevisions(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+    const { id } = params as { id: number };
     try {
-      const revisions = await client.getPageRevisions(params.id);
+      const revisions = await client.getPageRevisions(id);
       if (revisions.length === 0) {
-        return `No revisions found for page ${params.id}.`;
+        return `No revisions found for page ${id}.`;
       }
       const content =
-        `Found ${revisions.length} revisions for page ${params.id}:\n\n` +
+        `Found ${revisions.length} revisions for page ${id}:\n\n` +
         revisions
-          .map(
-            (r) =>
-              `- Revision by user ID ${r.author} at ${new Date(r.modified).toLocaleString()}`,
-          )
+          .map((r) => `- Revision by user ID ${r.author} at ${new Date(r.modified).toLocaleString()}`)
           .join("\n");
       return content;
     } catch (error) {
-      throw new Error(
-        `Failed to get page revisions: ${getErrorMessage(error)}`,
-      );
+      throw new Error(`Failed to get page revisions: ${getErrorMessage(error)}`);
     }
   }
 }