@wplaunchify/ml-mcp-server 2.5.7 → 2.5.9

package/build/server.js

@@ -5,6 +5,7 @@ import * as dotenv from 'dotenv';
 dotenv.config({ path: '.env' });
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { allTools, toolHandlers } from './tools/index.js';
 import { z } from 'zod';
 // Generate server name from WordPress URL
 function generateServerName() {
@@ -39,50 +40,56 @@ function generateServerName() {
         return 'wordpress';
     }
 }
-/**
- * Register tools with the MCP server
- * This function is called after async tool loading completes
- */
-function registerTools(server, loadedTools, handlers) {
-    let registeredCount = 0;
-    for (const tool of loadedTools) {
-        const handler = handlers[tool.name];
-        if (!handler) {
-            console.error(`⚠️  No handler for tool: ${tool.name}`);
-            continue;
-        }
-        const wrappedHandler = async (args) => {
-            try {
-                // The handler functions are already typed with their specific parameter types
-                const result = await handler(args);
-                return {
-                    content: result.toolResult.content.map((item) => ({
-                        ...item,
-                        type: "text"
-                    })),
-                    isError: result.toolResult.isError
-                };
-            }
-            catch (error) {
-                // Return error as tool result instead of throwing
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Error executing ${tool.name}: ${error.message || String(error)}`
-                        }],
-                    isError: true
-                };
-            }
-        };
-        const zodSchema = z.object(tool.inputSchema.properties);
-        server.tool(tool.name, zodSchema.shape, wrappedHandler);
-        registeredCount++;
+// Create MCP server instance
+const server = new McpServer({
+    name: generateServerName(),
+    version: "1.0.7"
+}, {
+    capabilities: {
+        tools: allTools.reduce((acc, tool) => {
+            acc[tool.name] = tool;
+            return acc;
+        }, {})
+    }
+});
+// Register each tool from our tools list with its corresponding handler
+let registeredCount = 0;
+for (const tool of allTools) {
+    const handler = toolHandlers[tool.name];
+    if (!handler) {
+        console.error(`⚠️  No handler for tool: ${tool.name}`);
+        continue;
     }
-    console.error(`✅ Registered ${registeredCount} of ${loadedTools.length} tools`);
-    return registeredCount;
+    const wrappedHandler = async (args) => {
+        try {
+            // The handler functions are already typed with their specific parameter types
+            const result = await handler(args);
+            return {
+                content: result.toolResult.content.map((item) => ({
+                    ...item,
+                    type: "text"
+                })),
+                isError: result.toolResult.isError
+            };
+        }
+        catch (error) {
+            // Return error as tool result instead of throwing
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error executing ${tool.name}: ${error.message || String(error)}`
+                    }],
+                isError: true
+            };
+        }
+    };
+    const zodSchema = z.object(tool.inputSchema.properties);
+    server.tool(tool.name, zodSchema.shape, wrappedHandler);
+    registeredCount++;
 }
+console.error(`✅ Registered ${registeredCount} of ${allTools.length} tools`);
 async function main() {
-    const { logToFile, initWordPress } = await import('./wordpress.js');
+    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
@@ -91,28 +98,9 @@ async function main() {
     }
     try {
         logToFile('Initializing WordPress client...');
+        const { initWordPress } = await import('./wordpress.js');
         await initWordPress();
         logToFile('WordPress client initialized successfully.');
-        // Load tools with graceful plugin detection
-        logToFile('Loading tools with plugin detection...');
-        const { getFilteredToolsAsync, getFilteredHandlersAsync } = await import('./tools/index.js');
-        const loadedTools = await getFilteredToolsAsync();
-        const loadedHandlers = await getFilteredHandlersAsync(loadedTools);
-        logToFile(`Loaded ${loadedTools.length} tools based on installed plugins`);
-        // Create MCP server instance with loaded tools
-        const server = new McpServer({
-            name: generateServerName(),
-            version: "1.0.7"
-        }, {
-            capabilities: {
-                tools: loadedTools.reduce((acc, tool) => {
-                    acc[tool.name] = tool;
-                    return acc;
-                }, {})
-            }
-        });
-        // Register tools with handlers
-        registerTools(server, loadedTools, loadedHandlers);
         logToFile('Setting up server transport...');
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/build/tools/index.d.ts

@@ -1,13 +1,3 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-/**
- * Async version of getFilteredTools() that detects installed plugins
- * and only loads tools for installed plugins when ENABLED_TOOLS='all' or not set
- */
-declare function getFilteredToolsAsync(): Promise<Tool[]>;
-/**
- * Async version that returns handlers matching the tools loaded by getFilteredToolsAsync()
- */
-declare function getFilteredHandlersAsync(loadedTools: Tool[]): Promise<Record<string, any>>;
 export declare const allTools: Tool[];
 export declare const toolHandlers: Record<string, any>;
-export { getFilteredToolsAsync, getFilteredHandlersAsync };

package/build/tools/index.js

@@ -1,4 +1,3 @@
-import { detectInstalledPlugins } from '../wordpress.js';
 import { unifiedContentTools, unifiedContentHandlers } from './unified-content.js';
 import { unifiedTaxonomyTools, unifiedTaxonomyHandlers } from './unified-taxonomies.js';
 import { pluginTools, pluginHandlers } from './plugins.js';
@@ -130,26 +129,10 @@ const handlerCategories = {
         ...debugHandlers
     }
 };
-// Plugin slug mappings - which plugin slugs indicate which tool categories should load
-const pluginRequirements = {
-    fluentcommunity: ['fluent-community', 'fluentcommunity'],
-    'fluentcommunity-core': ['fluent-community', 'fluentcommunity'],
-    'fluentcommunity-learning': ['fluent-community', 'fluentcommunity'],
-    fluentcart: ['fluent-cart', 'fluentcart', 'wp-payment-form'],
-    fluentcrm: ['fluent-crm', 'fluentcrm'],
-    mlplugins: ['ml-image-editor', 'ml-media-hub', 'fluent-affiliate'],
-    pro: ['fluent-mcp-pro', 'fluentmcp-pro']
-};
-/**
- * Check if any of the required plugin slugs are installed
- */
-function hasAnyPlugin(installedPlugins, requiredSlugs) {
-    return requiredSlugs.some(slug => installedPlugins.has(slug));
-}
 // Filter tools based on ENABLED_TOOLS environment variable
 function getFilteredTools() {
     const enabledTools = process.env.ENABLED_TOOLS?.toLowerCase();
-    // If specific category requested, honor it (no detection needed)
+    // If specific category requested, honor it
     if (enabledTools && enabledTools !== 'all') {
         // Map user-friendly names to internal category names
         const categoryMap = {
@@ -177,8 +160,8 @@ function getFilteredTools() {
         }
         console.error(`⚠️  Unknown ENABLED_TOOLS value: ${enabledTools}. Loading all tools.`);
     }
-    // ENABLED_TOOLS not set or 'all' - load all tools without detection
-    // Detection will happen async in getFilteredToolsAsync()
+    // ENABLED_TOOLS not set or 'all' - load all tools
+    // No plugin detection during startup to prevent Claude Desktop crashes
     return [
         ...toolCategories.wordpress,
         ...toolCategories.fluentcommunity,
@@ -189,51 +172,6 @@ function getFilteredTools() {
         ...toolCategories.debug
     ];
 }
-/**
- * Async version of getFilteredTools() that detects installed plugins
- * and only loads tools for installed plugins when ENABLED_TOOLS='all' or not set
- */
-async function getFilteredToolsAsync() {
-    const enabledTools = process.env.ENABLED_TOOLS?.toLowerCase();
-    // If specific category requested, use sync version (no detection needed)
-    if (enabledTools && enabledTools !== 'all') {
-        return getFilteredTools();
-    }
-    // Detect installed plugins
-    console.error('🔍 Detecting installed plugins...');
-    const installedPlugins = await detectInstalledPlugins();
-    if (installedPlugins.size === 0) {
-        // Detection failed - fall back to loading all tools (safe default)
-        console.error('⚠️  Plugin detection failed. Loading all tools as fallback.');
-        return getFilteredTools();
-    }
-    // Always include WordPress core tools and debug tools
-    const tools = [...toolCategories.wordpress, ...toolCategories.debug];
-    let loadedCategories = ['wordpress', 'debug'];
-    // Conditionally add plugin tools based on detection
-    if (hasAnyPlugin(installedPlugins, pluginRequirements.fluentcommunity)) {
-        tools.push(...toolCategories.fluentcommunity);
-        loadedCategories.push('fluentcommunity');
-    }
-    if (hasAnyPlugin(installedPlugins, pluginRequirements.fluentcart)) {
-        tools.push(...toolCategories.fluentcart);
-        loadedCategories.push('fluentcart');
-    }
-    if (hasAnyPlugin(installedPlugins, pluginRequirements.fluentcrm)) {
-        tools.push(...toolCategories.fluentcrm);
-        loadedCategories.push('fluentcrm');
-    }
-    if (hasAnyPlugin(installedPlugins, pluginRequirements.mlplugins)) {
-        tools.push(...toolCategories.mlplugins);
-        loadedCategories.push('mlplugins');
-    }
-    if (hasAnyPlugin(installedPlugins, pluginRequirements.pro)) {
-        tools.push(...toolCategories.pro);
-        loadedCategories.push('pro');
-    }
-    console.error(`✅ Loaded ${tools.length} tools from categories: ${loadedCategories.join(', ')}`);
-    return tools;
-}
 function getFilteredHandlers() {
     const enabledTools = process.env.ENABLED_TOOLS?.toLowerCase();
     if (!enabledTools || enabledTools === 'all') {
@@ -281,45 +219,6 @@ function getFilteredHandlers() {
         ...handlerCategories.debug
     };
 }
-/**
- * Async version that returns handlers matching the tools loaded by getFilteredToolsAsync()
- */
-async function getFilteredHandlersAsync(loadedTools) {
-    const enabledTools = process.env.ENABLED_TOOLS?.toLowerCase();
-    // If specific category requested, use sync version
-    if (enabledTools && enabledTools !== 'all') {
-        return getFilteredHandlers();
-    }
-    // Build handlers object based on which tools were loaded
-    const handlers = {
-        ...handlerCategories.wordpress,
-        ...handlerCategories.debug
-    };
-    // Check which tool categories are present in loadedTools
-    const hasFluentCommunity = loadedTools.some(t => t.name.startsWith('fc_'));
-    const hasFluentCart = loadedTools.some(t => t.name.startsWith('fcart_'));
-    const hasFluentCRM = loadedTools.some(t => t.name.startsWith('fcrm_'));
-    const hasMLPlugins = loadedTools.some(t => t.name.startsWith('mlimg_') || t.name.startsWith('mlmh_') || t.name.startsWith('faf_'));
-    const hasPro = loadedTools.some(t => t.name.startsWith('fmcp_pro_'));
-    if (hasFluentCommunity) {
-        Object.assign(handlers, handlerCategories.fluentcommunity);
-    }
-    if (hasFluentCart) {
-        Object.assign(handlers, handlerCategories.fluentcart);
-    }
-    if (hasFluentCRM) {
-        Object.assign(handlers, handlerCategories.fluentcrm);
-    }
-    if (hasMLPlugins) {
-        Object.assign(handlers, handlerCategories.mlplugins);
-    }
-    if (hasPro) {
-        Object.assign(handlers, handlerCategories.pro);
-    }
-    return handlers;
-}
-// Export filtered tools and handlers (sync versions for backward compatibility)
+// Export filtered tools and handlers
 export const allTools = getFilteredTools();
 export const toolHandlers = getFilteredHandlers();
-// Export async versions for graceful plugin detection
-export { getFilteredToolsAsync, getFilteredHandlersAsync };

package/build/wordpress.d.ts

@@ -19,6 +19,9 @@ export declare function makeWordPressRequest(method: string, endpoint: string, d
 /**
  * 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>>;
 /**

package/build/wordpress.js

@@ -148,25 +148,45 @@ Data: ${JSON.stringify(error.response?.data || {}, null, 2)}
 /**
  * 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 {
-        // 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);
-                }
-            });
-        }
-        logToFile(`Detected active plugins: ${Array.from(installedPlugins).join(', ')}`);
+        // 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wplaunchify/ml-mcp-server",
-  "version": "2.5.7",
+  "version": "2.5.9",
   "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",