mcp-wordpress 1.1.2

package/dist/index.js

@@ -0,0 +1,264 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { WordPressClient } from "./client/api.js";
+import * as Tools from "./tools/index.js";
+import { getErrorMessage } from "./utils/error.js";
+import { z } from "zod";
+// --- Constants ---
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const rootDir = path.resolve(__dirname, "..");
+const envPath = path.resolve(rootDir, ".env");
+dotenv.config({ path: envPath });
+const SERVER_VERSION = "1.1.1"; // Updated version with test fixes
+// --- Main Server Class ---
+class MCPWordPressServer {
+    server;
+    // MODIFICATION: Manages multiple WordPress clients, keyed by site ID.
+    wordpressClients = new Map();
+    initialized = false;
+    // MODIFICATION: Stores the configurations for all loaded sites.
+    siteConfigs = [];
+    constructor(mcpConfig) {
+        this.loadConfiguration(mcpConfig);
+        if (this.wordpressClients.size === 0) {
+            console.error("No WordPress sites were configured. Please create mcp-wordpress.config.json or set environment variables.");
+            process.exit(1);
+        }
+        this.server = new McpServer({
+            name: "mcp-wordpress",
+            version: SERVER_VERSION,
+        });
+        this.setupTools();
+    }
+    loadConfiguration(mcpConfig) {
+        const configPath = path.resolve(rootDir, "mcp-wordpress.config.json");
+        if (fs.existsSync(configPath)) {
+            console.error("INFO: Found mcp-wordpress.config.json, loading multi-site configuration.");
+            this.loadMultiSiteConfig(configPath);
+        }
+        else {
+            console.error("INFO: mcp-wordpress.config.json not found, falling back to environment variables for single-site mode.");
+            this.loadSingleSiteFromEnv(mcpConfig);
+        }
+    }
+    loadMultiSiteConfig(configPath) {
+        try {
+            const configFile = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(configFile);
+            if (!config.sites || !Array.isArray(config.sites)) {
+                throw new Error('Configuration file must have a "sites" array.');
+            }
+            this.siteConfigs = config.sites;
+            for (const site of this.siteConfigs) {
+                if (site.id && site.name && site.config) {
+                    const clientConfig = {
+                        baseUrl: site.config.WORDPRESS_SITE_URL,
+                        auth: {
+                            method: site.config.WORDPRESS_AUTH_METHOD ||
+                                "app-password",
+                            username: site.config.WORDPRESS_USERNAME,
+                            appPassword: site.config.WORDPRESS_APP_PASSWORD,
+                        },
+                    };
+                    const client = new WordPressClient(clientConfig);
+                    this.wordpressClients.set(site.id, client);
+                    console.error(`INFO: Initialized client for site: ${site.name} (ID: ${site.id})`);
+                }
+                else {
+                    console.warn("WARN: Skipping invalid site entry in config. Must have id, name, and config.", site);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`FATAL: Error reading or parsing mcp-wordpress.config.json: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    }
+    loadSingleSiteFromEnv(mcpConfig) {
+        const siteUrl = mcpConfig?.wordpressSiteUrl || process.env.WORDPRESS_SITE_URL;
+        const username = mcpConfig?.wordpressUsername || process.env.WORDPRESS_USERNAME;
+        const password = mcpConfig?.wordpressAppPassword || process.env.WORDPRESS_APP_PASSWORD;
+        const authMethod = (mcpConfig?.wordpressAuthMethod ||
+            process.env.WORDPRESS_AUTH_METHOD ||
+            "app-password");
+        if (!siteUrl || !username || !password) {
+            console.error("ERROR: Missing required credentials for single-site mode.");
+            console.error("Please set WORDPRESS_SITE_URL, WORDPRESS_USERNAME, and WORDPRESS_APP_PASSWORD environment variables.");
+            return;
+        }
+        const singleSiteConfig = {
+            baseUrl: siteUrl,
+            auth: { method: authMethod, username, appPassword: password },
+        };
+        const client = new WordPressClient(singleSiteConfig);
+        this.wordpressClients.set("default", client);
+        this.siteConfigs.push({
+            id: "default",
+            name: "Default Site",
+            config: singleSiteConfig,
+        });
+        console.error("INFO: Initialized client for default site in single-site mode.");
+    }
+    setupTools() {
+        // Register all tools from the tools directory
+        Object.values(Tools).forEach((ToolClass) => {
+            const toolInstance = new ToolClass();
+            const tools = toolInstance.getTools();
+            tools.forEach((tool) => {
+                this.registerTool(tool);
+            });
+        });
+    }
+    registerTool(tool) {
+        // Create base parameter schema with site parameter
+        const baseSchema = {
+            site: z.string()
+                .optional()
+                .describe("The ID of the WordPress site to target (from mcp-wordpress.config.json). Required if multiple sites are configured."),
+        };
+        // Merge with tool-specific parameters
+        const parameterSchema = tool.parameters?.reduce((schema, param) => {
+            let zodType;
+            switch (param.type) {
+                case 'string':
+                    zodType = z.string();
+                    break;
+                case 'number':
+                    zodType = z.number();
+                    break;
+                case 'boolean':
+                    zodType = z.boolean();
+                    break;
+                case 'array':
+                    zodType = z.array(z.string());
+                    break;
+                case 'object':
+                    zodType = z.record(z.any());
+                    break;
+                default:
+                    zodType = z.string();
+            }
+            if (param.description) {
+                zodType = zodType.describe(param.description);
+            }
+            if (!param.required) {
+                zodType = zodType.optional();
+            }
+            schema[param.name] = zodType;
+            return schema;
+        }, { ...baseSchema }) || baseSchema;
+        // Make site parameter required if multiple sites are configured
+        if (this.wordpressClients.size > 1) {
+            parameterSchema.site = parameterSchema.site.describe("The ID of the WordPress site to target (from mcp-wordpress.config.json). Required when multiple sites are configured.");
+        }
+        this.server.tool(tool.name, tool.description || `WordPress tool: ${tool.name}`, parameterSchema, async (args) => {
+            try {
+                const siteId = args.site || "default";
+                const client = this.wordpressClients.get(siteId);
+                if (!client) {
+                    const availableSites = Array.from(this.wordpressClients.keys()).join(", ");
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Error: Site with ID '${siteId}' not found. Available sites: ${availableSites}`
+                            }],
+                        isError: true
+                    };
+                }
+                // Call the tool handler with the client and parameters
+                const result = await tool.handler(client, args);
+                return {
+                    content: [{
+                            type: "text",
+                            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+                        }]
+                };
+            }
+            catch (error) {
+                if (this.isAuthenticationError(error)) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Authentication failed for site '${args.site || "default"}'. Please check your credentials.`
+                            }],
+                        isError: true
+                    };
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Error: ${getErrorMessage(error)}`
+                        }],
+                    isError: true
+                };
+            }
+        });
+    }
+    async testClientConnections() {
+        console.error("INFO: Testing connections to all configured WordPress sites...");
+        const connectionPromises = Array.from(this.wordpressClients.entries()).map(async ([siteId, client]) => {
+            try {
+                await client.ping();
+                console.error(`SUCCESS: Connection to site '${siteId}' successful.`);
+            }
+            catch (error) {
+                console.error(`ERROR: Failed to connect to site '${siteId}': ${getErrorMessage(error)}`);
+                if (this.isAuthenticationError(error)) {
+                    console.error(`Authentication may have failed for site '${siteId}'. Please check credentials.`);
+                }
+            }
+        });
+        await Promise.all(connectionPromises);
+        this.initialized = true;
+        console.error("INFO: Connection tests complete.");
+    }
+    isAuthenticationError(error) {
+        if (error?.response?.status && [401, 403].includes(error.response.status)) {
+            return true;
+        }
+        return error?.code === "WORDPRESS_AUTH_ERROR";
+    }
+    async run() {
+        if (!this.initialized) {
+            await this.testClientConnections();
+        }
+        console.error("INFO: Starting MCP WordPress Server...");
+        // Connect to stdio transport
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(`INFO: Server started and connected. Tools available for ${this.wordpressClients.size} site(s).`);
+    }
+    async shutdown() {
+        console.error("INFO: Shutting down MCP WordPress Server...");
+        await this.server.close();
+        console.error("INFO: Server stopped.");
+    }
+}
+// --- Main Execution ---
+async function main() {
+    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) {
+        console.error(`FATAL: Failed to start server: ${getErrorMessage(error)}`);
+        process.exit(1);
+    }
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main();
+}
+export default MCPWordPressServer;
+export { MCPWordPressServer };
+//# 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/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Compatibility export for tests
+ * Re-exports the main MCP server class for backward compatibility
+ */
+export { default as MCPWordPressServer } from './index.js';
+export { default } from './index.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/server.js

@@ -0,0 +1,7 @@
+/**
+ * Compatibility export for tests
+ * Re-exports the main MCP server class for backward compatibility
+ */
+export { default as MCPWordPressServer } from './index.js';
+export { default } from './index.js';
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/auth.d.ts

@@ -0,0 +1,44 @@
+import { WordPressClient } from "../client/api.js";
+import { AuthMethod } from "../types/client.js";
+/**
+ * Provides authentication-related tools for WordPress sites.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class AuthTools {
+    /**
+     * Retrieves the list of authentication tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): any[];
+    /**
+     * Handles the 'wp_test_auth' tool request.
+     * It tests the connection and fetches user details upon success.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleTestAuth(client: WordPressClient, params: any): Promise<any>;
+    /**
+     * Handles the 'wp_get_auth_status' tool request.
+     * Reports whether the client is currently authenticated.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleGetAuthStatus(client: WordPressClient, params: any): Promise<any>;
+    /**
+     * Handles the 'wp_switch_auth_method' tool request.
+     * Updates the client's authentication configuration in memory for the session.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request, including the new auth details.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    handleSwitchAuthMethod(client: WordPressClient, params: {
+        method: AuthMethod;
+        username?: string;
+        password?: string;
+        jwt_token?: string;
+    }): Promise<any>;
+}
+export default AuthTools;
+//# sourceMappingURL=auth.d.ts.map

package/dist/tools/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACI,QAAQ,IAAI,GAAG,EAAE;IAmDxB;;;;;;OAMG;IACU,cAAc,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC;IAoBf;;;;;;OAMG;IACU,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC;IAsBf;;;;;;OAMG;IACU,sBAAsB,CACjC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QACN,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,GAAG,CAAC;CAShB;AAED,eAAe,SAAS,CAAC"}

package/dist/tools/auth.js

@@ -0,0 +1,126 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Provides authentication-related tools for WordPress sites.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class AuthTools {
+    /**
+     * Retrieves the list of authentication tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_test_auth",
+                description: "Tests the authentication and connectivity for a configured WordPress site.",
+                parameters: [], // The 'site' parameter is added dynamically by the server
+                handler: this.handleTestAuth.bind(this),
+            },
+            {
+                name: "wp_get_auth_status",
+                description: "Gets the current authentication status for a configured WordPress site.",
+                parameters: [],
+                handler: this.handleGetAuthStatus.bind(this),
+            },
+            {
+                name: "wp_switch_auth_method",
+                description: "Switches the authentication method for a site for the current session.",
+                parameters: [
+                    {
+                        name: "method",
+                        type: "string",
+                        required: true,
+                        description: "The new authentication method to use.",
+                        enum: ["app-password", "jwt", "basic", "api-key", "cookie"],
+                    },
+                    {
+                        name: "username",
+                        type: "string",
+                        description: "The username for 'app-password' or 'basic' authentication.",
+                    },
+                    {
+                        name: "password",
+                        type: "string",
+                        description: "The Application Password for 'app-password' or password for 'basic' auth.",
+                    },
+                    {
+                        name: "jwt_token",
+                        type: "string",
+                        description: "The token for 'jwt' authentication.",
+                    },
+                ],
+                handler: this.handleSwitchAuthMethod.bind(this),
+            },
+        ];
+    }
+    /**
+     * Handles the 'wp_test_auth' tool request.
+     * It tests the connection and fetches user details upon success.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleTestAuth(client, params) {
+        try {
+            await client.ping();
+            const user = await client.getCurrentUser();
+            const siteConfig = client.config;
+            const content = `✅ **Authentication successful!**\n\n` +
+                `**Site:** ${siteConfig.baseUrl}\n` +
+                `**Method:** ${siteConfig.auth.method}\n` +
+                `**User:** ${user.name} (@${user.slug})\n` +
+                `**Roles:** ${user.roles?.join(", ") || "N/A"}\n\n` +
+                `Your WordPress connection is working properly.`;
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Authentication test failed: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Handles the 'wp_get_auth_status' tool request.
+     * Reports whether the client is currently authenticated.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleGetAuthStatus(client, params) {
+        try {
+            const isAuthenticated = client.isAuthenticated;
+            const config = client.config;
+            let content = `**Authentication Status for ${config.baseUrl}**\n\n` +
+                `**Authenticated:** ${isAuthenticated ? "✅ Yes" : "❌ No"}\n` +
+                `**Method:** ${config.auth.method}\n`;
+            if (isAuthenticated) {
+                const user = await client.getCurrentUser();
+                content += `**User:** ${user.name} (@${user.slug})\n`;
+            }
+            else {
+                content += `**Status:** Not connected. Use 'wp_test_auth' to connect and verify credentials.`;
+            }
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to get auth status: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Handles the 'wp_switch_auth_method' tool request.
+     * Updates the client's authentication configuration in memory for the session.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request, including the new auth details.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleSwitchAuthMethod(client, params) {
+        try {
+            // This functionality is not currently supported as the client
+            // doesn't have an updateAuthConfig method
+            throw new Error("Dynamic authentication method switching is not currently supported. Please update your configuration file and restart the server.");
+        }
+        catch (error) {
+            throw new Error(`Failed to switch auth method: ${getErrorMessage(error)}`);
+        }
+    }
+}
+export default AuthTools;
+//# sourceMappingURL=auth.js.map

package/dist/tools/auth.js.map

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

package/dist/tools/base.d.ts

@@ -0,0 +1,37 @@
+import { WordPressClient } from "../client/api.js";
+/**
+ * Base class for all WordPress tool categories.
+ * Provides common functionality and error handling for tool implementations.
+ */
+export declare abstract class BaseToolClass {
+    protected client: WordPressClient;
+    constructor(client: WordPressClient);
+    /**
+     * Abstract method that must be implemented by subclasses to return their tool definitions.
+     * @returns An array of MCPTool definitions.
+     */
+    abstract getTools(): any[];
+    /**
+     * Common error handler for all tools.
+     * @param error The error to handle
+     * @param operation The operation that failed
+     * @throws Error with formatted message
+     */
+    protected handleError(error: unknown, operation: string): never;
+    /**
+     * Validates required parameters are not undefined or null.
+     * @param params Object containing parameters to validate
+     * @param required Array of required parameter names
+     * @throws Error if any required parameter is missing
+     */
+    protected validateRequiredParams(params: Record<string, any>, required: string[]): void;
+    /**
+     * Resolves the appropriate WordPress client for multi-site support.
+     * @param site Optional site ID for multi-site configurations
+     * @param clients Map of site IDs to WordPress clients
+     * @returns The resolved WordPress client
+     * @throws Error if site is not found or ambiguous
+     */
+    protected resolveClient(site: string | undefined, clients: Map<string, WordPressClient>): WordPressClient;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;GAGG;AACH,8BAAsB,aAAa;IACrB,SAAS,CAAC,MAAM,EAAE,eAAe;gBAAvB,MAAM,EAAE,eAAe;IAE7C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,IAAI,GAAG,EAAE;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAI/D;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAQvF;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACpC,eAAe;CA6BnB"}

package/dist/tools/base.js

@@ -0,0 +1,60 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Base class for all WordPress tool categories.
+ * Provides common functionality and error handling for tool implementations.
+ */
+export class BaseToolClass {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Common error handler for all tools.
+     * @param error The error to handle
+     * @param operation The operation that failed
+     * @throws Error with formatted message
+     */
+    handleError(error, operation) {
+        throw new Error(`Failed to ${operation}: ${getErrorMessage(error)}`);
+    }
+    /**
+     * Validates required parameters are not undefined or null.
+     * @param params Object containing parameters to validate
+     * @param required Array of required parameter names
+     * @throws Error if any required parameter is missing
+     */
+    validateRequiredParams(params, required) {
+        for (const param of required) {
+            if (params[param] === undefined || params[param] === null) {
+                throw new Error(`Missing required parameter: ${param}`);
+            }
+        }
+    }
+    /**
+     * Resolves the appropriate WordPress client for multi-site support.
+     * @param site Optional site ID for multi-site configurations
+     * @param clients Map of site IDs to WordPress clients
+     * @returns The resolved WordPress client
+     * @throws Error if site is not found or ambiguous
+     */
+    resolveClient(site, clients) {
+        if (clients.size === 0) {
+            throw new Error("No WordPress clients configured");
+        }
+        if (clients.size === 1 && !site) {
+            return Array.from(clients.values())[0];
+        }
+        if (!site && clients.size > 1) {
+            throw new Error(`Multiple sites configured. Please specify --site parameter with one of: ${Array.from(clients.keys()).join(", ")}`);
+        }
+        if (site) {
+            const client = clients.get(site);
+            if (!client) {
+                throw new Error(`Site "${site}" not found. Available sites: ${Array.from(clients.keys()).join(", ")}`);
+            }
+            return client;
+        }
+        return this.client;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAgB,aAAa;IACX;IAAtB,YAAsB,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAQjD;;;;;OAKG;IACO,WAAW,CAAC,KAAc,EAAE,SAAiB;QACrD,MAAM,IAAI,KAAK,CAAC,aAAa,SAAS,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACO,sBAAsB,CAAC,MAA2B,EAAE,QAAkB;QAC9E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACO,aAAa,CACrB,IAAwB,EACxB,OAAqC;QAErC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,2EAA2E,KAAK,CAAC,IAAI,CACnF,OAAO,CAAC,IAAI,EAAE,CACf,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACf,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,iCAAiC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,33 @@
+import { WordPressClient } from "../client/api.js";
+import { CommentQueryParams, CreateCommentRequest, UpdateCommentRequest } from "../types/wordpress.js";
+/**
+ * Provides tools for managing comments on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class CommentTools {
+    /**
+     * Retrieves the list of comment management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): any[];
+    handleListComments(client: WordPressClient, params: CommentQueryParams): Promise<any>;
+    handleGetComment(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+    handleCreateComment(client: WordPressClient, params: CreateCommentRequest): Promise<any>;
+    handleUpdateComment(client: WordPressClient, params: UpdateCommentRequest & {
+        id: number;
+    }): Promise<any>;
+    handleDeleteComment(client: WordPressClient, params: {
+        id: number;
+        force?: boolean;
+    }): Promise<any>;
+    handleApproveComment(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+    handleSpamComment(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+}
+export default CommentTools;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACI,QAAQ,IAAI,GAAG,EAAE;IAuIX,kBAAkB,CAC7B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,GAAG,CAAC;IAoBF,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;IAgBF,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,GAAG,CAAC;IASF,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,oBAAoB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,GAAG,CAAC;IASF,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,GAAG,CAAC;IAUF,oBAAoB,CAC/B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;IAYF,iBAAiB,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;CAWhB;AAED,eAAe,YAAY,CAAC"}