mcp-wordpress 2.4.2 → 2.5.1

package/dist/src/tools/pages.js

@@ -0,0 +1,215 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Provides tools for managing pages on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class PageTools {
+    /**
+     * Retrieves the list of page management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_list_pages",
+                description: "Lists pages from a WordPress site, with filters.",
+                parameters: [
+                    {
+                        name: "per_page",
+                        type: "number",
+                        description: "Number of items to return per page (max 100).",
+                    },
+                    {
+                        name: "search",
+                        type: "string",
+                        description: "Limit results to those matching a search term.",
+                    },
+                    {
+                        name: "status",
+                        type: "string",
+                        description: "Filter by page status.",
+                        enum: ["publish", "future", "draft", "pending", "private"],
+                    },
+                ],
+                handler: this.handleListPages.bind(this),
+            },
+            {
+                name: "wp_get_page",
+                description: "Retrieves a single page by its ID.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The unique identifier for the page.",
+                    },
+                ],
+                handler: this.handleGetPage.bind(this),
+            },
+            {
+                name: "wp_create_page",
+                description: "Creates a new page.",
+                parameters: [
+                    {
+                        name: "title",
+                        type: "string",
+                        required: true,
+                        description: "The title for the page.",
+                    },
+                    {
+                        name: "content",
+                        type: "string",
+                        description: "The content for the page, in HTML format.",
+                    },
+                    {
+                        name: "status",
+                        type: "string",
+                        description: "The publishing status for the page.",
+                        enum: ["publish", "draft", "pending", "private"],
+                    },
+                ],
+                handler: this.handleCreatePage.bind(this),
+            },
+            {
+                name: "wp_update_page",
+                description: "Updates an existing page.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the page to update.",
+                    },
+                    {
+                        name: "title",
+                        type: "string",
+                        description: "The new title for the page.",
+                    },
+                    {
+                        name: "content",
+                        type: "string",
+                        description: "The new content for the page, in HTML format.",
+                    },
+                    {
+                        name: "status",
+                        type: "string",
+                        description: "The new status for the page.",
+                        enum: ["publish", "draft", "pending", "private"],
+                    },
+                ],
+                handler: this.handleUpdatePage.bind(this),
+            },
+            {
+                name: "wp_delete_page",
+                description: "Deletes a page.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the page to delete.",
+                    },
+                    {
+                        name: "force",
+                        type: "boolean",
+                        description: "If true, permanently delete. If false, move to trash. Defaults to false.",
+                    },
+                ],
+                handler: this.handleDeletePage.bind(this),
+            },
+            {
+                name: "wp_get_page_revisions",
+                description: "Retrieves revisions for a specific page.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the page to get revisions for.",
+                    },
+                ],
+                handler: this.handleGetPageRevisions.bind(this),
+            },
+        ];
+    }
+    async handleListPages(client, params) {
+        const queryParams = params;
+        try {
+            const pages = await client.getPages(queryParams);
+            if (pages.length === 0) {
+                return "No pages found matching the criteria.";
+            }
+            const content = `Found ${pages.length} pages:\n\n` +
+                pages.map((p) => `- ID ${p.id}: **${p.title.rendered}** (${p.status})\n  Link: ${p.link}`).join("\n");
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to list pages: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleGetPage(client, params) {
+        const { id } = params;
+        try {
+            const page = await client.getPage(id);
+            const content = `**Page Details (ID: ${page.id})**\n\n` +
+                `- **Title:** ${page.title.rendered}\n` +
+                `- **Status:** ${page.status}\n` +
+                `- **Link:** ${page.link}\n` +
+                `- **Date:** ${new Date(page.date).toLocaleString()}`;
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to get page: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleCreatePage(client, params) {
+        const createParams = params;
+        try {
+            const page = await client.createPage(createParams);
+            return `✅ Page created successfully!\n- ID: ${page.id}\n- Title: ${page.title.rendered}\n- Link: ${page.link}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to create page: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleUpdatePage(client, params) {
+        const updateParams = params;
+        try {
+            const page = await client.updatePage(updateParams);
+            return `✅ Page ${page.id} updated successfully.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to update page: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleDeletePage(client, params) {
+        const { id, force } = params;
+        try {
+            await client.deletePage(id, force);
+            const action = params.force ? "permanently deleted" : "moved to trash";
+            return `✅ Page ${id} has been ${action}.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to delete page: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleGetPageRevisions(client, params) {
+        const { id } = params;
+        try {
+            const revisions = await client.getPageRevisions(id);
+            if (revisions.length === 0) {
+                return `No revisions found for page ${id}.`;
+            }
+            const content = `Found ${revisions.length} revisions for page ${id}:\n\n` +
+                revisions
+                    .map((r) => `- Revision by user ID ${r.author} at ${new Date(r.modified).toLocaleString()}`)
+                    .join("\n");
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to get page revisions: ${getErrorMessage(error)}`);
+        }
+    }
+}
+export default PageTools;
+//# sourceMappingURL=pages.js.map

package/dist/src/tools/pages.js.map

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

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

@@ -0,0 +1,73 @@
+/**
+ * Performance Monitoring MCP Tools for WordPress Server
+ * Provides comprehensive performance insights and management
+ */
+/**
+ * Performance Monitoring MCP Tools for WordPress Server
+ * Provides comprehensive performance insights and management
+ */
+import type { ToolDefinition } from "../server/ToolRegistry.js";
+/**
+ * Performance Tools Class
+ */
+export default class PerformanceTools {
+    private monitor;
+    private collector;
+    private analytics;
+    private logger;
+    private historicalDataInterval?;
+    constructor(clients?: Map<string, unknown>);
+    /**
+     * Get all performance monitoring tools
+     */
+    getTools(): ToolDefinition[];
+    /**
+     * Get real-time performance statistics
+     */
+    private getPerformanceStats;
+    /**
+     * Get historical performance data and trends
+     */
+    private getPerformanceHistory;
+    /**
+     * Get benchmark comparison
+     */
+    private getBenchmarkComparison;
+    /**
+     * Get performance alerts and anomalies
+     */
+    private getPerformanceAlerts;
+    /**
+     * Get optimization recommendations
+     */
+    private getOptimizationRecommendations;
+    /**
+     * Export comprehensive performance report
+     */
+    private exportPerformanceReport;
+    private calculateHealthStatus;
+    private calculatePerformanceScore;
+    private calculateCacheEfficiency;
+    private formatUptime;
+    private parseTimeframe;
+    private processHistoricalDataForChart;
+    private extractMetricValue;
+    private calculateAverage;
+    private formatBenchmarkStatus;
+    private getBenchmarkImprovementDescription;
+    private calculateOverallRanking;
+    private formatAlertMessage;
+    private formatAnomalyDescription;
+    private calculateAlertStatus;
+    private formatPriority;
+    private formatEffort;
+    private calculateEstimatedImpact;
+    private convertToCSV;
+    private createSummaryReport;
+    private startHistoricalDataCollection;
+    /**
+     * Stop historical data collection and cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=performance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/tools/performance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAWhE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,sBAAsB,CAAC,CAA6B;gBAEhD,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAuC1C;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAsM5B;;OAEG;YACW,mBAAmB;IAgGjC;;OAEG;YACW,qBAAqB;IAoDnC;;OAEG;YACW,sBAAsB;IAgEpC;;OAEG;YACW,oBAAoB;IAkElC;;OAEG;YACW,8BAA8B;IA+E5C;;OAEG;YACW,uBAAuB;IAyErC,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,6BAA6B;IAmBrC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,kCAAkC;IAU1C,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,6BAA6B;IA8BrC;;OAEG;IACI,OAAO,IAAI,IAAI;CAOvB"}