mcp-wordpress 1.1.2

package/dist/utils/debug.js

@@ -0,0 +1,195 @@
+/**
+ * Debug Utility for MCP Server
+ *
+ * This module provides debug logging that only outputs when DEBUG mode is enabled.
+ * This prevents console.log from interfering with MCP STDIO communication.
+ */
+// Check if debug mode is enabled
+const isDebugMode = () => process.env.DEBUG === 'true' ||
+    process.env.NODE_ENV === 'development';
+// Get current timestamp
+const getTimestamp = () => new Date().toISOString();
+// Format log message with timestamp and level
+const formatMessage = (level, args) => {
+    const timestamp = getTimestamp();
+    const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+    return `${prefix} ${args.map(arg => typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg)).join(' ')}`;
+};
+// Handle circular references in objects
+const safeStringify = (obj) => {
+    try {
+        return JSON.stringify(obj, (key, value) => {
+            if (value instanceof Error) {
+                return {
+                    name: value.name,
+                    message: value.message,
+                    stack: value.stack
+                };
+            }
+            return value;
+        }, 2);
+    }
+    catch (error) {
+        return '[Object with circular reference]';
+    }
+};
+/**
+ * Debug logger that only outputs in debug mode
+ */
+export const debug = {
+    log: (...args) => {
+        if (isDebugMode()) {
+            console.error(formatMessage('debug', args)); // Use stderr for debug to avoid STDIO interference
+        }
+    },
+    info: (...args) => {
+        if (isDebugMode()) {
+            console.error(formatMessage('info', args));
+        }
+    },
+    warn: (...args) => {
+        if (isDebugMode()) {
+            console.error(formatMessage('warn', args));
+        }
+    },
+    error: (...args) => {
+        if (isDebugMode()) {
+            console.error(formatMessage('error', args));
+        }
+    }
+};
+/**
+ * Silent logger for production use
+ */
+export const silent = {
+    log: () => { },
+    warn: () => { },
+    error: () => { },
+    info: () => { }
+};
+/**
+ * Enhanced structured logger
+ */
+class StructuredLoggerImpl {
+    context;
+    enabled;
+    constructor(context = {}, enabled = isDebugMode()) {
+        this.context = context;
+        this.enabled = enabled;
+    }
+    output(level, args) {
+        if (!this.enabled)
+            return;
+        const debugInfo = {
+            timestamp: Date.now(),
+            level,
+            message: args.map(arg => typeof arg === 'object' ? safeStringify(arg) : String(arg)).join(' '),
+            ...(Object.keys(this.context).length > 0 && { context: this.context })
+        };
+        console.error(safeStringify(debugInfo));
+    }
+    log(...args) {
+        this.output('debug', args);
+    }
+    info(...args) {
+        this.output('info', args);
+    }
+    warn(...args) {
+        this.output('warn', args);
+    }
+    error(...args) {
+        this.output('error', args);
+    }
+    logStructured(info) {
+        if (!this.enabled)
+            return;
+        const enhancedInfo = {
+            ...info,
+            context: { ...this.context, ...info.context }
+        };
+        console.error(safeStringify(enhancedInfo));
+    }
+    child(context) {
+        return new StructuredLoggerImpl({ ...this.context, ...context }, this.enabled);
+    }
+}
+/**
+ * Create a structured logger instance
+ */
+export const createStructuredLogger = (context = {}) => {
+    return new StructuredLoggerImpl(context);
+};
+/**
+ * Default logger instance
+ */
+export const logger = debug;
+/**
+ * Create a logger with context
+ */
+export const createLogger = (context = {}) => {
+    return createStructuredLogger(context);
+};
+export const startTimer = (label) => {
+    const start = Date.now();
+    return {
+        end() {
+            return Date.now() - start;
+        },
+        endWithLog(message = 'Operation') {
+            const duration = Date.now() - start;
+            debug.info(`${message} completed in ${duration}ms${label ? ` [${label}]` : ''}`);
+            return duration;
+        }
+    };
+};
+/**
+ * Log error with stack trace
+ */
+export const logError = (error, context) => {
+    if (typeof error === 'string') {
+        debug.error(error, context);
+    }
+    else {
+        debug.error(`${error.name}: ${error.message}`, {
+            stack: error.stack,
+            ...context
+        });
+    }
+};
+/**
+ * Conditional logging
+ */
+export const logIf = (condition, level = 'debug') => {
+    if (!condition)
+        return silent;
+    const loggers = {
+        log: debug.log,
+        info: debug.info,
+        warn: debug.warn,
+        error: debug.error
+    };
+    return loggers[level] || debug.log;
+};
+/**
+ * Type-safe environment variable getter
+ */
+export const getEnvVar = (key, defaultValue) => {
+    const value = process.env[key];
+    if (value === undefined && defaultValue !== undefined) {
+        debug.warn(`Environment variable ${key} not found, using default: ${defaultValue}`);
+        return defaultValue;
+    }
+    return value;
+};
+/**
+ * Validate required environment variables
+ */
+export const validateEnvVars = (required) => {
+    const missing = required.filter(key => !process.env[key]);
+    if (missing.length > 0) {
+        const error = new Error(`Missing required environment variables: ${missing.join(', ')}`);
+        logError(error);
+        throw error;
+    }
+};
+//# sourceMappingURL=debug.js.map

package/dist/utils/debug.js.map

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

package/dist/utils/error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error handling utilities
+ */
+export declare function getErrorMessage(error: unknown): string;
+export declare function isError(error: unknown): error is Error;
+export declare function logAndReturn<T>(error: unknown, defaultValue: T): T;
+/**
+ * Enhanced error handler for consistent tool error handling
+ */
+export declare function handleToolError(error: unknown, operation: string, context?: Record<string, unknown>): never;
+/**
+ * Validates required parameters
+ */
+export declare function validateRequired(params: Record<string, unknown>, required: string[]): void;
+/**
+ * Validates site parameter for multi-site configurations
+ */
+export declare function validateSite(site: string | undefined, availableSites: string[]): string;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CA2B3G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAK1F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAavF"}

package/dist/utils/error.js

@@ -0,0 +1,71 @@
+/**
+ * Error handling utilities
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return 'Unknown error occurred';
+}
+export function isError(error) {
+    return error instanceof Error;
+}
+export function logAndReturn(error, defaultValue) {
+    console.error('Error occurred:', getErrorMessage(error));
+    return defaultValue;
+}
+/**
+ * Enhanced error handler for consistent tool error handling
+ */
+export function handleToolError(error, operation, context) {
+    console.error(`Error in ${operation}:`, error);
+    if (context) {
+        console.error('Context:', context);
+    }
+    const message = getErrorMessage(error);
+    // Provide more specific error messages based on error content
+    if (message.includes('ECONNREFUSED') || message.includes('ENOTFOUND')) {
+        throw new Error(`Connection failed during ${operation}. Please check your WordPress site URL and network connection.`);
+    }
+    if (message.includes('401') || message.includes('Unauthorized')) {
+        throw new Error(`Authentication failed during ${operation}. Please check your WordPress credentials.`);
+    }
+    if (message.includes('403') || message.includes('Forbidden')) {
+        throw new Error(`Permission denied during ${operation}. Please check your user permissions.`);
+    }
+    if (message.includes('429') || message.includes('Too Many Requests')) {
+        throw new Error(`Rate limit exceeded during ${operation}. Please try again later.`);
+    }
+    throw new Error(`Failed to ${operation}: ${message}`);
+}
+/**
+ * Validates required parameters
+ */
+export function validateRequired(params, required) {
+    const missing = required.filter(key => !params[key]);
+    if (missing.length > 0) {
+        throw new Error(`Missing required parameters: ${missing.join(', ')}`);
+    }
+}
+/**
+ * Validates site parameter for multi-site configurations
+ */
+export function validateSite(site, availableSites) {
+    if (!site) {
+        if (availableSites.length === 1) {
+            return availableSites[0];
+        }
+        throw new Error(`Site parameter is required when multiple sites are configured. Available sites: ${availableSites.join(', ')}`);
+    }
+    if (!availableSites.includes(site)) {
+        throw new Error(`Site '${site}' not found. Available sites: ${availableSites.join(', ')}`);
+    }
+    return site;
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

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

package/dist/utils/toolWrapper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool Wrapper Utility
+ * Standardizes error handling and reduces repetitive try-catch blocks
+ */
+/**
+ * Wrapper for tool methods that standardizes error handling
+ */
+export declare function withErrorHandling<T extends any[], R>(operation: string, fn: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+/**
+ * Wrapper for tool methods with validation
+ */
+export declare function withValidation<T extends any[], R>(operation: string, validator: (...args: T) => void, fn: (...args: T) => Promise<R>): (...args: T) => Promise<R>;
+/**
+ * Common validation functions
+ */
+export declare const validators: {
+    requireSite: (client: any, params: any) => void;
+    requireId: (params: {
+        id?: number | string;
+    }) => void;
+    requireNonEmpty: (value: any, fieldName: string) => void;
+    requireFields: (params: any, fields: string[]) => void;
+};
+/**
+ * Decorator for class methods to add error handling
+ */
+export declare function errorHandler(operation: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Helper to format success responses consistently
+ */
+export declare function formatSuccessResponse(content: string): string;
+/**
+ * Helper to format error responses consistently
+ */
+export declare function formatErrorResponse(operation: string, error: any): never;
+//# sourceMappingURL=toolWrapper.d.ts.map

package/dist/utils/toolWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolWrapper.d.ts","sourceRoot":"","sources":["../../src/utils/toolWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAClD,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAQ5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAC/C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EAC/B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAS5B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;0BACC,GAAG,UAAU,GAAG;wBAMlB;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;6BAMnB,GAAG,aAAa,MAAM;4BAMvB,GAAG,UAAU,MAAM,EAAE;CAO9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,IAC3B,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,wBAalF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,CAGxE"}

package/dist/utils/toolWrapper.js

@@ -0,0 +1,90 @@
+/**
+ * Tool Wrapper Utility
+ * Standardizes error handling and reduces repetitive try-catch blocks
+ */
+import { getErrorMessage } from "./error.js";
+/**
+ * Wrapper for tool methods that standardizes error handling
+ */
+export function withErrorHandling(operation, fn) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            throw new Error(`${operation}: ${getErrorMessage(error)}`);
+        }
+    };
+}
+/**
+ * Wrapper for tool methods with validation
+ */
+export function withValidation(operation, validator, fn) {
+    return async (...args) => {
+        try {
+            validator(...args);
+            return await fn(...args);
+        }
+        catch (error) {
+            throw new Error(`${operation}: ${getErrorMessage(error)}`);
+        }
+    };
+}
+/**
+ * Common validation functions
+ */
+export const validators = {
+    requireSite: (client, params) => {
+        if (!client) {
+            throw new Error("WordPress client is required");
+        }
+    },
+    requireId: (params) => {
+        if (!params.id) {
+            throw new Error("ID parameter is required");
+        }
+    },
+    requireNonEmpty: (value, fieldName) => {
+        if (!value || (typeof value === 'string' && value.trim() === '')) {
+            throw new Error(`${fieldName} cannot be empty`);
+        }
+    },
+    requireFields: (params, fields) => {
+        for (const field of fields) {
+            if (params[field] === undefined || params[field] === null) {
+                throw new Error(`${field} is required`);
+            }
+        }
+    }
+};
+/**
+ * Decorator for class methods to add error handling
+ */
+export function errorHandler(operation) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            try {
+                return await originalMethod.apply(this, args);
+            }
+            catch (error) {
+                throw new Error(`${operation}: ${getErrorMessage(error)}`);
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Helper to format success responses consistently
+ */
+export function formatSuccessResponse(content) {
+    return content;
+}
+/**
+ * Helper to format error responses consistently
+ */
+export function formatErrorResponse(operation, error) {
+    const message = getErrorMessage(error);
+    throw new Error(`${operation}: ${message}`);
+}
+//# sourceMappingURL=toolWrapper.js.map

package/dist/utils/toolWrapper.js.map

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

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "mcp-wordpress",
+  "version": "1.1.2",
+  "description": "Comprehensive Model Context Protocol server for WordPress management with 54 tools, TypeScript support, and production-ready authentication",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "mcp-wordpress": "bin/mcp-wordpress.js",
+    "wordpress-setup": "bin/setup.js",
+    "wordpress-status": "bin/status.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "start": "npm run build && node dist/index.js",
+    "dev": "npm run build && DEBUG=true node dist/index.js",
+    "setup": "node bin/setup.js",
+    "status": "node bin/status.js",
+    "test": "npm run test:typescript",
+    "test:typescript": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest --config=jest.typescript.config.json",
+    "test:tools": "node scripts/test-all-tools.js",
+    "test:legacy": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest",
+    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch --config=jest.typescript.config.json",
+    "test:coverage": "npm run build && NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage --collectCoverageFrom='dist/**/*.js' --coverageThreshold='{\"global\":{\"branches\":50,\"functions\":50,\"lines\":50,\"statements\":50}}' --config=jest.typescript.config.json",
+    "test:fast": "npm run test:typescript",
+    "test:mcp": "node scripts/test-mcp.js",
+    "test:integration": "node scripts/test-integration.js",
+    "test:auth": "node scripts/test-auth.js",
+    "health": "node scripts/health-check.js",
+    "verify-claude": "node scripts/verify-claude-integration.js",
+    "lint": "eslint src/ tests/ bin/ scripts/",
+    "lint:fix": "eslint src/ tests/ bin/ scripts/ --fix",
+    "typecheck": "tsc --noEmit",
+    "check:ignore": "node scripts/sync-ignore-files.js",
+    "check:npm": "node scripts/test-npm-config.js",
+    "prepare": "husky",
+    "pre-commit": "lint-staged",
+    "prepublishOnly": "npm run build && npm run check:ignore"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "wordpress",
+    "cms",
+    "rest-api",
+    "ai",
+    "assistant"
+  ],
+  "author": "AiondaDotCom",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.3.1",
+    "form-data": "^4.0.0",
+    "node-fetch": "^3.3.2",
+    "open": "^9.1.0",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.29.0",
+    "@jest/globals": "^30.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/nock": "^10.0.3",
+    "@types/node": "^20.19.1",
+    "eslint": "^9.29.0",
+    "eslint-plugin-jest": "^29.0.1",
+    "eslint-plugin-node": "^11.1.0",
+    "husky": "^9.1.7",
+    "jest": "^30.0.0",
+    "lint-staged": "^16.1.2",
+    "markdownlint-cli": "^0.45.0",
+    "nock": "^14.0.5",
+    "prettier": "^3.6.2",
+    "sort-package-json": "^3.3.1",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "bin/",
+    "docs/",
+    "examples/",
+    "cache/",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AiondaDotCom/mcp-wordpress.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AiondaDotCom/mcp-wordpress/issues"
+  },
+  "homepage": "https://github.com/AiondaDotCom/mcp-wordpress#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "lint-staged": {
+    "*.{ts,js}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.md": [
+      "markdownlint --fix"
+    ],
+    "package.json": [
+      "sort-package-json"
+    ]
+  }
+}