mcp-wordpress 2.5.0 → 2.5.1

package/dist/src/dxt-entry.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Entry point for DXT package - ensures proper initialization when run through Claude Desktop
+ */
+import { LoggerFactory } from "./utils/logger.js";
+import { MCPWordPressServer } from "./index.js";
+const logger = LoggerFactory.server();
+logger.debug("DXT entry point starting...");
+logger.debug(`Current working directory: ${process.cwd()}`);
+logger.debug(`__dirname equivalent: ${import.meta.url}`);
+logger.debug("Environment variables passed from DXT:");
+logger.debug(`  WORDPRESS_SITE_URL: ${process.env.WORDPRESS_SITE_URL ? "SET" : "NOT SET"}`);
+logger.debug(`  WORDPRESS_USERNAME: ${process.env.WORDPRESS_USERNAME ? "SET" : "NOT SET"}`);
+logger.debug(`  WORDPRESS_APP_PASSWORD: ${process.env.WORDPRESS_APP_PASSWORD ? "SET" : "NOT SET"}`);
+async function startDXTServer() {
+    try {
+        logger.debug("Creating MCPWordPressServer instance from DXT entry point...");
+        const server = new MCPWordPressServer();
+        logger.debug("Starting server...");
+        await server.run();
+        // Handle graceful shutdown
+        const shutdown = async () => {
+            logger.debug("Received shutdown signal in DXT entry point");
+            await server.shutdown();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    catch (error) {
+        logger.fatal(`DXT server failed to start: ${error instanceof Error ? error.message : String(error)}`);
+        logger.fatal(`Stack trace: ${error instanceof Error ? error.stack : "No stack trace available"}`);
+        process.exit(1);
+    }
+}
+// Always run when loaded as DXT entry point
+logger.debug("Calling startDXTServer...");
+startDXTServer();
+//# sourceMappingURL=dxt-entry.js.map

package/dist/src/dxt-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dxt-entry.js","sourceRoot":"","sources":["../../src/dxt-entry.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;AAEtC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC5C,MAAM,CAAC,KAAK,CAAC,8BAA8B,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC5D,MAAM,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACzD,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AACvD,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,KAAK,CAAC,6BAA6B,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AAEpG,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACnC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QAEnB,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC5D,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtG,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,EAAE,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC1C,cAAc,EAAE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+import { McpConfigType } from "./config/ServerConfiguration.js";
+declare class MCPWordPressServer {
+    private server;
+    private wordpressClients;
+    private initialized;
+    private siteConfigs;
+    private toolRegistry;
+    private logger;
+    constructor(mcpConfig?: McpConfigType);
+    private loadConfiguration;
+    private setupTools;
+    private testClientConnections;
+    run(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export default MCPWordPressServer;
+export { MCPWordPressServer };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAMhE,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAA0B;gBAE5B,SAAS,CAAC,EAAE,aAAa;IA8BrC,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,UAAU;YAIJ,qBAAqB;IAS7B,GAAG;IAkDH,QAAQ;CAKf;AAkCD,eAAe,kBAAkB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,143 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { fileURLToPath } from "url";
+import { ServerConfiguration } from "./config/ServerConfiguration.js";
+import { ToolRegistry } from "./server/ToolRegistry.js";
+import { ConnectionTester } from "./server/ConnectionTester.js";
+import { getErrorMessage } from "./utils/error.js";
+import { LoggerFactory } from "./utils/logger.js";
+import { ConfigHelpers } from "./config/Config.js";
+// --- Constants ---
+const SERVER_VERSION = "1.1.8"; // Technical debt resolution and modular architecture
+// --- Main Server Class ---
+class MCPWordPressServer {
+    server;
+    wordpressClients = new Map();
+    initialized = false;
+    siteConfigs = [];
+    toolRegistry;
+    logger = LoggerFactory.server();
+    constructor(mcpConfig) {
+        this.loadConfiguration(mcpConfig);
+        if (this.wordpressClients.size === 0) {
+            // In test environments, don't exit the process
+            if (ConfigHelpers.isCI() || ConfigHelpers.isTest() || globalThis.__EXECUTION_CONTEXT__ === "jest") {
+                this.logger.warn("No WordPress sites configured in test environment");
+                // Create a dummy client for testing
+                this.wordpressClients.set("test", {});
+            }
+            else {
+                this.logger.fatal("No WordPress sites configured. Server cannot start.", {
+                    expectedEnvVars: [
+                        "WORDPRESS_SITE_URL",
+                        "WORDPRESS_USERNAME",
+                        "WORDPRESS_APP_PASSWORD"
+                    ]
+                });
+                process.exit(1);
+            }
+        }
+        this.server = new McpServer({
+            name: "mcp-wordpress",
+            version: SERVER_VERSION,
+        });
+        this.toolRegistry = new ToolRegistry(this.server, this.wordpressClients);
+        this.setupTools();
+    }
+    loadConfiguration(mcpConfig) {
+        const serverConfig = ServerConfiguration.getInstance();
+        const { clients, configs } = serverConfig.loadClientConfigurations(mcpConfig);
+        this.wordpressClients = clients;
+        this.siteConfigs = configs;
+    }
+    setupTools() {
+        this.toolRegistry.registerAllTools();
+    }
+    async testClientConnections() {
+        // Use optimized connection testing with timeouts and concurrency control
+        await ConnectionTester.testClientConnections(this.wordpressClients, {
+            timeout: ConfigHelpers.getTimeout("test"),
+            maxConcurrent: ConfigHelpers.isCI() ? 2 : 3 // Reduce concurrency in CI
+        });
+        this.initialized = true;
+    }
+    async run() {
+        // Skip connection testing in DXT environment to prevent timeouts
+        const isDXTMode = ConfigHelpers.isDXT() || process.argv[0]?.includes("dxt-entry");
+        if (!this.initialized && !isDXTMode) {
+            this.logger.info("Testing connections to configured WordPress sites...", {
+                siteCount: this.wordpressClients.size
+            });
+            try {
+                await this.testClientConnections();
+            }
+            catch (error) {
+                this.logger.warn("Connection test failed - continuing with server startup", {
+                    error: getErrorMessage(error)
+                });
+            }
+        }
+        else if (isDXTMode) {
+            this.logger.info("DXT mode detected - skipping connection tests for faster startup");
+            this.initialized = true;
+        }
+        this.logger.info("Starting MCP WordPress Server...", {
+            version: SERVER_VERSION,
+            sites: this.wordpressClients.size
+        });
+        // Connect to stdio transport with timeout
+        const transport = new StdioServerTransport();
+        // Add timeout protection for server connection
+        const connectionTimeout = setTimeout(() => {
+            this.logger.fatal("Server connection timed out", { timeoutMs: 30000 });
+            process.exit(1);
+        }, 30000);
+        try {
+            await this.server.connect(transport);
+            clearTimeout(connectionTimeout);
+            this.logger.info("Server started and connected successfully", {
+                sites: this.wordpressClients.size
+            });
+            // Keep the process alive
+            process.stdin.resume();
+        }
+        catch (error) {
+            clearTimeout(connectionTimeout);
+            throw error;
+        }
+    }
+    async shutdown() {
+        this.logger.info("Shutting down MCP WordPress Server...");
+        await this.server.close();
+        this.logger.info("Server stopped");
+    }
+}
+// --- Main Execution ---
+async function main() {
+    const mainLogger = LoggerFactory.server();
+    try {
+        const mcpServer = new MCPWordPressServer();
+        await mcpServer.run();
+        const shutdown = async () => {
+            await mcpServer.shutdown();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    catch (error) {
+        mainLogger.fatal("Failed to start server", { error: getErrorMessage(error) });
+        process.exit(1);
+    }
+}
+// Check if running as main module - handle both direct execution and DXT entry point
+const isMainModule = process.argv[1] === fileURLToPath(import.meta.url) ||
+    process.argv[1]?.endsWith("/index.js") ||
+    process.argv[1]?.endsWith("\\index.js") ||
+    !process.argv[1]; // When run through DXT, process.argv[1] might be undefined
+if (isMainModule) {
+    main();
+}
+export default MCPWordPressServer;
+export { MCPWordPressServer };
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/performance/MetricsCollector.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Real-time Metrics Collector for WordPress MCP Server
+ * Integrates with existing client and cache systems
+ */
+import { PerformanceMonitor, PerformanceMetrics } from "./PerformanceMonitor.js";
+import type { CacheStats } from "../cache/CacheManager.js";
+import type { ClientStats } from "../types/client.js";
+export interface CollectorConfig {
+    enableRealTime: boolean;
+    collectInterval: number;
+    enableToolTracking: boolean;
+    enableRequestInterception: boolean;
+    enableCacheIntegration: boolean;
+    enableSystemMetrics: boolean;
+}
+export interface RequestMetadata {
+    toolName?: string;
+    siteId?: string;
+    endpoint: string;
+    method: string;
+    startTime: number;
+    fromCache: boolean;
+}
+export interface ToolExecutionContext {
+    toolName: string;
+    parameters: Record<string, unknown>;
+    startTime: number;
+    siteId: string | undefined;
+}
+/**
+ * Metrics Collector - Central hub for all performance data
+ */
+export declare class MetricsCollector {
+    private monitor;
+    private config;
+    private activeRequests;
+    private activeTools;
+    private clientInstances;
+    private cacheManagers;
+    private logger;
+    private realTimeInterval?;
+    constructor(monitor: PerformanceMonitor, config?: Partial<CollectorConfig>);
+    /**
+     * Register a WordPress client for monitoring
+     */
+    registerClient(siteId: string, client: unknown): void;
+    /**
+     * Register a cache manager for monitoring
+     */
+    registerCacheManager(siteId: string, cacheManager: unknown): void;
+    /**
+     * Start tracking a tool execution
+     */
+    startToolExecution(toolName: string, parameters: Record<string, unknown>, siteId?: string): string;
+    /**
+     * End tool execution and record metrics
+     */
+    endToolExecution(executionId: string, success: boolean, error?: Error): void;
+    /**
+     * Record a raw request (bypass tool tracking)
+     */
+    recordRawRequest(responseTime: number, success: boolean, endpoint: string, fromCache?: boolean): void;
+    /**
+     * Collect current metrics from all sources
+     */
+    collectCurrentMetrics(): PerformanceMetrics;
+    /**
+     * Get aggregated cache statistics
+     */
+    getAggregatedCacheStats(): CacheStats;
+    /**
+     * Get aggregated client statistics
+     */
+    getAggregatedClientStats(): ClientStats;
+    /**
+     * Get performance summary for specific site
+     */
+    getSiteMetrics(siteId: string): {
+        cache?: CacheStats;
+        client?: ClientStats;
+        isActive: boolean;
+    };
+    /**
+     * Generate performance comparison between sites
+     */
+    compareSitePerformance(): {
+        sites: string[];
+        comparison: Record<string, {
+            responseTime: number;
+            cacheHitRate: number;
+            errorRate: number;
+            requestCount: number;
+            ranking: number;
+        }>;
+        bestPerforming: string;
+        worstPerforming: string;
+    };
+    /**
+     * Generate optimization suggestions
+     */
+    generateOptimizationSuggestions(): {
+        critical: string[];
+        recommended: string[];
+        optional: string[];
+    };
+    /**
+     * Export detailed performance report
+     */
+    exportDetailedReport(): {
+        timestamp: string;
+        overview: PerformanceMetrics;
+        siteComparison: Record<string, unknown>;
+        aggregatedStats: {
+            cache: CacheStats;
+            client: ClientStats;
+        };
+        optimizations: Record<string, unknown>;
+        alerts: unknown[];
+    };
+    /**
+     * Start real-time metric collection
+     */
+    private startRealTimeCollection;
+    /**
+     * Stop real-time collection and cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Update cache metrics in performance monitor
+     */
+    private updateCacheMetrics;
+    /**
+     * Update client metrics in performance monitor
+     */
+    private updateClientMetrics;
+    /**
+     * Intercept client requests for automatic tracking
+     */
+    private interceptClientRequests;
+    /**
+     * Stop all monitoring and cleanup
+     */
+    stop(): void;
+}
+//# sourceMappingURL=MetricsCollector.d.ts.map

package/dist/src/performance/MetricsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../../../src/performance/MetricsCollector.ts"],"names":[],"mappings":"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"}