mcp-wordpress 1.2.2 → 1.3.0

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);

package/src/tools/users.ts

@@ -1,10 +1,10 @@
-import { WordPressClient } from '../client/api.js';
+import { WordPressClient } from "../client/api.js";
 import {
   CreateUserRequest,
   UpdateUserRequest,
-  UserQueryParams
-} from '../types/wordpress.js';
-import { getErrorMessage } from '../utils/error.js';
+  UserQueryParams,
+} from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides tools for managing users on a WordPress site.
@@ -18,135 +18,135 @@ export class UserTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_list_users',
-        description: 'Lists users from a WordPress site, with filters.',
+        name: "wp_list_users",
+        description: "Lists users from a WordPress site, with filters.",
         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: 'roles',
-            type: 'array',
-            items: { type: 'string' },
-            description: 'Limit results to users with specific roles.'
-          }
+            name: "roles",
+            type: "array",
+            items: { type: "string" },
+            description: "Limit results to users with specific roles.",
+          },
         ],
-        handler: this.handleListUsers.bind(this)
+        handler: this.handleListUsers.bind(this),
       },
       {
-        name: 'wp_get_user',
-        description: 'Retrieves a single user by their ID.',
+        name: "wp_get_user",
+        description: "Retrieves a single user by their ID.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The unique identifier for the user.'
-          }
+            description: "The unique identifier for the user.",
+          },
         ],
-        handler: this.handleGetUser.bind(this)
+        handler: this.handleGetUser.bind(this),
       },
       {
-        name: 'wp_get_current_user',
-        description: 'Retrieves the currently authenticated user.',
+        name: "wp_get_current_user",
+        description: "Retrieves the currently authenticated user.",
         parameters: [],
-        handler: this.handleGetCurrentUser.bind(this)
+        handler: this.handleGetCurrentUser.bind(this),
       },
       {
-        name: 'wp_create_user',
-        description: 'Creates a new user.',
+        name: "wp_create_user",
+        description: "Creates a new user.",
         parameters: [
           {
-            name: 'username',
-            type: 'string',
+            name: "username",
+            type: "string",
             required: true,
-            description: 'The username for the new user.'
+            description: "The username for the new user.",
           },
           {
-            name: 'email',
-            type: 'string',
+            name: "email",
+            type: "string",
             required: true,
-            description: 'The email address for the new user.'
+            description: "The email address for the new user.",
           },
           {
-            name: 'password',
-            type: 'string',
+            name: "password",
+            type: "string",
             required: true,
-            description: 'The password for the new user.'
+            description: "The password for the new user.",
           },
           {
-            name: 'roles',
-            type: 'array',
-            items: { type: 'string' },
-            description: 'An array of roles to assign to the user.'
-          }
+            name: "roles",
+            type: "array",
+            items: { type: "string" },
+            description: "An array of roles to assign to the user.",
+          },
         ],
-        handler: this.handleCreateUser.bind(this)
+        handler: this.handleCreateUser.bind(this),
       },
       {
-        name: 'wp_update_user',
-        description: 'Updates an existing user.',
+        name: "wp_update_user",
+        description: "Updates an existing user.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the user to update.'
+            description: "The ID of the user to update.",
           },
           {
-            name: 'email',
-            type: 'string',
-            description: 'The new email address for the user.'
+            name: "email",
+            type: "string",
+            description: "The new email address for the user.",
           },
           {
-            name: 'name',
-            type: 'string',
-            description: 'The new display name for the user.'
-          }
+            name: "name",
+            type: "string",
+            description: "The new display name for the user.",
+          },
         ],
-        handler: this.handleUpdateUser.bind(this)
+        handler: this.handleUpdateUser.bind(this),
       },
       {
-        name: 'wp_delete_user',
-        description: 'Deletes a user.',
+        name: "wp_delete_user",
+        description: "Deletes a user.",
         parameters: [
           {
-            name: 'id',
-            type: 'number',
+            name: "id",
+            type: "number",
             required: true,
-            description: 'The ID of the user to delete.'
+            description: "The ID of the user to delete.",
           },
           {
-            name: 'reassign',
-            type: 'number',
+            name: "reassign",
+            type: "number",
             description:
-              'The ID of a user to reassign the deleted user\'s content to.'
-          }
+              "The ID of a user to reassign the deleted user's content to.",
+          },
         ],
-        handler: this.handleDeleteUser.bind(this)
-      }
+        handler: this.handleDeleteUser.bind(this),
+      },
     ];
   }
 
   public async handleListUsers(
     client: WordPressClient,
-    params: UserQueryParams
+    params: UserQueryParams,
   ): Promise<any> {
     try {
       const users = await client.getUsers(params);
       if (users.length === 0) {
-        return 'No users found matching the criteria.';
+        return "No users found matching the criteria.";
       }
       const content =
         `Found ${users.length} users:\n\n` +
         users
           .map(
             (u) =>
-              `- ID ${u.id}: **${u.name}** (@${u.slug}) - ${u.email}\n  Roles: ${u.roles?.join(', ') || 'N/A'}`
+              `- ID ${u.id}: **${u.name}** (@${u.slug}) - ${u.email}\n  Roles: ${u.roles?.join(", ") || "N/A"}`,
           )
-          .join('\n');
+          .join("\n");
       return content;
     } catch (error) {
       throw new Error(`Failed to list users: ${getErrorMessage(error)}`);
@@ -155,7 +155,7 @@ export class UserTools {
 
   public async handleGetUser(
     client: WordPressClient,
-    params: { id: number }
+    params: { id: number },
   ): Promise<any> {
     try {
       const user = await client.getUser(params.id);
@@ -164,7 +164,7 @@ export class UserTools {
         `- **Name:** ${user.name}\n` +
         `- **Username:** ${user.slug}\n` +
         `- **Email:** ${user.email}\n` +
-        `- **Roles:** ${user.roles?.join(', ') || 'N/A'}`;
+        `- **Roles:** ${user.roles?.join(", ") || "N/A"}`;
       return content;
     } catch (error) {
       throw new Error(`Failed to get user: ${getErrorMessage(error)}`);
@@ -173,7 +173,7 @@ export class UserTools {
 
   public async handleGetCurrentUser(
     client: WordPressClient,
-    params: any
+    params: any,
   ): Promise<any> {
     try {
       const user = await client.getCurrentUser();
@@ -182,7 +182,7 @@ export class UserTools {
         `- **Name:** ${user.name}\n` +
         `- **Username:** ${user.slug}\n` +
         `- **Email:** ${user.email}\n` +
-        `- **Roles:** ${user.roles?.join(', ') || 'N/A'}`;
+        `- **Roles:** ${user.roles?.join(", ") || "N/A"}`;
       return content;
     } catch (error) {
       throw new Error(`Failed to get current user: ${getErrorMessage(error)}`);
@@ -191,7 +191,7 @@ export class UserTools {
 
   public async handleCreateUser(
     client: WordPressClient,
-    params: CreateUserRequest
+    params: CreateUserRequest,
   ): Promise<any> {
     try {
       const user = await client.createUser(params);
@@ -203,7 +203,7 @@ export class UserTools {
 
   public async handleUpdateUser(
     client: WordPressClient,
-    params: UpdateUserRequest & { id: number }
+    params: UpdateUserRequest & { id: number },
   ): Promise<any> {
     try {
       const user = await client.updateUser(params);
@@ -215,7 +215,7 @@ export class UserTools {
 
   public async handleDeleteUser(
     client: WordPressClient,
-    params: { id: number; reassign?: number }
+    params: { id: number; reassign?: number },
   ): Promise<any> {
     try {
       await client.deleteUser(params.id, params.reassign);