mcp-wordpress 1.1.2 → 1.1.6

package/src/tools/site.ts

@@ -1,8 +1,8 @@
-import { WordPressClient } from "../client/api.js";
+import { WordPressClient } from '../client/api.js';
 import {
-  WordPressApplicationPassword,
-} from "../types/wordpress.js";
-import { getErrorMessage } from "../utils/error.js";
+  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 +16,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,7 +138,7 @@ export class SiteTools {
 
   public async handleUpdateSiteSettings(
     client: WordPressClient,
-    params: any,
+    params: any
   ): Promise<any> {
     try {
       const updatedSettings = await client.updateSiteSettings(params);
@@ -150,7 +150,7 @@ export class SiteTools {
 
   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);
@@ -161,7 +161,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 +170,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,9 +182,9 @@ 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)}`);
@@ -193,18 +193,18 @@ export class SiteTools {
 
   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)}`);
@@ -213,7 +213,7 @@ export class SiteTools {
 
   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);

package/src/tools/taxonomies.ts

@@ -1,11 +1,11 @@
-import { WordPressClient } from "../client/api.js";
+import { WordPressClient } from '../client/api.js';
 import {
   CreateCategoryRequest,
   CreateTagRequest,
   UpdateCategoryRequest,
-  UpdateTagRequest,
-} from "../types/wordpress.js";
-import { getErrorMessage } from "../utils/error.js";
+  UpdateTagRequest
+} from '../types/wordpress.js';
+import { getErrorMessage } from '../utils/error.js';
 
 /**
  * Provides tools for managing taxonomies (categories and tags) on a WordPress site.
@@ -20,171 +20,171 @@ export class TaxonomyTools {
     return [
       // Categories
       {
-        name: "wp_list_categories",
-        description: "Lists categories from a WordPress site.",
+        name: 'wp_list_categories',
+        description: 'Lists categories from a WordPress site.',
         parameters: [
           {
-            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: "hide_empty",
-            type: "boolean",
-            description: "Whether to hide categories with no posts.",
-          },
+            name: 'hide_empty',
+            type: 'boolean',
+            description: 'Whether to hide categories with no posts.'
+          }
         ],
-        handler: this.handleListCategories.bind(this),
+        handler: this.handleListCategories.bind(this)
       },
       {
-        name: "wp_get_category",
-        description: "Retrieves a single category by its ID.",
+        name: 'wp_get_category',
+        description: 'Retrieves a single category by its ID.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The unique identifier for the category.",
-          },
+            description: 'The unique identifier for the category.'
+          }
         ],
-        handler: this.handleGetCategory.bind(this),
+        handler: this.handleGetCategory.bind(this)
       },
       {
-        name: "wp_create_category",
-        description: "Creates a new category.",
+        name: 'wp_create_category',
+        description: 'Creates a new category.',
         parameters: [
           {
-            name: "name",
-            type: "string",
+            name: 'name',
+            type: 'string',
             required: true,
-            description: "The name of the category.",
+            description: 'The name of the category.'
           },
           {
-            name: "description",
-            type: "string",
-            description: "The description for the category.",
-          },
+            name: 'description',
+            type: 'string',
+            description: 'The description for the category.'
+          }
         ],
-        handler: this.handleCreateCategory.bind(this),
+        handler: this.handleCreateCategory.bind(this)
       },
       {
-        name: "wp_update_category",
-        description: "Updates an existing category.",
+        name: 'wp_update_category',
+        description: 'Updates an existing category.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The ID of the category to update.",
+            description: 'The ID of the category to update.'
           },
           {
-            name: "name",
-            type: "string",
-            description: "The new name for the category.",
-          },
+            name: 'name',
+            type: 'string',
+            description: 'The new name for the category.'
+          }
         ],
-        handler: this.handleUpdateCategory.bind(this),
+        handler: this.handleUpdateCategory.bind(this)
       },
       {
-        name: "wp_delete_category",
-        description: "Deletes a category.",
+        name: 'wp_delete_category',
+        description: 'Deletes a category.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The ID of the category to delete.",
-          },
+            description: 'The ID of the category to delete.'
+          }
         ],
-        handler: this.handleDeleteCategory.bind(this),
+        handler: this.handleDeleteCategory.bind(this)
       },
       // Tags
       {
-        name: "wp_list_tags",
-        description: "Lists tags from a WordPress site.",
+        name: 'wp_list_tags',
+        description: 'Lists tags from a WordPress site.',
         parameters: [
           {
-            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.'
+          }
         ],
-        handler: this.handleListTags.bind(this),
+        handler: this.handleListTags.bind(this)
       },
       {
-        name: "wp_get_tag",
-        description: "Retrieves a single tag by its ID.",
+        name: 'wp_get_tag',
+        description: 'Retrieves a single tag by its ID.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The unique identifier for the tag.",
-          },
+            description: 'The unique identifier for the tag.'
+          }
         ],
-        handler: this.handleGetTag.bind(this),
+        handler: this.handleGetTag.bind(this)
       },
       {
-        name: "wp_create_tag",
-        description: "Creates a new tag.",
+        name: 'wp_create_tag',
+        description: 'Creates a new tag.',
         parameters: [
           {
-            name: "name",
-            type: "string",
+            name: 'name',
+            type: 'string',
             required: true,
-            description: "The name of the tag.",
-          },
+            description: 'The name of the tag.'
+          }
         ],
-        handler: this.handleCreateTag.bind(this),
+        handler: this.handleCreateTag.bind(this)
       },
       {
-        name: "wp_update_tag",
-        description: "Updates an existing tag.",
+        name: 'wp_update_tag',
+        description: 'Updates an existing tag.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The ID of the tag to update.",
+            description: 'The ID of the tag to update.'
           },
           {
-            name: "name",
-            type: "string",
-            description: "The new name for the tag.",
-          },
+            name: 'name',
+            type: 'string',
+            description: 'The new name for the tag.'
+          }
         ],
-        handler: this.handleUpdateTag.bind(this),
+        handler: this.handleUpdateTag.bind(this)
       },
       {
-        name: "wp_delete_tag",
-        description: "Deletes a tag.",
+        name: 'wp_delete_tag',
+        description: 'Deletes a tag.',
         parameters: [
           {
-            name: "id",
-            type: "number",
+            name: 'id',
+            type: 'number',
             required: true,
-            description: "The ID of the tag to delete.",
-          },
+            description: 'The ID of the tag to delete.'
+          }
         ],
-        handler: this.handleDeleteTag.bind(this),
-      },
+        handler: this.handleDeleteTag.bind(this)
+      }
     ];
   }
 
   public async handleListCategories(
     client: WordPressClient,
-    params: any,
+    params: any
   ): Promise<any> {
     try {
       const categories = await client.getCategories(params);
       if (categories.length === 0) {
-        return "No categories found.";
+        return 'No categories found.';
       }
       const content =
         `Found ${categories.length} categories:\n\n` +
         categories
           .map((c) => `- ID ${c.id}: **${c.name}** (Posts: ${c.count})`)
-          .join("\n");
+          .join('\n');
       return content;
     } catch (error) {
       throw new Error(`Failed to list categories: ${getErrorMessage(error)}`);
@@ -193,7 +193,7 @@ export class TaxonomyTools {
 
   public async handleGetCategory(
     client: WordPressClient,
-    params: { id: number },
+    params: { id: number }
   ): Promise<any> {
     try {
       const category = await client.getCategory(params.id);
@@ -201,7 +201,7 @@ export class TaxonomyTools {
         `**Category Details (ID: ${category.id})**\n\n` +
         `- **Name:** ${category.name}\n` +
         `- **Slug:** ${category.slug}\n` +
-        `- **Description:** ${category.description || "None"}\n` +
+        `- **Description:** ${category.description || 'None'}\n` +
         `- **Post Count:** ${category.count}`;
       return content;
     } catch (error) {
@@ -211,7 +211,7 @@ export class TaxonomyTools {
 
   public async handleCreateCategory(
     client: WordPressClient,
-    params: CreateCategoryRequest,
+    params: CreateCategoryRequest
   ): Promise<any> {
     try {
       const category = await client.createCategory(params);
@@ -223,7 +223,7 @@ export class TaxonomyTools {
 
   public async handleUpdateCategory(
     client: WordPressClient,
-    params: UpdateCategoryRequest & { id: number },
+    params: UpdateCategoryRequest & { id: number }
   ): Promise<any> {
     try {
       const category = await client.updateCategory(params);
@@ -235,7 +235,7 @@ export class TaxonomyTools {
 
   public async handleDeleteCategory(
     client: WordPressClient,
-    params: { id: number },
+    params: { id: number }
   ): Promise<any> {
     try {
       await client.deleteCategory(params.id);
@@ -247,18 +247,18 @@ export class TaxonomyTools {
 
   public async handleListTags(
     client: WordPressClient,
-    params: any,
+    params: any
   ): Promise<any> {
     try {
       const tags = await client.getTags(params);
       if (tags.length === 0) {
-        return "No tags found.";
+        return 'No tags found.';
       }
       const content =
         `Found ${tags.length} tags:\n\n` +
         tags
           .map((t) => `- ID ${t.id}: **${t.name}** (Posts: ${t.count})`)
-          .join("\n");
+          .join('\n');
       return content;
     } catch (error) {
       throw new Error(`Failed to list tags: ${getErrorMessage(error)}`);
@@ -267,7 +267,7 @@ export class TaxonomyTools {
 
   public async handleGetTag(
     client: WordPressClient,
-    params: { id: number },
+    params: { id: number }
   ): Promise<any> {
     try {
       const tag = await client.getTag(params.id);
@@ -284,7 +284,7 @@ export class TaxonomyTools {
 
   public async handleCreateTag(
     client: WordPressClient,
-    params: CreateTagRequest,
+    params: CreateTagRequest
   ): Promise<any> {
     try {
       const tag = await client.createTag(params);
@@ -296,7 +296,7 @@ export class TaxonomyTools {
 
   public async handleUpdateTag(
     client: WordPressClient,
-    params: UpdateTagRequest & { id: number },
+    params: UpdateTagRequest & { id: number }
   ): Promise<any> {
     try {
       const tag = await client.updateTag(params);
@@ -308,7 +308,7 @@ export class TaxonomyTools {
 
   public async handleDeleteTag(
     client: WordPressClient,
-    params: { id: number },
+    params: { id: number }
   ): Promise<any> {
     try {
       await client.deleteTag(params.id);