@wplaunchify/ml-mcp-server 2.6.0 → 2.6.2

package/build/server.js

@@ -91,16 +91,16 @@ console.error(`✅ Registered ${registeredCount} of ${allTools.length} tools`);
 async function main() {
     const { logToFile } = await import('./wordpress.js');
     logToFile('Starting WordPress MCP server...');
-    // Environment variables are passed by MCP client (Claude Desktop, Cursor, etc.)
-    // Don't exit here - let initWordPress() handle the validation
+    // CRITICAL: DO NOT call initWordPress() during startup
+    // It will be called lazily on first tool execution
+    // This prevents blocking when multiple servers start simultaneously
     if (!process.env.WORDPRESS_API_URL) {
-        logToFile('Warning: WORDPRESS_API_URL not set. Will fail on first tool call if not provided by MCP client.');
+        logToFile('Warning: WORDPRESS_API_URL not set. Will be initialized on first tool call.');
+    }
+    else {
+        logToFile('WORDPRESS_API_URL is set. Client will be initialized on first tool call.');
     }
     try {
-        logToFile('Initializing WordPress client...');
-        const { initWordPress } = await import('./wordpress.js');
-        await initWordPress();
-        logToFile('WordPress client initialized successfully.');
         logToFile('Setting up server transport...');
         const transport = new StdioServerTransport();
         await server.connect(transport);
@@ -108,7 +108,6 @@ async function main() {
     }
     catch (error) {
         logToFile(`Failed to initialize server: ${error}`);
-        // Don't exit immediately - let the MCP client handle the error
         throw error;
     }
 }

package/build/wordpress.d.ts

@@ -16,14 +16,6 @@ export declare function makeWordPressRequest(method: string, endpoint: string, d
     isFormData?: boolean;
     rawResponse?: boolean;
 }): Promise<any>;
-/**
- * Detect which plugins are installed and active
- * Returns a set of plugin slugs that are active
- *
- * IMPORTANT: This function makes an HTTP request and should NOT block server startup.
- * It has a timeout and fails gracefully to prevent Claude Desktop crashes.
- */
-export declare function detectInstalledPlugins(): Promise<Set<string>>;
 /**
  * Make a request to the WordPress.org Plugin Repository API
  * @param searchQuery Search query string

package/build/wordpress.js

@@ -42,10 +42,11 @@ export async function initWordPress() {
         };
     }
     wpClient = axios.create(config);
-    // Optionally verify connection to WordPress API (don't crash if it fails)
-    // This prevents startup crashes when multiple servers start simultaneously
-    const skipInitCheck = process.env.SKIP_INIT_CHECK === 'true';
-    if (!skipInitCheck) {
+    // CRITICAL: NO HTTP requests during startup to prevent Claude Desktop hangs
+    // Connection will be verified on first tool call instead
+    // Set VERIFY_CONNECTION_ON_STARTUP=true to enable startup verification (NOT recommended)
+    const verifyOnStartup = process.env.VERIFY_CONNECTION_ON_STARTUP === 'true';
+    if (verifyOnStartup) {
         try {
             await wpClient.get('');
             logToFile('Successfully connected to WordPress API');
@@ -57,7 +58,8 @@ export async function initWordPress() {
         }
     }
     else {
-        logToFile('Skipping WordPress API connection verification (SKIP_INIT_CHECK=true)');
+        logToFile('Skipping WordPress API connection verification during startup (prevents Claude Desktop hangs)');
+        logToFile('Connection will be verified on first tool call.');
     }
 }
 // Configure logging
@@ -82,8 +84,10 @@ export function logToFile(message) {
  * @returns Response data
  */
 export async function makeWordPressRequest(method, endpoint, data, options) {
+    // Lazy initialization - initialize on first request if not already done
     if (!wpClient) {
-        throw new Error('WordPress client not initialized');
+        logToFile('WordPress client not initialized, initializing now...');
+        await initWordPress();
     }
     // Log data (skip for FormData which can't be stringified)
     if (!options?.isFormData) {
@@ -145,52 +149,6 @@ Data: ${JSON.stringify(error.response?.data || {}, null, 2)}
         throw error;
     }
 }
-/**
- * Detect which plugins are installed and active
- * Returns a set of plugin slugs that are active
- *
- * IMPORTANT: This function makes an HTTP request and should NOT block server startup.
- * It has a timeout and fails gracefully to prevent Claude Desktop crashes.
- */
-export async function detectInstalledPlugins() {
-    const installedPlugins = new Set();
-    // Check if plugin detection should be skipped
-    const skipDetection = process.env.SKIP_PLUGIN_DETECTION === 'true';
-    if (skipDetection) {
-        logToFile('Plugin detection skipped (SKIP_PLUGIN_DETECTION=true)');
-        return installedPlugins; // Return empty set - will load all tools
-    }
-    try {
-        // Add timeout to prevent blocking server startup
-        const timeoutMs = 3000; // 3 seconds max
-        const timeoutPromise = new Promise((_, reject) => {
-            setTimeout(() => reject(new Error('Plugin detection timeout')), timeoutMs);
-        });
-        const detectionPromise = (async () => {
-            // Get list of active plugins
-            const response = await makeWordPressRequest('GET', 'wp/v2/plugins', { status: 'active' });
-            if (Array.isArray(response)) {
-                response.forEach((plugin) => {
-                    // Extract plugin slug from plugin path (e.g., "fluent-crm/fluent-crm.php" -> "fluent-crm")
-                    const slug = plugin.plugin?.split('/')[0] || plugin.slug;
-                    if (slug) {
-                        installedPlugins.add(slug);
-                    }
-                });
-            }
-            return installedPlugins;
-        })();
-        // Race between detection and timeout
-        await Promise.race([detectionPromise, timeoutPromise]);
-        logToFile(`✓ Detected active plugins: ${Array.from(installedPlugins).join(', ')}`);
-    }
-    catch (error) {
-        // Silently fail - if we can't detect plugins, we'll load all tools
-        // This prevents server crashes when WordPress is slow or endpoint requires auth
-        logToFile(`Plugin detection failed (will load all tools): ${error.message}`);
-    }
-    return installedPlugins;
-}
 /**
  * Make a request to the WordPress.org Plugin Repository API
  * @param searchQuery Search query string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "Universal MCP Server for WordPress + Fluent Suite (Community, CRM, Cart) + FluentMCP Pro. Comprehensive tools for AI-powered WordPress management via Claude, Cursor, and other MCP clients.",
   "type": "module",
   "main": "./build/server.js",