mcp-wordpress 1.1.2

package/dist/tools/comments.js

@@ -0,0 +1,228 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Provides tools for managing comments on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class CommentTools {
+    /**
+     * Retrieves the list of comment management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_list_comments",
+                description: "Lists comments from a WordPress site, with filters.",
+                parameters: [
+                    {
+                        name: "post",
+                        type: "number",
+                        description: "Limit results to comments assigned to a specific post ID.",
+                    },
+                    {
+                        name: "status",
+                        type: "string",
+                        description: "Filter by comment status.",
+                        enum: ["hold", "approve", "spam", "trash"],
+                    },
+                ],
+                handler: this.handleListComments.bind(this),
+            },
+            {
+                name: "wp_get_comment",
+                description: "Retrieves a single comment by its ID.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The unique identifier for the comment.",
+                    },
+                ],
+                handler: this.handleGetComment.bind(this),
+            },
+            {
+                name: "wp_create_comment",
+                description: "Creates a new comment on a post.",
+                parameters: [
+                    {
+                        name: "post",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the post to comment on.",
+                    },
+                    {
+                        name: "content",
+                        type: "string",
+                        required: true,
+                        description: "The content of the comment.",
+                    },
+                    {
+                        name: "author_name",
+                        type: "string",
+                        description: "The name of the comment author.",
+                    },
+                    {
+                        name: "author_email",
+                        type: "string",
+                        description: "The email of the comment author.",
+                    },
+                ],
+                handler: this.handleCreateComment.bind(this),
+            },
+            {
+                name: "wp_update_comment",
+                description: "Updates an existing comment.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the comment to update.",
+                    },
+                    {
+                        name: "content",
+                        type: "string",
+                        description: "The updated content for the comment.",
+                    },
+                    {
+                        name: "status",
+                        type: "string",
+                        description: "The new status for the comment.",
+                        enum: ["hold", "approve", "spam", "trash"],
+                    },
+                ],
+                handler: this.handleUpdateComment.bind(this),
+            },
+            {
+                name: "wp_delete_comment",
+                description: "Deletes a comment.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the comment to delete.",
+                    },
+                    {
+                        name: "force",
+                        type: "boolean",
+                        description: "If true, the comment will be permanently deleted. Defaults to false (moved to trash).",
+                    },
+                ],
+                handler: this.handleDeleteComment.bind(this),
+            },
+            {
+                name: "wp_approve_comment",
+                description: "Approves a pending comment.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the comment to approve.",
+                    },
+                ],
+                handler: this.handleApproveComment.bind(this),
+            },
+            {
+                name: "wp_spam_comment",
+                description: "Marks a comment as spam.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the comment to mark as spam.",
+                    },
+                ],
+                handler: this.handleSpamComment.bind(this),
+            },
+        ];
+    }
+    async handleListComments(client, params) {
+        try {
+            const comments = await client.getComments(params);
+            if (comments.length === 0) {
+                return "No comments found matching the criteria.";
+            }
+            const content = `Found ${comments.length} comments:\n\n` +
+                comments
+                    .map((c) => `- ID ${c.id}: By **${c.author_name}** on Post ${c.post} (${c.status})\n  > ${c.content.rendered.substring(0, 100)}...`)
+                    .join("\n");
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to list comments: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleGetComment(client, params) {
+        try {
+            const comment = await client.getComment(params.id);
+            const content = `**Comment Details (ID: ${comment.id})**\n\n` +
+                `- **Author:** ${comment.author_name}\n` +
+                `- **Post ID:** ${comment.post}\n` +
+                `- **Date:** ${new Date(comment.date).toLocaleString()}\n` +
+                `- **Status:** ${comment.status}\n` +
+                `- **Content:** ${comment.content.rendered}`;
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to get comment: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleCreateComment(client, params) {
+        try {
+            const comment = await client.createComment(params);
+            return `✅ Comment created successfully with ID: ${comment.id}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to create comment: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleUpdateComment(client, params) {
+        try {
+            const comment = await client.updateComment(params);
+            return `✅ Comment ${comment.id} updated successfully. New status: ${comment.status}.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to update comment: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleDeleteComment(client, params) {
+        try {
+            await client.deleteComment(params.id, params.force);
+            const action = params.force ? "permanently deleted" : "moved to trash";
+            return `✅ Comment ${params.id} has been ${action}.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to delete comment: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleApproveComment(client, params) {
+        try {
+            const comment = await client.updateComment({
+                id: params.id,
+                status: "approved",
+            });
+            return `✅ Comment ${comment.id} has been approved.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to approve comment: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleSpamComment(client, params) {
+        try {
+            const comment = await client.updateComment({
+                id: params.id,
+                status: "spam",
+            });
+            return `✅ Comment ${comment.id} has been marked as spam.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to mark comment as spam: ${getErrorMessage(error)}`);
+        }
+    }
+}
+export default CommentTools;
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+export { default as AuthTools } from './auth.js';
+export { default as CommentTools } from './comments.js';
+export { default as MediaTools } from './media.js';
+export { default as PageTools } from './pages.js';
+export { default as PostTools } from './posts.js';
+export { default as SiteTools } from './site.js';
+export { default as TaxonomyTools } from './taxonomies.js';
+export { default as UserTools } from './users.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+export { default as AuthTools } from './auth.js';
+export { default as CommentTools } from './comments.js';
+export { default as MediaTools } from './media.js';
+export { default as PageTools } from './pages.js';
+export { default as PostTools } from './posts.js';
+export { default as SiteTools } from './site.js';
+export { default as TaxonomyTools } from './taxonomies.js';
+export { default as UserTools } from './users.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/media.d.ts

@@ -0,0 +1,29 @@
+import { WordPressClient } from "../client/api.js";
+import { MediaQueryParams, UpdateMediaRequest, UploadMediaRequest } from "../types/wordpress.js";
+/**
+ * Provides tools for managing media on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class MediaTools {
+    /**
+     * Retrieves the list of media management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): any[];
+    handleListMedia(client: WordPressClient, params: MediaQueryParams): Promise<any>;
+    handleGetMedia(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+    handleUploadMedia(client: WordPressClient, params: UploadMediaRequest & {
+        file_path: string;
+    }): Promise<any>;
+    handleUpdateMedia(client: WordPressClient, params: UpdateMediaRequest & {
+        id: number;
+    }): Promise<any>;
+    handleDeleteMedia(client: WordPressClient, params: {
+        id: number;
+        force?: boolean;
+    }): Promise<any>;
+}
+export default MediaTools;
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACI,QAAQ,IAAI,GAAG,EAAE;IAoIX,eAAe,CAC1B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,GAAG,CAAC;IAoBF,cAAc,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;IAmBF,iBAAiB,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,GAAG,CAAC;IAaF,iBAAiB,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,GAAG,CAAC;IASF,iBAAiB,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,GAAG,CAAC;CAShB;AAED,eAAe,UAAU,CAAC"}

package/dist/tools/media.js

@@ -0,0 +1,208 @@
+import * as fs from "fs";
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Provides tools for managing media on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class MediaTools {
+    /**
+     * Retrieves the list of media management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_list_media",
+                description: "Lists media items 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: "media_type",
+                        type: "string",
+                        description: "Limit results to a specific media type.",
+                        enum: ["image", "video", "audio", "application"],
+                    },
+                ],
+                handler: this.handleListMedia.bind(this),
+            },
+            {
+                name: "wp_get_media",
+                description: "Retrieves a single media item by its ID.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The unique identifier for the media item.",
+                    },
+                ],
+                handler: this.handleGetMedia.bind(this),
+            },
+            {
+                name: "wp_upload_media",
+                description: "Uploads a file to the WordPress media library.",
+                parameters: [
+                    {
+                        name: "file_path",
+                        type: "string",
+                        required: true,
+                        description: "The local, absolute path to the file to upload.",
+                    },
+                    {
+                        name: "title",
+                        type: "string",
+                        description: "The title for the media item.",
+                    },
+                    {
+                        name: "alt_text",
+                        type: "string",
+                        description: "Alternative text for the media item (for accessibility).",
+                    },
+                    {
+                        name: "caption",
+                        type: "string",
+                        description: "The caption for the media item.",
+                    },
+                    {
+                        name: "description",
+                        type: "string",
+                        description: "The description for the media item.",
+                    },
+                    {
+                        name: "post",
+                        type: "number",
+                        description: "The ID of a post to attach this media to.",
+                    },
+                ],
+                handler: this.handleUploadMedia.bind(this),
+            },
+            {
+                name: "wp_update_media",
+                description: "Updates the metadata of an existing media item.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the media item to update.",
+                    },
+                    {
+                        name: "title",
+                        type: "string",
+                        description: "The new title for the media item.",
+                    },
+                    {
+                        name: "alt_text",
+                        type: "string",
+                        description: "The new alternative text.",
+                    },
+                    {
+                        name: "caption",
+                        type: "string",
+                        description: "The new caption.",
+                    },
+                    {
+                        name: "description",
+                        type: "string",
+                        description: "The new description.",
+                    },
+                ],
+                handler: this.handleUpdateMedia.bind(this),
+            },
+            {
+                name: "wp_delete_media",
+                description: "Deletes a media item.",
+                parameters: [
+                    {
+                        name: "id",
+                        type: "number",
+                        required: true,
+                        description: "The ID of the media item to delete.",
+                    },
+                    {
+                        name: "force",
+                        type: "boolean",
+                        description: "If true, permanently delete. If false, move to trash. Defaults to false.",
+                    },
+                ],
+                handler: this.handleDeleteMedia.bind(this),
+            },
+        ];
+    }
+    async handleListMedia(client, params) {
+        try {
+            const media = await client.getMedia(params);
+            if (media.length === 0) {
+                return "No media items found matching the criteria.";
+            }
+            const content = `Found ${media.length} media items:\n\n` +
+                media
+                    .map((m) => `- ID ${m.id}: **${m.title.rendered}** (${m.mime_type})\n  Link: ${m.source_url}`)
+                    .join("\n");
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to list media: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleGetMedia(client, params) {
+        try {
+            const media = await client.getMediaItem(params.id);
+            const content = `**Media Details (ID: ${media.id})**\n\n` +
+                `- **Title:** ${media.title.rendered}\n` +
+                `- **URL:** ${media.source_url}\n` +
+                `- **Type:** ${media.media_type} (${media.mime_type})\n` +
+                `- **Date:** ${new Date(media.date).toLocaleString()}\n` +
+                (media.alt_text ? `- **Alt Text:** ${media.alt_text}\n` : "") +
+                (media.caption.rendered
+                    ? `- **Caption:** ${media.caption.rendered}\n`
+                    : "");
+            return content;
+        }
+        catch (error) {
+            throw new Error(`Failed to get media item: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleUploadMedia(client, params) {
+        try {
+            if (!fs.existsSync(params.file_path)) {
+                throw new Error(`File not found at path: ${params.file_path}`);
+            }
+            const media = await client.uploadMedia(params);
+            return `✅ Media uploaded successfully!\n- ID: ${media.id}\n- Title: ${media.title.rendered}\n- URL: ${media.source_url}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to upload media: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleUpdateMedia(client, params) {
+        try {
+            const media = await client.updateMedia(params);
+            return `✅ Media ${media.id} updated successfully.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to update media: ${getErrorMessage(error)}`);
+        }
+    }
+    async handleDeleteMedia(client, params) {
+        try {
+            await client.deleteMedia(params.id, params.force);
+            const action = params.force ? "permanently deleted" : "moved to trash";
+            return `✅ Media item ${params.id} has been ${action}.`;
+        }
+        catch (error) {
+            throw new Error(`Failed to delete media: ${getErrorMessage(error)}`);
+        }
+    }
+}
+export default MediaTools;
+//# sourceMappingURL=media.js.map

package/dist/tools/media.js.map

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

package/dist/tools/pages.d.ts

@@ -0,0 +1,30 @@
+import { WordPressClient } from "../client/api.js";
+import { CreatePostRequest, PostQueryParams, UpdatePostRequest } from "../types/wordpress.js";
+/**
+ * Provides tools for managing pages on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class PageTools {
+    /**
+     * Retrieves the list of page management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): any[];
+    handleListPages(client: WordPressClient, params: PostQueryParams): Promise<any>;
+    handleGetPage(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+    handleCreatePage(client: WordPressClient, params: CreatePostRequest): Promise<any>;
+    handleUpdatePage(client: WordPressClient, params: UpdatePostRequest & {
+        id: number;
+    }): Promise<any>;
+    handleDeletePage(client: WordPressClient, params: {
+        id: number;
+        force?: boolean;
+    }): Promise<any>;
+    handleGetPageRevisions(client: WordPressClient, params: {
+        id: number;
+    }): Promise<any>;
+}
+export default PageTools;
+//# sourceMappingURL=pages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/tools/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACI,QAAQ,IAAI,GAAG,EAAE;IA8HX,eAAe,CAC1B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,GAAG,CAAC;IAoBF,aAAa,CACxB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;IAeF,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,GAAG,CAAC;IASF,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,iBAAiB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,GAAG,CAAC;IASF,gBAAgB,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,GAAG,CAAC;IAUF,sBAAsB,CACjC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACrB,OAAO,CAAC,GAAG,CAAC;CAmBhB;AAED,eAAe,SAAS,CAAC"}