mcp-wordpress 1.2.2 → 1.3.0

package/src/tools/posts.ts

@@ -1,10 +1,10 @@
-import { WordPressClient } from '../client/api.js';
+import { WordPressClient } from "../client/api.js";
 import {
   CreatePostRequest,
   PostQueryParams,
-  UpdatePostRequest
-} from '../types/wordpress.js';
-import { getErrorMessage } from '../utils/error.js';
+  UpdatePostRequest,
+} from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides tools for managing posts on a WordPress site.
@@ -18,175 +18,175 @@ export class PostTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_list_posts',
-        description: 'Lists posts from a WordPress site, with filters.',
+        name: "wp_list_posts",
+        description: "Lists posts 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: 'status',
-            type: 'string',
-            description: 'Filter by post status.',
-            enum: ['publish', 'future', 'draft', 'pending', 'private']
+            name: "status",
+            type: "string",
+            description: "Filter by post status.",
+            enum: ["publish", "future", "draft", "pending", "private"],
           },
           {
-            name: 'categories',
-            type: 'array',
-            items: { type: 'number' },
-            description: 'Limit results to posts in specific category IDs.'
+            name: "categories",
+            type: "array",
+            items: { type: "number" },
+            description: "Limit results to posts in specific category IDs.",
           },
           {
-            name: 'tags',
-            type: 'array',
-            items: { type: 'number' },
-            description: 'Limit results to posts with specific tag IDs.'
-          }
+            name: "tags",
+            type: "array",
+            items: { type: "number" },
+            description: "Limit results to posts with specific tag IDs.",
+          },
         ],
-        handler: this.handleListPosts.bind(this)
+        handler: this.handleListPosts.bind(this),
       },
       {
-        name: 'wp_get_post',
-        description: 'Retrieves a single post by its ID.',
+        name: "wp_get_post",
+        description: "Retrieves a single post by its ID.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The unique identifier for the post.'
-          }
+            description: "The unique identifier for the post.",
+          },
         ],
-        handler: this.handleGetPost.bind(this)
+        handler: this.handleGetPost.bind(this),
       },
       {
-        name: 'wp_create_post',
-        description: 'Creates a new post.',
+        name: "wp_create_post",
+        description: "Creates a new post.",
         parameters: [
           {
-            name: 'title',
-            type: 'string',
+            name: "title",
+            type: "string",
             required: true,
-            description: 'The title for the post.'
+            description: "The title for the post.",
           },
           {
-            name: 'content',
-            type: 'string',
-            description: 'The content for the post, in HTML format.'
+            name: "content",
+            type: "string",
+            description: "The content for the post, in HTML format.",
           },
           {
-            name: 'status',
-            type: 'string',
-            description: 'The publishing status for the post.',
-            enum: ['publish', 'draft', 'pending', 'private']
+            name: "status",
+            type: "string",
+            description: "The publishing status for the post.",
+            enum: ["publish", "draft", "pending", "private"],
           },
           {
-            name: 'excerpt',
-            type: 'string',
-            description: 'The excerpt for the post.'
+            name: "excerpt",
+            type: "string",
+            description: "The excerpt for the post.",
           },
           {
-            name: 'categories',
-            type: 'array',
-            items: { type: 'number' },
-            description: 'An array of category IDs to assign to the post.'
+            name: "categories",
+            type: "array",
+            items: { type: "number" },
+            description: "An array of category IDs to assign to the post.",
           },
           {
-            name: 'tags',
-            type: 'array',
-            items: { type: 'number' },
-            description: 'An array of tag IDs to assign to the post.'
-          }
+            name: "tags",
+            type: "array",
+            items: { type: "number" },
+            description: "An array of tag IDs to assign to the post.",
+          },
         ],
-        handler: this.handleCreatePost.bind(this)
+        handler: this.handleCreatePost.bind(this),
       },
       {
-        name: 'wp_update_post',
-        description: 'Updates an existing post.',
+        name: "wp_update_post",
+        description: "Updates an existing post.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the post to update.'
+            description: "The ID of the post to update.",
           },
           {
-            name: 'title',
-            type: 'string',
-            description: 'The new title for the post.'
+            name: "title",
+            type: "string",
+            description: "The new title for the post.",
           },
           {
-            name: 'content',
-            type: 'string',
-            description: 'The new content for the post, in HTML format.'
+            name: "content",
+            type: "string",
+            description: "The new content for the post, in HTML format.",
           },
           {
-            name: 'status',
-            type: 'string',
-            description: 'The new status for the post.',
-            enum: ['publish', 'draft', 'pending', 'private']
-          }
+            name: "status",
+            type: "string",
+            description: "The new status for the post.",
+            enum: ["publish", "draft", "pending", "private"],
+          },
         ],
-        handler: this.handleUpdatePost.bind(this)
+        handler: this.handleUpdatePost.bind(this),
       },
       {
-        name: 'wp_delete_post',
-        description: 'Deletes a post.',
+        name: "wp_delete_post",
+        description: "Deletes a post.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the post to delete.'
+            description: "The ID of the post 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.handleDeletePost.bind(this)
+        handler: this.handleDeletePost.bind(this),
       },
       {
-        name: 'wp_get_post_revisions',
-        description: 'Retrieves revisions for a specific post.',
+        name: "wp_get_post_revisions",
+        description: "Retrieves revisions for a specific post.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the post to get revisions for.'
-          }
+            description: "The ID of the post to get revisions for.",
+          },
         ],
-        handler: this.handleGetPostRevisions.bind(this)
-      }
+        handler: this.handleGetPostRevisions.bind(this),
+      },
     ];
   }
 
   public async handleListPosts(
     client: WordPressClient,
-    params: PostQueryParams
+    params: PostQueryParams,
   ): Promise<any> {
     try {
       const posts = await client.getPosts(params);
       if (posts.length === 0) {
-        return 'No posts found matching the criteria.';
+        return "No posts found matching the criteria.";
       }
       const content =
         `Found ${posts.length} posts:\n\n` +
         posts
           .map(
             (p) =>
-              `- ID ${p.id}: **${p.title.rendered}** (${p.status})\n  Link: ${p.link}`
+              `- ID ${p.id}: **${p.title.rendered}** (${p.status})\n  Link: ${p.link}`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list posts: ${getErrorMessage(error)}`);
@@ -195,7 +195,7 @@ export class PostTools {
 
   public async handleGetPost(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const post = await client.getPost(params.id);
@@ -213,7 +213,7 @@ export class PostTools {
 
   public async handleCreatePost(
     client: WordPressClient,
-    params: CreatePostRequest
+    params: CreatePostRequest,
   ): Promise<any> {
     try {
       const post = await client.createPost(params);
@@ -225,7 +225,7 @@ export class PostTools {
 
   public async handleUpdatePost(
     client: WordPressClient,
-    params: UpdatePostRequest & { id: number }
+    params: UpdatePostRequest & { id: number },
   ): Promise<any> {
     try {
       const post = await client.updatePost(params);
@@ -237,11 +237,11 @@ export class PostTools {
 
   public async handleDeletePost(
     client: WordPressClient,
-    params: { id: number; force?: boolean }
+    params: { id: number; force?: boolean },
   ): Promise<any> {
     try {
       await client.deletePost(params.id, params.force);
-      const action = params.force ? 'permanently deleted' : 'moved to trash';
+      const action = params.force ? "permanently deleted" : "moved to trash";
       return `✅ Post ${params.id} has been ${action}.`;
     } catch (error) {
       throw new Error(`Failed to delete post: ${getErrorMessage(error)}`);
@@ -250,7 +250,7 @@ export class PostTools {
 
   public async handleGetPostRevisions(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const revisions = await client.getPostRevisions(params.id);
@@ -263,13 +263,15 @@ export class PostTools {
           .map(
             (r) =>
               `- Revision by user ID ${r.author} at ${new Date(
-                r.modified
-              ).toLocaleString()}`
+                r.modified,
+              ).toLocaleString()}`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
-      throw new Error(`Failed to get post revisions: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to get post revisions: ${getErrorMessage(error)}`,
+      );
     }
   }
 }

package/src/tools/site.ts

@@ -1,8 +1,6 @@
-import { WordPressClient } from '../client/api.js';
-import {
-  WordPressApplicationPassword
-} from '../types/wordpress.js';
-import { getErrorMessage } from '../utils/error.js';
+import { WordPressClient } from "../client/api.js";
+import { WordPressApplicationPassword } from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides tools for managing general site settings and operations on a WordPress site.
@@ -16,111 +14,111 @@ export class SiteTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_get_site_settings',
-        description: 'Retrieves the general settings for a WordPress site.',
+        name: "wp_get_site_settings",
+        description: "Retrieves the general settings for a WordPress site.",
         parameters: [],
-        handler: this.handleGetSiteSettings.bind(this)
+        handler: this.handleGetSiteSettings.bind(this),
       },
       {
-        name: 'wp_update_site_settings',
+        name: "wp_update_site_settings",
         description:
-          'Updates one or more general settings for a WordPress site.',
+          "Updates one or more general settings for a WordPress site.",
         parameters: [
           {
-            name: 'title',
-            type: 'string',
-            description: 'The title of the site.'
+            name: "title",
+            type: "string",
+            description: "The title of the site.",
           },
           {
-            name: 'description',
-            type: 'string',
-            description: 'The tagline or description of the site.'
+            name: "description",
+            type: "string",
+            description: "The tagline or description of the site.",
           },
           {
-            name: 'timezone',
-            type: 'string',
+            name: "timezone",
+            type: "string",
             description:
-              'A city in the same timezone, e.g., \'America/New_York\'.'
-          }
+              "A city in the same timezone, e.g., 'America/New_York'.",
+          },
         ],
-        handler: this.handleUpdateSiteSettings.bind(this)
+        handler: this.handleUpdateSiteSettings.bind(this),
       },
       {
-        name: 'wp_search_site',
-        description: 'Performs a site-wide search for content.',
+        name: "wp_search_site",
+        description: "Performs a site-wide search for content.",
         parameters: [
           {
-            name: 'term',
-            type: 'string',
+            name: "term",
+            type: "string",
             required: true,
-            description: 'The search term to look for.'
+            description: "The search term to look for.",
           },
           {
-            name: 'type',
-            type: 'string',
-            description: 'The type of content to search.',
-            enum: ['posts', 'pages', 'media']
-          }
+            name: "type",
+            type: "string",
+            description: "The type of content to search.",
+            enum: ["posts", "pages", "media"],
+          },
         ],
-        handler: this.handleSearchSite.bind(this)
+        handler: this.handleSearchSite.bind(this),
       },
       {
-        name: 'wp_get_application_passwords',
-        description: 'Lists application passwords for a specific user.',
+        name: "wp_get_application_passwords",
+        description: "Lists application passwords for a specific user.",
         parameters: [
           {
-            name: 'user_id',
-            type: 'number',
+            name: "user_id",
+            type: "number",
             required: true,
-            description: 'The ID of the user to get application passwords for.'
-          }
+            description: "The ID of the user to get application passwords for.",
+          },
         ],
-        handler: this.handleGetApplicationPasswords.bind(this)
+        handler: this.handleGetApplicationPasswords.bind(this),
       },
       {
-        name: 'wp_create_application_password',
-        description: 'Creates a new application password for a user.',
+        name: "wp_create_application_password",
+        description: "Creates a new application password for a user.",
         parameters: [
           {
-            name: 'user_id',
-            type: 'number',
+            name: "user_id",
+            type: "number",
             required: true,
-            description: 'The ID of the user to create the password for.'
+            description: "The ID of the user to create the password for.",
           },
           {
-            name: 'app_name',
-            type: 'string',
+            name: "app_name",
+            type: "string",
             required: true,
-            description: 'The name of the application this password is for.'
-          }
+            description: "The name of the application this password is for.",
+          },
         ],
-        handler: this.handleCreateApplicationPassword.bind(this)
+        handler: this.handleCreateApplicationPassword.bind(this),
       },
       {
-        name: 'wp_delete_application_password',
-        description: 'Revokes an existing application password.',
+        name: "wp_delete_application_password",
+        description: "Revokes an existing application password.",
         parameters: [
           {
-            name: 'user_id',
-            type: 'number',
+            name: "user_id",
+            type: "number",
             required: true,
-            description: 'The ID of the user who owns the password.'
+            description: "The ID of the user who owns the password.",
           },
           {
-            name: 'uuid',
-            type: 'string',
+            name: "uuid",
+            type: "string",
             required: true,
-            description: 'The UUID of the application password to revoke.'
-          }
+            description: "The UUID of the application password to revoke.",
+          },
         ],
-        handler: this.handleDeleteApplicationPassword.bind(this)
-      }
+        handler: this.handleDeleteApplicationPassword.bind(this),
+      },
     ];
   }
 
   public async handleGetSiteSettings(
     client: WordPressClient,
-    params: any
+    params: any,
   ): Promise<any> {
     try {
       const settings = await client.getSiteSettings();
@@ -138,22 +136,27 @@ export class SiteTools {
 
   public async handleUpdateSiteSettings(
     client: WordPressClient,
-    params: any
+    params: any,
   ): Promise<any> {
     try {
       const updatedSettings = await client.updateSiteSettings(params);
       return `✅ Site settings updated successfully. New title: ${updatedSettings.title}`;
     } catch (error) {
-      throw new Error(`Failed to update site settings: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to update site settings: ${getErrorMessage(error)}`,
+      );
     }
   }
 
   public async handleSearchSite(
     client: WordPressClient,
-    params: { term: string; type?: 'posts' | 'pages' | 'media' }
+    params: { term: string; type?: "posts" | "pages" | "media" },
   ): Promise<any> {
     try {
-      const results = await client.search(params.term, params.type ? [params.type] : undefined);
+      const results = await client.search(
+        params.term,
+        params.type ? [params.type] : undefined,
+      );
       if (results.length === 0) {
         return `No results found for "${params.term}".`;
       }
@@ -161,7 +164,7 @@ export class SiteTools {
         `Found ${results.length} results for "${params.term}":\n\n` +
         results
           .map((r) => `- [${r.type}] **${r.title}**\n  Link: ${r.url}`)
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to perform search: ${getErrorMessage(error)}`);
@@ -170,7 +173,7 @@ export class SiteTools {
 
   public async handleGetApplicationPasswords(
     client: WordPressClient,
-    params: { user_id: number }
+    params: { user_id: number },
   ): Promise<any> {
     try {
       const passwords = await client.getApplicationPasswords(params.user_id);
@@ -182,44 +185,50 @@ export class SiteTools {
         passwords
           .map(
             (p: WordPressApplicationPassword) =>
-              `- **${p.name}** (UUID: ${p.uuid})\n  Created: ${new Date(p.created).toLocaleDateString()}`
+              `- **${p.name}** (UUID: ${p.uuid})\n  Created: ${new Date(p.created).toLocaleDateString()}`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
-      throw new Error(`Failed to get application passwords: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to get application passwords: ${getErrorMessage(error)}`,
+      );
     }
   }
 
   public async handleCreateApplicationPassword(
     client: WordPressClient,
-    params: { user_id: number; app_name: string }
+    params: { user_id: number; app_name: string },
   ): Promise<any> {
     try {
       const result = await client.createApplicationPassword(
         params.user_id,
-        params.app_name
+        params.app_name,
       );
       const content =
-        '✅ **Application password created successfully!**\n\n' +
+        "✅ **Application password created successfully!**\n\n" +
         `**Name:** ${result.name}\n` +
         `**Password:** \`${result.password}\`\n\n` +
-        '**IMPORTANT:** This password is shown only once. Please save it securely.';
+        "**IMPORTANT:** This password is shown only once. Please save it securely.";
       return content;
     } catch (error) {
-      throw new Error(`Failed to create application password: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to create application password: ${getErrorMessage(error)}`,
+      );
     }
   }
 
   public async handleDeleteApplicationPassword(
     client: WordPressClient,
-    params: { user_id: number; uuid: string }
+    params: { user_id: number; uuid: string },
   ): Promise<any> {
     try {
       await client.deleteApplicationPassword(params.user_id, params.uuid);
       return `✅ Application password with UUID ${params.uuid} has been revoked.`;
     } catch (error) {
-      throw new Error(`Failed to delete application password: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to delete application password: ${getErrorMessage(error)}`,
+      );
     }
   }
 }