mcp-wordpress 2.6.4 → 2.7.0

package/src/tools/site.ts

@@ -14,7 +14,14 @@ export class SiteTools {
   public getTools(): Array<{
     name: string;
     description: string;
-    parameters?: Array<{ name: string; type?: string; description?: string; required?: boolean; enum?: string[]; items?: unknown }>;
+    parameters?: Array<{
+      name: string;
+      type?: string;
+      description?: string;
+      required?: boolean;
+      enum?: string[];
+      items?: unknown;
+    }>;
     handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
   }> {
     return [
@@ -126,10 +133,7 @@ export class SiteTools {
     ];
   }
 
-  public async handleGetSiteSettings(
-    client: WordPressClient,
-    _params: Record<string, unknown>,
-  ): Promise<unknown> {
+  public async handleGetSiteSettings(client: WordPressClient, _params: Record<string, unknown>): Promise<unknown> {
     try {
       const settings = await client.getSiteSettings();
       const siteUrl = client.getSiteUrl();
@@ -182,27 +186,21 @@ export class SiteTools {
       content += `**📊 Retrieved:** ${new Date().toLocaleString()}`;
 
       return content;
-    } catch (error) {
-      throw new Error(`Failed to get site settings: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get site settings: ${getErrorMessage(_error)}`);
     }
   }
 
-  public async handleUpdateSiteSettings(
-    client: WordPressClient,
-    params: Record<string, unknown>,
-  ): Promise<unknown> {
+  public async handleUpdateSiteSettings(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
     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)}`);
+    } catch (_error) {
+      throw new Error(`Failed to update site settings: ${getErrorMessage(_error)}`);
     }
   }
 
-  public async handleSearchSite(
-    client: WordPressClient,
-    params: Record<string, unknown>,
-  ): Promise<unknown> {
+  public async handleSearchSite(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
     try {
       const { term, type } = params as { term: string; type?: "posts" | "pages" | "media" };
       const results = await client.search(term, type ? [type] : undefined);
@@ -213,12 +211,15 @@ export class SiteTools {
         `Found ${results.length} results for "${term}":\n\n` +
         results.map((r) => `- [${r.type}] **${r.title}**\n  Link: ${r.url}`).join("\n");
       return content;
-    } catch (error) {
-      throw new Error(`Failed to perform search: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to perform search: ${getErrorMessage(_error)}`);
     }
   }
 
-  public async handleGetApplicationPasswords(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
+  public async handleGetApplicationPasswords(
+    client: WordPressClient,
+    params: Record<string, unknown>,
+  ): Promise<unknown> {
     try {
       const { user_id } = params as { user_id: number };
       const passwords = await client.getApplicationPasswords(user_id);
@@ -234,8 +235,8 @@ export class SiteTools {
           )
           .join("\n");
       return content;
-    } catch (error) {
-      throw new Error(`Failed to get application passwords: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get application passwords: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -252,8 +253,8 @@ export class SiteTools {
         `**Password:** \`${result.password}\`\n\n` +
         "**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)}`);
+    } catch (_error) {
+      throw new Error(`Failed to create application password: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -265,8 +266,8 @@ export class SiteTools {
       const { user_id, uuid } = params as { user_id: number; uuid: string };
       await client.deleteApplicationPassword(user_id, uuid);
       return `✅ Application password with UUID ${uuid} has been revoked.`;
-    } catch (error) {
-      throw new Error(`Failed to delete application password: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to delete application password: ${getErrorMessage(_error)}`);
     }
   }
 }

package/src/tools/taxonomies.ts

@@ -19,7 +19,14 @@ export class TaxonomyTools {
   public getTools(): Array<{
     name: string;
     description: string;
-    parameters?: Array<{ name: string; type?: string; description?: string; required?: boolean; enum?: string[]; items?: unknown }>;
+    parameters?: Array<{
+      name: string;
+      type?: string;
+      description?: string;
+      required?: boolean;
+      enum?: string[];
+      items?: unknown;
+    }>;
     handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
   }> {
     return [
@@ -187,8 +194,8 @@ export class TaxonomyTools {
         `Found ${categories.length} categories:\n\n` +
         categories.map((c) => `- ID ${c.id}: **${c.name}** (Posts: ${c.count})`).join("\n");
       return content;
-    } catch (error) {
-      throw new Error(`Failed to list categories: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to list categories: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -203,8 +210,8 @@ export class TaxonomyTools {
         `- **Description:** ${category.description || "None"}\n` +
         `- **Post Count:** ${category.count}`;
       return content;
-    } catch (error) {
-      throw new Error(`Failed to get category: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get category: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -213,21 +220,18 @@ export class TaxonomyTools {
     try {
       const category = await client.createCategory(createParams);
       return `✅ Category "${category.name}" created successfully with ID: ${category.id}.`;
-    } catch (error) {
-      throw new Error(`Failed to create category: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to create category: ${getErrorMessage(_error)}`);
     }
   }
 
-  public async handleUpdateCategory(
-    client: WordPressClient,
-    params: Record<string, unknown>,
-  ): Promise<unknown> {
+  public async handleUpdateCategory(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
     const updateParams = params as unknown as UpdateCategoryRequest;
     try {
       const category = await client.updateCategory(updateParams);
       return `✅ Category ${category.id} updated successfully.`;
-    } catch (error) {
-      throw new Error(`Failed to update category: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to update category: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -236,8 +240,8 @@ export class TaxonomyTools {
     try {
       await client.deleteCategory(id);
       return `✅ Category ${id} has been deleted.`;
-    } catch (error) {
-      throw new Error(`Failed to delete category: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to delete category: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -252,8 +256,8 @@ export class TaxonomyTools {
         `Found ${tags.length} tags:\n\n` +
         tags.map((t) => `- ID ${t.id}: **${t.name}** (Posts: ${t.count})`).join("\n");
       return content;
-    } catch (error) {
-      throw new Error(`Failed to list tags: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to list tags: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -267,8 +271,8 @@ export class TaxonomyTools {
         `- **Slug:** ${tag.slug}\n` +
         `- **Post Count:** ${tag.count}`;
       return content;
-    } catch (error) {
-      throw new Error(`Failed to get tag: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get tag: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -277,8 +281,8 @@ export class TaxonomyTools {
     try {
       const tag = await client.createTag(createParams);
       return `✅ Tag "${tag.name}" created successfully with ID: ${tag.id}.`;
-    } catch (error) {
-      throw new Error(`Failed to create tag: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to create tag: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -287,8 +291,8 @@ export class TaxonomyTools {
     try {
       const tag = await client.updateTag(updateParams);
       return `✅ Tag ${tag.id} updated successfully.`;
-    } catch (error) {
-      throw new Error(`Failed to update tag: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to update tag: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -297,8 +301,8 @@ export class TaxonomyTools {
     try {
       await client.deleteTag(id);
       return `✅ Tag ${id} has been deleted.`;
-    } catch (error) {
-      throw new Error(`Failed to delete tag: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to delete tag: ${getErrorMessage(_error)}`);
     }
   }
 }

package/src/tools/users.ts

@@ -15,7 +15,14 @@ export class UserTools {
   public getTools(): Array<{
     name: string;
     description: string;
-    parameters?: Array<{ name: string; type?: string; description?: string; required?: boolean; enum?: string[]; items?: unknown }>;
+    parameters?: Array<{
+      name: string;
+      type?: string;
+      description?: string;
+      required?: boolean;
+      enum?: string[];
+      items?: unknown;
+    }>;
     handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
   }> {
     return [
@@ -218,8 +225,8 @@ export class UserTools {
           })
           .join("\n\n");
       return content;
-    } catch (error) {
-      throw new Error(`Failed to list users: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to list users: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -234,8 +241,8 @@ export class UserTools {
         `- **Email:** ${user.email}\n` +
         `- **Roles:** ${user.roles?.join(", ") || "N/A"}`;
       return content;
-    } catch (error) {
-      throw new Error(`Failed to get user: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get user: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -300,8 +307,8 @@ export class UserTools {
         `- **Profile Link:** ${user.link || `${siteUrl}/wp-admin/profile.php`}`;
 
       return { content };
-    } catch (error) {
-      throw new Error(`Failed to get current user: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to get current user: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -310,8 +317,8 @@ export class UserTools {
     try {
       const user = await client.createUser(createParams);
       return `✅ User "${user.name}" created successfully with ID: ${user.id}.`;
-    } catch (error) {
-      throw new Error(`Failed to create user: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to create user: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -320,8 +327,8 @@ export class UserTools {
     try {
       const user = await client.updateUser(updateParams);
       return `✅ User ${user.id} updated successfully.`;
-    } catch (error) {
-      throw new Error(`Failed to update user: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to update user: ${getErrorMessage(_error)}`);
     }
   }
 
@@ -334,8 +341,8 @@ export class UserTools {
         content += ` Their content has been reassigned to user ID ${reassign}.`;
       }
       return content;
-    } catch (error) {
-      throw new Error(`Failed to delete user: ${getErrorMessage(error)}`);
+    } catch (_error) {
+      throw new Error(`Failed to delete user: ${getErrorMessage(_error)}`);
     }
   }
 }

package/src/types/client.ts

@@ -58,8 +58,10 @@ export interface AppPasswordCredentials {
 }
 
 export interface JwtCredentials {
-  jwtToken: string;
-  username?: string;
+  username: string;
+  password: string;
+  jwtToken?: string;
+  jwtSecret?: string;
 }
 
 export interface BasicCredentials {
@@ -76,11 +78,10 @@ export type AuthCredentials = AppPasswordCredentials | JwtCredentials | BasicCre
 
 // Authentication status interface
 export interface AuthStatus {
-  method: AuthMethod;
-  username?: string | undefined;
   isAuthenticated: boolean;
-  tokenExpired: boolean;
-  tokenExpiry?: number;
+  method: AuthMethod;
+  lastAuthAttempt?: Date | null;
+  tokenExpiry?: Date | null;
 }
 
 // Client Configuration
@@ -134,6 +135,7 @@ export interface ClientStats {
   lastRequestTime?: number;
   rateLimitHits: number;
   authFailures: number;
+  errors: number;
 }
 
 // WordPress API Client Interface