@mainwp/mcp 1.0.0-beta.1

package/dist/index.js

@@ -0,0 +1,506 @@
+#!/usr/bin/env node
+/**
+ * MainWP MCP Server
+ *
+ * Model Context Protocol server that exposes MainWP Dashboard abilities
+ * as MCP tools for AI assistants like Claude.
+ *
+ * Usage:
+ *   MAINWP_URL=https://dashboard.local MAINWP_TOKEN=xxx node dist/index.js
+ *
+ * Environment Variables:
+ *   - MAINWP_URL: Base URL of MainWP Dashboard (required)
+ *   - MAINWP_TOKEN: Bearer token for authentication (required)
+ *   - MAINWP_SKIP_SSL_VERIFY: Set to "true" to skip SSL verification (optional)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, CompleteRequestSchema, ListResourceTemplatesRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { loadConfig, formatJson } from './config.js';
+import { getTools, executeTool, toolNameToAbilityName, getSessionDataUsage } from './tools.js';
+import { fetchAbilities, fetchCategories, clearCache, onCacheRefresh, executeAbility, initRateLimiter, getAbility, generateHelpDocument, generateToolHelp, } from './abilities.js';
+import { getPromptList, getPrompt, getPromptArgumentCompletions } from './prompts.js';
+import { createLogger, createStderrLogger } from './logging.js';
+import { sanitizeError, isValidId, validateInput } from './security.js';
+import { formatErrorResponse, McpErrorFactory, McpError } from './errors.js';
+// Server metadata
+const SERVER_NAME = 'mainwp-mcp';
+const SERVER_VERSION = '1.0.0-beta.1';
+// Completion limits
+const MAX_COMPLETION_SUGGESTIONS = 20;
+/**
+ * Validate and parse a resource URI.
+ * Only allows known URI patterns to prevent injection attacks.
+ * Decodes URL-encoded characters before validation.
+ */
+function validateResourceUri(uri) {
+    // Decode URI to handle URL-encoded characters (e.g., %20, %2F)
+    let decodedUri;
+    try {
+        decodedUri = decodeURIComponent(uri);
+    }
+    catch (error) {
+        // Handle malformed URIs (invalid percent-encoding)
+        throw McpErrorFactory.invalidParams('Malformed URI: invalid percent-encoding', {
+            uri,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    const staticUris = [
+        'mainwp://abilities',
+        'mainwp://categories',
+        'mainwp://status',
+        'mainwp://help',
+    ];
+    if (staticUris.includes(decodedUri)) {
+        return { type: decodedUri.replace('mainwp://', '') };
+    }
+    // Match mainwp://site/{id} pattern with strict numeric ID
+    const siteMatch = decodedUri.match(/^mainwp:\/\/site\/(\d+)$/);
+    if (siteMatch) {
+        const siteId = parseInt(siteMatch[1], 10);
+        if (siteId < 1 || siteId > Number.MAX_SAFE_INTEGER) {
+            throw McpErrorFactory.invalidParams('Invalid site ID: must be between 1 and ' + Number.MAX_SAFE_INTEGER, { uri, siteId });
+        }
+        return { type: 'site', params: { site_id: siteId } };
+    }
+    // Match mainwp://help/tool/{tool_name} pattern (lowercase only, matches tool name format)
+    const toolHelpMatch = decodedUri.match(/^mainwp:\/\/help\/tool\/([a-z0-9_]+)$/);
+    if (toolHelpMatch) {
+        return { type: 'tool-help', params: { tool_name: toolHelpMatch[1] } };
+    }
+    throw McpErrorFactory.resourceNotFound(uri);
+}
+/**
+ * Create and configure the MCP server
+ */
+async function createServer(config) {
+    const server = new Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: { listChanged: true },
+            resources: { listChanged: true },
+            prompts: { listChanged: true },
+            logging: {},
+            completions: {},
+        },
+    });
+    // Create structured logger
+    const logger = createLogger(server);
+    // Handler: List available tools (derived from abilities)
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        try {
+            const tools = await getTools(config, logger);
+            return { tools };
+        }
+        catch (error) {
+            logger.error('Error listing tools', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { tools: [] };
+        }
+    });
+    // Handler: Execute a tool call
+    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+        const { name, arguments: args } = request.params;
+        try {
+            // Pass abort signal for cancellation support
+            const content = await executeTool(config, name, args ?? {}, logger, { signal: extra.signal });
+            return { content };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formatErrorResponse(error, sanitizeError),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Handler: List available resources (abilities info, categories, help)
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'mainwp://abilities',
+                    name: 'MainWP Abilities',
+                    description: 'List of all available MainWP abilities with their schemas',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mainwp://categories',
+                    name: 'MainWP Categories',
+                    description: 'List of ability categories',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mainwp://status',
+                    name: 'Connection Status',
+                    description: 'Current connection status to MainWP Dashboard',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'mainwp://help',
+                    name: 'MainWP MCP Help',
+                    description: 'Tool documentation, safety conventions (dry_run, confirm), and usage guides',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // Handler: Read a resource
+    // URI Handling Convention:
+    // - Static URIs (mainwp://abilities, mainwp://categories, mainwp://status, mainwp://help)
+    //   use direct equality checks for performance.
+    // - Dynamic/parameterized URIs (mainwp://site/{id}, mainwp://help/tool/{name})
+    //   MUST be routed through validateResourceUri() for security validation.
+    // - Do not introduce new dynamic URI patterns without using validateResourceUri().
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        try {
+            // Static URI handlers (no validation needed - exact match)
+            if (uri === 'mainwp://abilities') {
+                const abilities = await fetchAbilities(config, false, logger);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: formatJson(config, abilities),
+                        },
+                    ],
+                };
+            }
+            if (uri === 'mainwp://categories') {
+                const categories = await fetchCategories(config, false, logger);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: formatJson(config, categories),
+                        },
+                    ],
+                };
+            }
+            if (uri === 'mainwp://status') {
+                // Test connection by fetching abilities
+                // Redact dashboardUrl to host-only to avoid leaking full URL path to untrusted MCP clients
+                let redactedHost;
+                try {
+                    redactedHost = new URL(config.dashboardUrl).host;
+                }
+                catch {
+                    redactedHost = '[invalid-url]';
+                }
+                try {
+                    const abilities = await fetchAbilities(config, true, logger); // Force refresh
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: formatJson(config, {
+                                    connected: true,
+                                    dashboardHost: redactedHost,
+                                    abilitiesCount: abilities.length,
+                                    sessionData: getSessionDataUsage(config),
+                                }),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: formatJson(config, {
+                                    connected: false,
+                                    dashboardHost: redactedHost,
+                                    error: sanitizeError(errorMsg),
+                                }),
+                            },
+                        ],
+                    };
+                }
+            }
+            // Handle help resource: comprehensive documentation
+            if (uri === 'mainwp://help') {
+                const abilities = await fetchAbilities(config, false, logger);
+                const helpDoc = generateHelpDocument(abilities);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: formatJson(config, helpDoc),
+                        },
+                    ],
+                };
+            }
+            // Validate and parse the resource URI (throws on invalid URIs)
+            const parsed = validateResourceUri(uri);
+            // Handle site resource template: mainwp://site/{id}
+            if (parsed.type === 'site' && parsed.params?.site_id) {
+                const result = await executeAbility(config, 'mainwp/get-site-v1', { site_id: parsed.params.site_id }, logger);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: formatJson(config, result),
+                        },
+                    ],
+                };
+            }
+            // Handle tool help resource template: mainwp://help/tool/{tool_name}
+            if (parsed.type === 'tool-help' && parsed.params?.tool_name) {
+                const toolName = parsed.params.tool_name;
+                // Hardcoded 'mainwp' namespace - this server only supports MainWP abilities
+                const abilityName = toolNameToAbilityName(toolName, 'mainwp');
+                const ability = await getAbility(config, abilityName, logger);
+                if (!ability) {
+                    throw McpErrorFactory.resourceNotFound(uri);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: formatJson(config, generateToolHelp(ability)),
+                        },
+                    ],
+                };
+            }
+            // If we get here, the URI was valid but not handled by the code above
+            throw new Error(`Unhandled resource type: ${parsed.type}`);
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: formatErrorResponse(error, sanitizeError),
+                    },
+                ],
+            };
+        }
+    });
+    // Handler: List available prompts
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return { prompts: getPromptList() };
+    });
+    // Handler: Get a specific prompt
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            // Validate prompt arguments before processing
+            if (args) {
+                validateInput(args);
+            }
+            return getPrompt(name, args);
+        }
+        catch (error) {
+            // Preserve structured MCP errors (e.g., from validateInput)
+            if (error instanceof McpError) {
+                throw error;
+            }
+            // Sanitize unexpected errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(sanitizeError(errorMessage), { cause: error });
+        }
+    });
+    // Handler: Argument completions
+    server.setRequestHandler(CompleteRequestSchema, async (request) => {
+        const { ref, argument } = request.params;
+        // Handle prompt argument completions
+        if (ref.type === 'ref/prompt') {
+            const promptName = ref.name;
+            const argName = argument.name;
+            // Get static completions for known argument types
+            let values = getPromptArgumentCompletions(promptName, argName);
+            // For site_id arguments, try to fetch site list dynamically
+            if ((argName === 'site_id' || argName === 'site_ids') && values.length === 0) {
+                try {
+                    const abilities = await fetchAbilities(config, false, logger);
+                    const listSitesAbility = abilities.find(a => a.name === 'mainwp/list-sites-v1');
+                    if (listSitesAbility) {
+                        const result = await executeAbility(config, 'mainwp/list-sites-v1', {}, logger);
+                        if (Array.isArray(result)) {
+                            // Filter to only valid site IDs
+                            values = result
+                                .filter((site) => isValidId(site.id))
+                                .map((site) => String(site.id));
+                        }
+                    }
+                }
+                catch {
+                    // Ignore errors, return empty completions
+                }
+            }
+            // Filter by current input value if provided
+            const currentValue = argument.value || '';
+            const filteredValues = values.filter(v => v.toLowerCase().startsWith(currentValue.toLowerCase()));
+            return {
+                completion: {
+                    values: filteredValues.slice(0, MAX_COMPLETION_SUGGESTIONS),
+                    hasMore: filteredValues.length > MAX_COMPLETION_SUGGESTIONS,
+                    total: filteredValues.length,
+                },
+            };
+        }
+        // Default: no completions
+        return {
+            completion: {
+                values: [],
+                hasMore: false,
+                total: 0,
+            },
+        };
+    });
+    // Handler: List resource templates
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return {
+            resourceTemplates: [
+                {
+                    uriTemplate: 'mainwp://site/{site_id}',
+                    name: 'Site Details',
+                    description: 'Get detailed information about a specific site by ID',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'mainwp://help/tool/{tool_name}',
+                    name: 'Tool Documentation',
+                    description: 'Get detailed documentation for a specific tool including parameters and safety features',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // Register cache refresh callback for list_changed notifications
+    onCacheRefresh(() => {
+        server.sendToolListChanged().catch(() => {
+            // Ignore if not connected
+        });
+    });
+    return { server, logger };
+}
+/**
+ * Validate credentials by attempting to fetch abilities from the MainWP Dashboard.
+ * Provides enhanced error messages for common failure scenarios.
+ *
+ * @param config - Server configuration
+ * @param logger - Logger for status messages
+ * @returns The fetched abilities array on success
+ * @throws Error with actionable message on failure
+ */
+async function validateCredentials(config, logger) {
+    try {
+        const abilities = await fetchAbilities(config, false, logger);
+        logger.info('Credential validation successful: Connected to MainWP Dashboard');
+        return abilities;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const lowerMessage = message.toLowerCase();
+        // Authentication failures (401/403) - provide auth-type specific guidance
+        if (lowerMessage.includes('401') ||
+            lowerMessage.includes('403') ||
+            lowerMessage.includes('unauthorized') ||
+            lowerMessage.includes('forbidden')) {
+            const authHint = config.authType === 'basic'
+                ? 'Verify MAINWP_USER and MAINWP_APP_PASSWORD (or username/appPassword in settings.json) are correct and the user has REST API access.'
+                : 'Verify MAINWP_TOKEN (or apiToken in settings.json) is correct and has not expired.';
+            throw new Error(`Authentication failed: Invalid credentials. ${authHint}`, {
+                cause: error,
+            });
+        }
+        // Endpoint not found (404) - likely missing Abilities API plugin
+        if (lowerMessage.includes('404') || lowerMessage.includes('not found')) {
+            throw new Error('Abilities API endpoint not found. Verify MAINWP_URL points to a MainWP Dashboard with the Abilities API plugin installed.', { cause: error });
+        }
+        // Connection timeout
+        if (lowerMessage.includes('timeout')) {
+            throw new Error('Connection timeout. Verify MAINWP_URL is reachable and the server is responding.', { cause: error });
+        }
+        // SSL/TLS certificate errors
+        if (lowerMessage.includes('certificate') ||
+            lowerMessage.includes('ssl') ||
+            lowerMessage.includes('tls') ||
+            lowerMessage.includes('self-signed') ||
+            lowerMessage.includes('unable to verify')) {
+            throw new Error('SSL certificate verification failed. For self-signed certificates, set MAINWP_SKIP_SSL_VERIFY=true (development only).', { cause: error });
+        }
+        // Network connectivity errors
+        if (lowerMessage.includes('enotfound') ||
+            lowerMessage.includes('econnrefused') ||
+            lowerMessage.includes('network') ||
+            lowerMessage.includes('getaddrinfo') ||
+            lowerMessage.includes('econnreset')) {
+            throw new Error('Network error: Cannot reach MAINWP_URL. Verify the URL is correct and the server is accessible.', { cause: error });
+        }
+        // Other errors - re-throw with prefix
+        throw new Error(`Credential validation failed: ${message}`, { cause: error });
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Use stderr logger before server is initialized
+    const startupLogger = createStderrLogger();
+    try {
+        // Load configuration from environment
+        const config = loadConfig();
+        // Initialize rate limiter
+        initRateLimiter(config.rateLimit);
+        startupLogger.info(`MainWP MCP Server v${SERVER_VERSION}`);
+        startupLogger.info(`Dashboard: ${config.dashboardUrl}`);
+        startupLogger.info(`Auth: ${config.authType === 'basic' ? 'Basic Auth' : 'Bearer Token'}`);
+        startupLogger.info(`Config source: ${config.configSource}`);
+        startupLogger.info(`Session data limit: ${(config.maxSessionData / 1048576).toFixed(1)}MB`);
+        if (config.skipSslVerify) {
+            startupLogger.error('╔══════════════════════════════════════════════════════════════╗');
+            startupLogger.error('║  WARNING: SSL verification disabled                          ║');
+            startupLogger.error('║  Connection is vulnerable to man-in-the-middle attacks       ║');
+            startupLogger.error('║  Only use for local development with self-signed certs       ║');
+            startupLogger.error('╚══════════════════════════════════════════════════════════════╝');
+        }
+        // Validate credentials with fail-fast behavior
+        startupLogger.info('Validating credentials...');
+        const abilities = await validateCredentials(config, startupLogger);
+        startupLogger.info(`Connected! Found ${abilities.length} abilities`);
+        abilities.forEach(a => startupLogger.debug(`  - ${a.name}: ${a.label}`));
+        // Create server (returns server + structured logger)
+        const { server, logger } = await createServer(config);
+        // Connect via stdio transport
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('MCP server running on stdio');
+        // Handle graceful shutdown for both SIGINT and SIGTERM
+        const shutdown = async (signal) => {
+            logger.info(`Received ${signal}, shutting down...`);
+            clearCache();
+            await server.close();
+            process.exit(0);
+        };
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+    }
+    catch (error) {
+        startupLogger.error(`Fatal error: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+}
+// Run the server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Structured Logging Utility
+ *
+ * Provides MCP-compliant logging with severity levels.
+ * Uses server.sendLoggingMessage() when connected, falls back to stderr.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+export interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    notice(message: string, data?: Record<string, unknown>): void;
+    warning(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    critical(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Create a logger that sends structured messages to MCP clients.
+ *
+ * @param server - The MCP server instance (requires logging capability)
+ * @param loggerName - Name to identify the logging source (default: 'mainwp-mcp')
+ */
+export declare function createLogger(server: Server, loggerName?: string): Logger;
+/**
+ * Create a child logger that automatically includes a request correlation ID
+ * in every log entry. Useful for tracing a tool call across log entries.
+ */
+export declare function withRequestId(logger: Logger, requestId: string): Logger;
+/**
+ * Simple stderr logger for use before MCP server is initialized.
+ * Does not require a server instance.
+ */
+export declare function createStderrLogger(loggerName?: string): Logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,SAAe,GAAG,MAAM,CA8B9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAavE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,SAAe,GAAG,MAAM,CAepE"}

package/dist/logging.js

@@ -0,0 +1,74 @@
+/**
+ * Structured Logging Utility
+ *
+ * Provides MCP-compliant logging with severity levels.
+ * Uses server.sendLoggingMessage() when connected, falls back to stderr.
+ */
+/**
+ * Create a logger that sends structured messages to MCP clients.
+ *
+ * @param server - The MCP server instance (requires logging capability)
+ * @param loggerName - Name to identify the logging source (default: 'mainwp-mcp')
+ */
+export function createLogger(server, loggerName = 'mainwp-mcp') {
+    const log = (level, message, data) => {
+        // Build the log data payload
+        const logData = data ? { message, ...data } : message;
+        // Try to send via MCP protocol
+        server
+            .sendLoggingMessage({
+            level,
+            logger: loggerName,
+            data: logData,
+        })
+            .catch(() => {
+            // Fall back to stderr if server not connected or logging not enabled
+            const timestamp = new Date().toISOString();
+            const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+            console.error(`[${timestamp}] [${level.toUpperCase()}] [${loggerName}] ${message}${dataStr}`);
+        });
+    };
+    return {
+        debug: (message, data) => log('debug', message, data),
+        info: (message, data) => log('info', message, data),
+        notice: (message, data) => log('notice', message, data),
+        warning: (message, data) => log('warning', message, data),
+        error: (message, data) => log('error', message, data),
+        critical: (message, data) => log('critical', message, data),
+    };
+}
+/**
+ * Create a child logger that automatically includes a request correlation ID
+ * in every log entry. Useful for tracing a tool call across log entries.
+ */
+export function withRequestId(logger, requestId) {
+    const wrap = (fn) => (message, data) => fn(message, { ...data, requestId });
+    return {
+        debug: wrap(logger.debug.bind(logger)),
+        info: wrap(logger.info.bind(logger)),
+        notice: wrap(logger.notice.bind(logger)),
+        warning: wrap(logger.warning.bind(logger)),
+        error: wrap(logger.error.bind(logger)),
+        critical: wrap(logger.critical.bind(logger)),
+    };
+}
+/**
+ * Simple stderr logger for use before MCP server is initialized.
+ * Does not require a server instance.
+ */
+export function createStderrLogger(loggerName = 'mainwp-mcp') {
+    const log = (level, message, data) => {
+        const timestamp = new Date().toISOString();
+        const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+        console.error(`[${timestamp}] [${level.toUpperCase()}] [${loggerName}] ${message}${dataStr}`);
+    };
+    return {
+        debug: (message, data) => log('debug', message, data),
+        info: (message, data) => log('info', message, data),
+        notice: (message, data) => log('notice', message, data),
+        warning: (message, data) => log('warning', message, data),
+        error: (message, data) => log('error', message, data),
+        critical: (message, data) => log('critical', message, data),
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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