mcp-wordpress 1.2.2 → 1.3.0

package/src/tools/comments.ts

@@ -1,10 +1,10 @@
-import { WordPressClient } from '../client/api.js';
+import { WordPressClient } from "../client/api.js";
 import {
   CommentQueryParams,
   CreateCommentRequest,
-  UpdateCommentRequest
-} from '../types/wordpress.js';
-import { getErrorMessage } from '../utils/error.js';
+  UpdateCommentRequest,
+} from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides tools for managing comments on a WordPress site.
@@ -18,155 +18,155 @@ export class CommentTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_list_comments',
-        description: 'Lists comments from a WordPress site, with filters.',
+        name: "wp_list_comments",
+        description: "Lists comments from a WordPress site, with filters.",
         parameters: [
           {
-            name: 'post',
-            type: 'number',
+            name: "post",
+            type: "number",
             description:
-              'Limit results to comments assigned to a specific post ID.'
+              "Limit results to comments assigned to a specific post ID.",
           },
           {
-            name: 'status',
-            type: 'string',
-            description: 'Filter by comment status.',
-            enum: ['hold', 'approve', 'spam', 'trash']
-          }
+            name: "status",
+            type: "string",
+            description: "Filter by comment status.",
+            enum: ["hold", "approve", "spam", "trash"],
+          },
         ],
-        handler: this.handleListComments.bind(this)
+        handler: this.handleListComments.bind(this),
       },
       {
-        name: 'wp_get_comment',
-        description: 'Retrieves a single comment by its ID.',
+        name: "wp_get_comment",
+        description: "Retrieves a single comment by its ID.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The unique identifier for the comment.'
-          }
+            description: "The unique identifier for the comment.",
+          },
         ],
-        handler: this.handleGetComment.bind(this)
+        handler: this.handleGetComment.bind(this),
       },
       {
-        name: 'wp_create_comment',
-        description: 'Creates a new comment on a post.',
+        name: "wp_create_comment",
+        description: "Creates a new comment on a post.",
         parameters: [
           {
-            name: 'post',
-            type: 'number',
+            name: "post",
+            type: "number",
             required: true,
-            description: 'The ID of the post to comment on.'
+            description: "The ID of the post to comment on.",
           },
           {
-            name: 'content',
-            type: 'string',
+            name: "content",
+            type: "string",
             required: true,
-            description: 'The content of the comment.'
+            description: "The content of the comment.",
           },
           {
-            name: 'author_name',
-            type: 'string',
-            description: 'The name of the comment author.'
+            name: "author_name",
+            type: "string",
+            description: "The name of the comment author.",
           },
           {
-            name: 'author_email',
-            type: 'string',
-            description: 'The email of the comment author.'
-          }
+            name: "author_email",
+            type: "string",
+            description: "The email of the comment author.",
+          },
         ],
-        handler: this.handleCreateComment.bind(this)
+        handler: this.handleCreateComment.bind(this),
       },
       {
-        name: 'wp_update_comment',
-        description: 'Updates an existing comment.',
+        name: "wp_update_comment",
+        description: "Updates an existing comment.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the comment to update.'
+            description: "The ID of the comment to update.",
           },
           {
-            name: 'content',
-            type: 'string',
-            description: 'The updated content for the comment.'
+            name: "content",
+            type: "string",
+            description: "The updated content for the comment.",
           },
           {
-            name: 'status',
-            type: 'string',
-            description: 'The new status for the comment.',
-            enum: ['hold', 'approve', 'spam', 'trash']
-          }
+            name: "status",
+            type: "string",
+            description: "The new status for the comment.",
+            enum: ["hold", "approve", "spam", "trash"],
+          },
         ],
-        handler: this.handleUpdateComment.bind(this)
+        handler: this.handleUpdateComment.bind(this),
       },
       {
-        name: 'wp_delete_comment',
-        description: 'Deletes a comment.',
+        name: "wp_delete_comment",
+        description: "Deletes a comment.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the comment to delete.'
+            description: "The ID of the comment to delete.",
           },
           {
-            name: 'force',
-            type: 'boolean',
+            name: "force",
+            type: "boolean",
             description:
-              'If true, the comment will be permanently deleted. Defaults to false (moved to trash).'
-          }
+              "If true, the comment will be permanently deleted. Defaults to false (moved to trash).",
+          },
         ],
-        handler: this.handleDeleteComment.bind(this)
+        handler: this.handleDeleteComment.bind(this),
       },
       {
-        name: 'wp_approve_comment',
-        description: 'Approves a pending comment.',
+        name: "wp_approve_comment",
+        description: "Approves a pending comment.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the comment to approve.'
-          }
+            description: "The ID of the comment to approve.",
+          },
         ],
-        handler: this.handleApproveComment.bind(this)
+        handler: this.handleApproveComment.bind(this),
       },
       {
-        name: 'wp_spam_comment',
-        description: 'Marks a comment as spam.',
+        name: "wp_spam_comment",
+        description: "Marks a comment as spam.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the comment to mark as spam.'
-          }
+            description: "The ID of the comment to mark as spam.",
+          },
         ],
-        handler: this.handleSpamComment.bind(this)
-      }
+        handler: this.handleSpamComment.bind(this),
+      },
     ];
   }
 
   public async handleListComments(
     client: WordPressClient,
-    params: CommentQueryParams
+    params: CommentQueryParams,
   ): Promise<any> {
     try {
       const comments = await client.getComments(params);
       if (comments.length === 0) {
-        return 'No comments found matching the criteria.';
+        return "No comments found matching the criteria.";
       }
       const content =
         `Found ${comments.length} comments:\n\n` +
         comments
           .map(
             (c) =>
-              `- ID ${c.id}: By **${c.author_name}** on Post ${c.post} (${c.status})\n  > ${c.content.rendered.substring(0, 100)}...`
+              `- ID ${c.id}: By **${c.author_name}** on Post ${c.post} (${c.status})\n  > ${c.content.rendered.substring(0, 100)}...`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list comments: ${getErrorMessage(error)}`);
@@ -175,7 +175,7 @@ export class CommentTools {
 
   public async handleGetComment(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const comment = await client.getComment(params.id);
@@ -194,7 +194,7 @@ export class CommentTools {
 
   public async handleCreateComment(
     client: WordPressClient,
-    params: CreateCommentRequest
+    params: CreateCommentRequest,
   ): Promise<any> {
     try {
       const comment = await client.createComment(params);
@@ -206,7 +206,7 @@ export class CommentTools {
 
   public async handleUpdateComment(
     client: WordPressClient,
-    params: UpdateCommentRequest & { id: number }
+    params: UpdateCommentRequest & { id: number },
   ): Promise<any> {
     try {
       const comment = await client.updateComment(params);
@@ -218,11 +218,11 @@ export class CommentTools {
 
   public async handleDeleteComment(
     client: WordPressClient,
-    params: { id: number; force?: boolean }
+    params: { id: number; force?: boolean },
   ): Promise<any> {
     try {
       await client.deleteComment(params.id, params.force);
-      const action = params.force ? 'permanently deleted' : 'moved to trash';
+      const action = params.force ? "permanently deleted" : "moved to trash";
       return `✅ Comment ${params.id} has been ${action}.`;
     } catch (error) {
       throw new Error(`Failed to delete comment: ${getErrorMessage(error)}`);
@@ -231,12 +231,12 @@ export class CommentTools {
 
   public async handleApproveComment(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const comment = await client.updateComment({
         id: params.id,
-        status: 'approved'
+        status: "approved",
       });
       return `✅ Comment ${comment.id} has been approved.`;
     } catch (error) {
@@ -246,16 +246,18 @@ export class CommentTools {
 
   public async handleSpamComment(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const comment = await client.updateComment({
         id: params.id,
-        status: 'spam'
+        status: "spam",
       });
       return `✅ Comment ${comment.id} has been marked as spam.`;
     } catch (error) {
-      throw new Error(`Failed to mark comment as spam: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to mark comment as spam: ${getErrorMessage(error)}`,
+      );
     }
   }
 }

package/src/tools/index.ts

@@ -1,10 +1,10 @@
-export { default as AuthTools } from './auth.js';
-export { default as CacheTools } from './cache.js';
-export { default as CommentTools } from './comments.js';
-export { default as MediaTools } from './media.js';
-export { default as PageTools } from './pages.js';
-export { default as PerformanceTools } from './performance.js';
-export { default as PostTools } from './posts.js';
-export { default as SiteTools } from './site.js';
-export { default as TaxonomyTools } from './taxonomies.js';
-export { default as UserTools } from './users.js';
+export { default as AuthTools } from "./auth.js";
+export { default as CacheTools } from "./cache.js";
+export { default as CommentTools } from "./comments.js";
+export { default as MediaTools } from "./media.js";
+export { default as PageTools } from "./pages.js";
+export { default as PerformanceTools } from "./performance.js";
+export { default as PostTools } from "./posts.js";
+export { default as SiteTools } from "./site.js";
+export { default as TaxonomyTools } from "./taxonomies.js";
+export { default as UserTools } from "./users.js";

package/src/tools/media.ts

@@ -1,11 +1,11 @@
-import * as fs from 'fs';
-import { WordPressClient } from '../client/api.js';
+import * as fs from "fs";
+import { WordPressClient } from "../client/api.js";
 import {
   MediaQueryParams,
   UpdateMediaRequest,
-  UploadMediaRequest
-} from '../types/wordpress.js';
-import { getErrorMessage } from '../utils/error.js';
+  UploadMediaRequest,
+} from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides tools for managing media on a WordPress site.
@@ -19,152 +19,152 @@ export class MediaTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_list_media',
-        description: 'Lists media items from a WordPress site, with filters.',
+        name: "wp_list_media",
+        description: "Lists media items from a WordPress site, with filters.",
         parameters: [
           {
-            name: 'per_page',
-            type: 'number',
-            description: 'Number of items to return per page (max 100).'
+            name: "per_page",
+            type: "number",
+            description: "Number of items to return per page (max 100).",
           },
           {
-            name: 'search',
-            type: 'string',
-            description: 'Limit results to those matching a search term.'
+            name: "search",
+            type: "string",
+            description: "Limit results to those matching a search term.",
           },
           {
-            name: 'media_type',
-            type: 'string',
-            description: 'Limit results to a specific media type.',
-            enum: ['image', 'video', 'audio', 'application']
-          }
+            name: "media_type",
+            type: "string",
+            description: "Limit results to a specific media type.",
+            enum: ["image", "video", "audio", "application"],
+          },
         ],
-        handler: this.handleListMedia.bind(this)
+        handler: this.handleListMedia.bind(this),
       },
       {
-        name: 'wp_get_media',
-        description: 'Retrieves a single media item by its ID.',
+        name: "wp_get_media",
+        description: "Retrieves a single media item by its ID.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The unique identifier for the media item.'
-          }
+            description: "The unique identifier for the media item.",
+          },
         ],
-        handler: this.handleGetMedia.bind(this)
+        handler: this.handleGetMedia.bind(this),
       },
       {
-        name: 'wp_upload_media',
-        description: 'Uploads a file to the WordPress media library.',
+        name: "wp_upload_media",
+        description: "Uploads a file to the WordPress media library.",
         parameters: [
           {
-            name: 'file_path',
-            type: 'string',
+            name: "file_path",
+            type: "string",
             required: true,
-            description: 'The local, absolute path to the file to upload.'
+            description: "The local, absolute path to the file to upload.",
           },
           {
-            name: 'title',
-            type: 'string',
-            description: 'The title for the media item.'
+            name: "title",
+            type: "string",
+            description: "The title for the media item.",
           },
           {
-            name: 'alt_text',
-            type: 'string',
+            name: "alt_text",
+            type: "string",
             description:
-              'Alternative text for the media item (for accessibility).'
+              "Alternative text for the media item (for accessibility).",
           },
           {
-            name: 'caption',
-            type: 'string',
-            description: 'The caption for the media item.'
+            name: "caption",
+            type: "string",
+            description: "The caption for the media item.",
           },
           {
-            name: 'description',
-            type: 'string',
-            description: 'The description for the media item.'
+            name: "description",
+            type: "string",
+            description: "The description for the media item.",
           },
           {
-            name: 'post',
-            type: 'number',
-            description: 'The ID of a post to attach this media to.'
-          }
+            name: "post",
+            type: "number",
+            description: "The ID of a post to attach this media to.",
+          },
         ],
-        handler: this.handleUploadMedia.bind(this)
+        handler: this.handleUploadMedia.bind(this),
       },
       {
-        name: 'wp_update_media',
-        description: 'Updates the metadata of an existing media item.',
+        name: "wp_update_media",
+        description: "Updates the metadata of an existing media item.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the media item to update.'
+            description: "The ID of the media item to update.",
           },
           {
-            name: 'title',
-            type: 'string',
-            description: 'The new title for the media item.'
+            name: "title",
+            type: "string",
+            description: "The new title for the media item.",
           },
           {
-            name: 'alt_text',
-            type: 'string',
-            description: 'The new alternative text.'
+            name: "alt_text",
+            type: "string",
+            description: "The new alternative text.",
           },
           {
-            name: 'caption',
-            type: 'string',
-            description: 'The new caption.'
+            name: "caption",
+            type: "string",
+            description: "The new caption.",
           },
           {
-            name: 'description',
-            type: 'string',
-            description: 'The new description.'
-          }
+            name: "description",
+            type: "string",
+            description: "The new description.",
+          },
         ],
-        handler: this.handleUpdateMedia.bind(this)
+        handler: this.handleUpdateMedia.bind(this),
       },
       {
-        name: 'wp_delete_media',
-        description: 'Deletes a media item.',
+        name: "wp_delete_media",
+        description: "Deletes a media item.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the media item to delete.'
+            description: "The ID of the media item to delete.",
           },
           {
-            name: 'force',
-            type: 'boolean',
+            name: "force",
+            type: "boolean",
             description:
-              'If true, permanently delete. If false, move to trash. Defaults to false.'
-          }
+              "If true, permanently delete. If false, move to trash. Defaults to false.",
+          },
         ],
-        handler: this.handleDeleteMedia.bind(this)
-      }
+        handler: this.handleDeleteMedia.bind(this),
+      },
     ];
   }
 
   public async handleListMedia(
     client: WordPressClient,
-    params: MediaQueryParams
+    params: MediaQueryParams,
   ): Promise<any> {
     try {
       const media = await client.getMedia(params);
       if (media.length === 0) {
-        return 'No media items found matching the criteria.';
+        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}`
+              `- ID ${m.id}: **${m.title.rendered}** (${m.mime_type})\n  Link: ${m.source_url}`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list media: ${getErrorMessage(error)}`);
@@ -173,7 +173,7 @@ export class MediaTools {
 
   public async handleGetMedia(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const media = await client.getMediaItem(params.id);
@@ -183,10 +183,10 @@ export class MediaTools {
         `- **URL:** ${media.source_url}\n` +
         `- **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.alt_text ? `- **Alt Text:** ${media.alt_text}\n` : "") +
         (media.caption.rendered
           ? `- **Caption:** ${media.caption.rendered}\n`
-          : '');
+          : "");
       return content;
     } catch (error) {
       throw new Error(`Failed to get media item: ${getErrorMessage(error)}`);
@@ -195,7 +195,7 @@ export class MediaTools {
 
   public async handleUploadMedia(
     client: WordPressClient,
-    params: UploadMediaRequest & { file_path: string }
+    params: UploadMediaRequest & { file_path: string },
   ): Promise<any> {
     try {
       if (!fs.existsSync(params.file_path)) {
@@ -211,7 +211,7 @@ export class MediaTools {
 
   public async handleUpdateMedia(
     client: WordPressClient,
-    params: UpdateMediaRequest & { id: number }
+    params: UpdateMediaRequest & { id: number },
   ): Promise<any> {
     try {
       const media = await client.updateMedia(params);
@@ -223,11 +223,11 @@ export class MediaTools {
 
   public async handleDeleteMedia(
     client: WordPressClient,
-    params: { id: number; force?: boolean }
+    params: { id: number; force?: boolean },
   ): Promise<any> {
     try {
       await client.deleteMedia(params.id, params.force);
-      const action = params.force ? 'permanently deleted' : 'moved to trash';
+      const action = params.force ? "permanently deleted" : "moved to trash";
       return `✅ Media item ${params.id} has been ${action}.`;
     } catch (error) {
       throw new Error(`Failed to delete media: ${getErrorMessage(error)}`);