mcp-wordpress 1.2.2 → 1.3.0

package/src/tools/BaseToolManager.ts

@@ -2,7 +2,7 @@
  * Base utility class for tool managers to reduce code duplication
  */
 
-import { getErrorMessage } from '../utils/error.js';
+import { getErrorMessage } from "../utils/error.js";
 
 export class BaseToolUtils {
   /**
@@ -23,7 +23,7 @@ export class BaseToolUtils {
   /**
    * Validate ID parameter
    */
-  static validateId(id: unknown, name = 'id'): number {
+  static validateId(id: unknown, name = "id"): number {
     const numId = Number(id);
     if (!Number.isInteger(numId) || numId <= 0) {
       throw new Error(`Invalid ${name}: must be a positive integer`);
@@ -44,14 +44,14 @@ export class BaseToolUtils {
    */
   static generateCacheKey(
     operation: string,
-    params: Record<string, unknown>
+    params: Record<string, unknown>,
   ): string {
-    const site = params.site || 'default';
+    const site = params.site || "default";
     const paramStr = Object.entries(params)
-      .filter(([key]) => key !== 'site')
+      .filter(([key]) => key !== "site")
       .sort(([a], [b]) => a.localeCompare(b))
       .map(([key, value]) => `${key}:${value}`)
-      .join('|');
+      .join("|");
     return `${site}:${operation}:${paramStr}`;
   }
 

package/src/tools/auth.ts

@@ -1,6 +1,6 @@
-import { WordPressClient } from '../client/api.js';
-import { AuthMethod } from '../types/client.js';
-import { getErrorMessage } from '../utils/error.js';
+import { WordPressClient } from "../client/api.js";
+import { AuthMethod } from "../types/client.js";
+import { getErrorMessage } from "../utils/error.js";
 
 /**
  * Provides authentication-related tools for WordPress sites.
@@ -14,51 +14,51 @@ export class AuthTools {
   public getTools(): any[] {
     return [
       {
-        name: 'wp_test_auth',
+        name: "wp_test_auth",
         description:
-          'Tests the authentication and connectivity for a configured WordPress site.',
+          "Tests the authentication and connectivity for a configured WordPress site.",
         parameters: [], // The 'site' parameter is added dynamically by the server
-        handler: this.handleTestAuth.bind(this)
+        handler: this.handleTestAuth.bind(this),
       },
       {
-        name: 'wp_get_auth_status',
+        name: "wp_get_auth_status",
         description:
-          'Gets the current authentication status for a configured WordPress site.',
+          "Gets the current authentication status for a configured WordPress site.",
         parameters: [],
-        handler: this.handleGetAuthStatus.bind(this)
+        handler: this.handleGetAuthStatus.bind(this),
       },
       {
-        name: 'wp_switch_auth_method',
+        name: "wp_switch_auth_method",
         description:
-          'Switches the authentication method for a site for the current session.',
+          "Switches the authentication method for a site for the current session.",
         parameters: [
           {
-            name: 'method',
-            type: 'string',
+            name: "method",
+            type: "string",
             required: true,
-            description: 'The new authentication method to use.',
-            enum: ['app-password', 'jwt', 'basic', 'api-key', 'cookie']
+            description: "The new authentication method to use.",
+            enum: ["app-password", "jwt", "basic", "api-key", "cookie"],
           },
           {
-            name: 'username',
-            type: 'string',
+            name: "username",
+            type: "string",
             description:
-              'The username for \'app-password\' or \'basic\' authentication.'
+              "The username for 'app-password' or 'basic' authentication.",
           },
           {
-            name: 'password',
-            type: 'string',
+            name: "password",
+            type: "string",
             description:
-              'The Application Password for \'app-password\' or password for \'basic\' auth.'
+              "The Application Password for 'app-password' or password for 'basic' auth.",
           },
           {
-            name: 'jwt_token',
-            type: 'string',
-            description: 'The token for \'jwt\' authentication.'
-          }
+            name: "jwt_token",
+            type: "string",
+            description: "The token for 'jwt' authentication.",
+          },
         ],
-        handler: this.handleSwitchAuthMethod.bind(this)
-      }
+        handler: this.handleSwitchAuthMethod.bind(this),
+      },
     ];
   }
 
@@ -71,7 +71,7 @@ export class AuthTools {
    */
   public async handleTestAuth(
     client: WordPressClient,
-    params: any
+    params: any,
   ): Promise<any> {
     try {
       await client.ping();
@@ -79,12 +79,12 @@ export class AuthTools {
       const siteConfig = client.config;
 
       const content =
-        '✅ **Authentication successful!**\n\n' +
+        "✅ **Authentication successful!**\n\n" +
         `**Site:** ${siteConfig.baseUrl}\n` +
         `**Method:** ${siteConfig.auth.method}\n` +
         `**User:** ${user.name} (@${user.slug})\n` +
-        `**Roles:** ${user.roles?.join(', ') || 'N/A'}\n\n` +
-        'Your WordPress connection is working properly.';
+        `**Roles:** ${user.roles?.join(", ") || "N/A"}\n\n` +
+        "Your WordPress connection is working properly.";
 
       return content;
     } catch (error) {
@@ -101,21 +101,22 @@ export class AuthTools {
    */
   public async handleGetAuthStatus(
     client: WordPressClient,
-    params: any
+    params: any,
   ): Promise<any> {
     try {
       const isAuthenticated = client.isAuthenticated;
       const config = client.config;
       let content =
         `**Authentication Status for ${config.baseUrl}**\n\n` +
-        `**Authenticated:** ${isAuthenticated ? '✅ Yes' : '❌ No'}\n` +
+        `**Authenticated:** ${isAuthenticated ? "✅ Yes" : "❌ No"}\n` +
         `**Method:** ${config.auth.method}\n`;
 
       if (isAuthenticated) {
         const user = await client.getCurrentUser();
         content += `**User:** ${user.name} (@${user.slug})\n`;
       } else {
-        content += '**Status:** Not connected. Use \'wp_test_auth\' to connect and verify credentials.';
+        content +=
+          "**Status:** Not connected. Use 'wp_test_auth' to connect and verify credentials.";
       }
 
       return content;
@@ -138,14 +139,18 @@ export class AuthTools {
       username?: string;
       password?: string;
       jwt_token?: string;
-    }
+    },
   ): Promise<any> {
     try {
       // This functionality is not currently supported as the client
       // doesn't have an updateAuthConfig method
-      throw new Error('Dynamic authentication method switching is not currently supported. Please update your configuration file and restart the server.');
+      throw new Error(
+        "Dynamic authentication method switching is not currently supported. Please update your configuration file and restart the server.",
+      );
     } catch (error) {
-      throw new Error(`Failed to switch auth method: ${getErrorMessage(error)}`);
+      throw new Error(
+        `Failed to switch auth method: ${getErrorMessage(error)}`,
+      );
     }
   }
 }

package/src/tools/cache.ts

@@ -3,9 +3,9 @@
  * Provides cache inspection, clearing, and warming capabilities
  */
 
-import type { WordPressClient } from '../client/api.js';
-import { CachedWordPressClient } from '../client/CachedWordPressClient.js';
-import { toolWrapper } from '../utils/toolWrapper.js';
+import type { WordPressClient } from "../client/api.js";
+import { CachedWordPressClient } from "../client/CachedWordPressClient.js";
+import { toolWrapper } from "../utils/toolWrapper.js";
 
 /**
  * Cache management tools class
@@ -19,58 +19,60 @@ export class CacheTools {
   getTools() {
     return [
       {
-        name: 'wp_cache_stats',
-        description: 'Get cache statistics for a WordPress site.',
+        name: "wp_cache_stats",
+        description: "Get cache statistics for a WordPress site.",
         parameters: [
           {
-            name: 'site',
-            type: 'string',
-            description: 'Site ID to get cache stats for. If not provided, uses default site or fails if multiple sites configured.'
-          }
+            name: "site",
+            type: "string",
+            description:
+              "Site ID to get cache stats for. If not provided, uses default site or fails if multiple sites configured.",
+          },
         ],
-        handler: this.handleGetCacheStats.bind(this)
+        handler: this.handleGetCacheStats.bind(this),
       },
       {
-        name: 'wp_cache_clear',
-        description: 'Clear cache for a WordPress site.',
+        name: "wp_cache_clear",
+        description: "Clear cache for a WordPress site.",
         parameters: [
           {
-            name: 'site',
-            type: 'string',
-            description: 'Site ID to clear cache for.'
+            name: "site",
+            type: "string",
+            description: "Site ID to clear cache for.",
           },
           {
-            name: 'pattern',
-            type: 'string',
-            description: 'Optional pattern to clear specific cache entries (e.g., "posts", "categories").'
-          }
+            name: "pattern",
+            type: "string",
+            description:
+              "Optional pattern to clear specific cache entries (e.g., \"posts\", \"categories\").",
+          },
         ],
-        handler: this.handleClearCache.bind(this)
+        handler: this.handleClearCache.bind(this),
       },
       {
-        name: 'wp_cache_warm',
-        description: 'Pre-warm cache with essential WordPress data.',
+        name: "wp_cache_warm",
+        description: "Pre-warm cache with essential WordPress data.",
         parameters: [
           {
-            name: 'site',
-            type: 'string',
-            description: 'Site ID to warm cache for.'
-          }
+            name: "site",
+            type: "string",
+            description: "Site ID to warm cache for.",
+          },
         ],
-        handler: this.handleWarmCache.bind(this)
+        handler: this.handleWarmCache.bind(this),
       },
       {
-        name: 'wp_cache_info',
-        description: 'Get detailed cache configuration and status information.',
+        name: "wp_cache_info",
+        description: "Get detailed cache configuration and status information.",
         parameters: [
           {
-            name: 'site',
-            type: 'string',
-            description: 'Site ID to get cache info for.'
-          }
+            name: "site",
+            type: "string",
+            description: "Site ID to get cache info for.",
+          },
         ],
-        handler: this.handleGetCacheInfo.bind(this)
-      }
+        handler: this.handleGetCacheInfo.bind(this),
+      },
     ];
   }
 
@@ -80,30 +82,31 @@ export class CacheTools {
   async handleGetCacheStats(params: { site?: string }) {
     return toolWrapper(async () => {
       const client = this.resolveClient(params.site);
-      
+
       if (!(client instanceof CachedWordPressClient)) {
         return {
           caching_enabled: false,
-          message: 'Caching is disabled for this site. Set DISABLE_CACHE=false to enable caching.'
+          message:
+            "Caching is disabled for this site. Set DISABLE_CACHE=false to enable caching.",
         };
       }
 
       const stats = client.getCacheStats();
-      
+
       return {
         caching_enabled: true,
         cache_stats: {
           hits: stats.cache.hits,
           misses: stats.cache.misses,
-          hit_rate: Math.round(stats.cache.hitRate * 100) + '%',
+          hit_rate: Math.round(stats.cache.hitRate * 100) + "%",
           total_entries: stats.cache.totalSize,
-          evictions: stats.cache.evictions
+          evictions: stats.cache.evictions,
         },
         invalidation_stats: {
           queue_size: stats.invalidation.queueSize,
           rules_count: stats.invalidation.rulesCount,
-          processing: stats.invalidation.processing
-        }
+          processing: stats.invalidation.processing,
+        },
       };
     });
   }
@@ -114,30 +117,30 @@ export class CacheTools {
   async handleClearCache(params: { site?: string; pattern?: string }) {
     return toolWrapper(async () => {
       const client = this.resolveClient(params.site);
-      
+
       if (!(client instanceof CachedWordPressClient)) {
         return {
           success: false,
-          message: 'Caching is not enabled for this site.'
+          message: "Caching is not enabled for this site.",
         };
       }
 
       let cleared: number;
-      
+
       if (params.pattern) {
         cleared = client.clearCachePattern(params.pattern);
         return {
           success: true,
           message: `Cleared ${cleared} cache entries matching pattern "${params.pattern}".`,
           cleared_entries: cleared,
-          pattern: params.pattern
+          pattern: params.pattern,
         };
       } else {
         cleared = client.clearCache();
         return {
           success: true,
           message: `Cleared all cache entries (${cleared} total).`,
-          cleared_entries: cleared
+          cleared_entries: cleared,
         };
       }
     });
@@ -149,28 +152,28 @@ export class CacheTools {
   async handleWarmCache(params: { site?: string }) {
     return toolWrapper(async () => {
       const client = this.resolveClient(params.site);
-      
+
       if (!(client instanceof CachedWordPressClient)) {
         return {
           success: false,
-          message: 'Caching is not enabled for this site.'
+          message: "Caching is not enabled for this site.",
         };
       }
 
       await client.warmCache();
-      
+
       const stats = client.getCacheStats();
-      
+
       return {
         success: true,
-        message: 'Cache warmed with essential WordPress data.',
+        message: "Cache warmed with essential WordPress data.",
         cache_entries_after_warming: stats.cache.totalSize,
         warmed_data: [
-          'Current user information',
-          'Categories',
-          'Tags', 
-          'Site settings'
-        ]
+          "Current user information",
+          "Categories",
+          "Tags",
+          "Site settings",
+        ],
       };
     });
   }
@@ -181,50 +184,51 @@ export class CacheTools {
   async handleGetCacheInfo(params: { site?: string }) {
     return toolWrapper(async () => {
       const client = this.resolveClient(params.site);
-      
+
       if (!(client instanceof CachedWordPressClient)) {
         return {
           caching_enabled: false,
-          message: 'Caching is disabled for this site.',
-          how_to_enable: 'Remove DISABLE_CACHE=true from environment variables or set it to false.'
+          message: "Caching is disabled for this site.",
+          how_to_enable:
+            "Remove DISABLE_CACHE=true from environment variables or set it to false.",
         };
       }
 
       const stats = client.getCacheStats();
-      
+
       return {
         caching_enabled: true,
         cache_configuration: {
-          max_size: 'Configured in SecurityConfig.cache.maxSize',
-          default_ttl: 'Configured in SecurityConfig.cache.defaultTTL',
-          lru_enabled: 'Configured in SecurityConfig.cache.enableLRU',
-          stats_enabled: 'Configured in SecurityConfig.cache.enableStats'
+          max_size: "Configured in SecurityConfig.cache.maxSize",
+          default_ttl: "Configured in SecurityConfig.cache.defaultTTL",
+          lru_enabled: "Configured in SecurityConfig.cache.enableLRU",
+          stats_enabled: "Configured in SecurityConfig.cache.enableStats",
         },
         ttl_presets: {
-          static_data: '4 hours (site settings, user roles)',
-          semi_static_data: '2 hours (categories, tags, user profiles)',
-          dynamic_data: '15 minutes (posts, pages, comments)',
-          session_data: '30 minutes (authentication, current user)',
-          realtime_data: '1 minute (real-time data)'
+          static_data: "4 hours (site settings, user roles)",
+          semi_static_data: "2 hours (categories, tags, user profiles)",
+          dynamic_data: "15 minutes (posts, pages, comments)",
+          session_data: "30 minutes (authentication, current user)",
+          realtime_data: "1 minute (real-time data)",
         },
         current_stats: {
           total_entries: stats.cache.totalSize,
-          hit_rate: Math.round(stats.cache.hitRate * 100) + '%',
+          hit_rate: Math.round(stats.cache.hitRate * 100) + "%",
           hits: stats.cache.hits,
           misses: stats.cache.misses,
-          evictions: stats.cache.evictions
+          evictions: stats.cache.evictions,
         },
         invalidation_info: {
           queue_size: stats.invalidation.queueSize,
           rules_registered: stats.invalidation.rulesCount,
-          currently_processing: stats.invalidation.processing
+          currently_processing: stats.invalidation.processing,
         },
         performance_benefits: [
-          'Reduced API calls to WordPress',
-          'Faster response times for repeated requests',
-          'Better rate limit utilization',
-          'Improved user experience'
-        ]
+          "Reduced API calls to WordPress",
+          "Faster response times for repeated requests",
+          "Better rate limit utilization",
+          "Improved user experience",
+        ],
       };
     });
   }
@@ -237,10 +241,10 @@ export class CacheTools {
       if (this.clients.size === 1) {
         return Array.from(this.clients.values())[0];
       } else if (this.clients.size === 0) {
-        throw new Error('No WordPress sites configured.');
+        throw new Error("No WordPress sites configured.");
       } else {
         throw new Error(
-          `Multiple sites configured. Please specify --site parameter. Available sites: ${Array.from(this.clients.keys()).join(', ')}`
+          `Multiple sites configured. Please specify --site parameter. Available sites: ${Array.from(this.clients.keys()).join(", ")}`,
         );
       }
     }
@@ -248,7 +252,7 @@ export class CacheTools {
     const client = this.clients.get(siteId);
     if (!client) {
       throw new Error(
-        `Site "${siteId}" not found. Available sites: ${Array.from(this.clients.keys()).join(', ')}`
+        `Site "${siteId}" not found. Available sites: ${Array.from(this.clients.keys()).join(", ")}`,
       );
     }