mcp-wordpress 1.1.2

package/src/tools/pages.ts

@@ -0,0 +1,246 @@
+import { WordPressClient } from "../client/api.js";
+import {
+  CreatePostRequest,
+  PostQueryParams,
+  UpdatePostRequest,
+} from "../types/wordpress.js";
+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.
+   */
+  public getTools(): any[] {
+    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),
+      },
+    ];
+  }
+
+  public async handleListPages(
+    client: WordPressClient,
+    params: PostQueryParams,
+  ): Promise<any> {
+    try {
+      const pages = await client.getPages(params);
+      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)}`);
+    }
+  }
+
+  public async handleGetPage(
+    client: WordPressClient,
+    params: { id: number },
+  ): Promise<any> {
+    try {
+      const page = await client.getPage(params.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)}`);
+    }
+  }
+
+  public async handleCreatePage(
+    client: WordPressClient,
+    params: CreatePostRequest,
+  ): Promise<any> {
+    try {
+      const page = await client.createPage(params);
+      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)}`);
+    }
+  }
+
+  public async handleUpdatePage(
+    client: WordPressClient,
+    params: UpdatePostRequest & { id: number },
+  ): Promise<any> {
+    try {
+      const page = await client.updatePage(params);
+      return `✅ Page ${page.id} updated successfully.`;
+    } catch (error) {
+      throw new Error(`Failed to update page: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleDeletePage(
+    client: WordPressClient,
+    params: { id: number; force?: boolean },
+  ): Promise<any> {
+    try {
+      await client.deletePage(params.id, params.force);
+      const action = params.force ? "permanently deleted" : "moved to trash";
+      return `✅ Page ${params.id} has been ${action}.`;
+    } catch (error) {
+      throw new Error(`Failed to delete page: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleGetPageRevisions(
+    client: WordPressClient,
+    params: { id: number },
+  ): Promise<any> {
+    try {
+      const revisions = await client.getPageRevisions(params.id);
+      if (revisions.length === 0) {
+        return `No revisions found for page ${params.id}.`;
+      }
+      const content =
+        `Found ${revisions.length} revisions for page ${params.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;

package/src/tools/posts.ts

@@ -0,0 +1,277 @@
+import { WordPressClient } from "../client/api.js";
+import {
+  CreatePostRequest,
+  PostQueryParams,
+  UpdatePostRequest,
+} from "../types/wordpress.js";
+import { getErrorMessage } from "../utils/error.js";
+
+/**
+ * Provides tools for managing posts on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class PostTools {
+  /**
+   * Retrieves the list of post management tools.
+   * @returns An array of MCPTool definitions.
+   */
+  public getTools(): any[] {
+    return [
+      {
+        name: "wp_list_posts",
+        description: "Lists posts 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 post status.",
+            enum: ["publish", "future", "draft", "pending", "private"],
+          },
+          {
+            name: "categories",
+            type: "array",
+            items: { type: "number" },
+            description: "Limit results to posts in specific category IDs.",
+          },
+          {
+            name: "tags",
+            type: "array",
+            items: { type: "number" },
+            description: "Limit results to posts with specific tag IDs.",
+          },
+        ],
+        handler: this.handleListPosts.bind(this),
+      },
+      {
+        name: "wp_get_post",
+        description: "Retrieves a single post by its ID.",
+        parameters: [
+          {
+            name: "id",
+            type: "number",
+            required: true,
+            description: "The unique identifier for the post.",
+          },
+        ],
+        handler: this.handleGetPost.bind(this),
+      },
+      {
+        name: "wp_create_post",
+        description: "Creates a new post.",
+        parameters: [
+          {
+            name: "title",
+            type: "string",
+            required: true,
+            description: "The title for the post.",
+          },
+          {
+            name: "content",
+            type: "string",
+            description: "The content for the post, in HTML format.",
+          },
+          {
+            name: "status",
+            type: "string",
+            description: "The publishing status for the post.",
+            enum: ["publish", "draft", "pending", "private"],
+          },
+          {
+            name: "excerpt",
+            type: "string",
+            description: "The excerpt for the post.",
+          },
+          {
+            name: "categories",
+            type: "array",
+            items: { type: "number" },
+            description: "An array of category IDs to assign to the post.",
+          },
+          {
+            name: "tags",
+            type: "array",
+            items: { type: "number" },
+            description: "An array of tag IDs to assign to the post.",
+          },
+        ],
+        handler: this.handleCreatePost.bind(this),
+      },
+      {
+        name: "wp_update_post",
+        description: "Updates an existing post.",
+        parameters: [
+          {
+            name: "id",
+            type: "number",
+            required: true,
+            description: "The ID of the post to update.",
+          },
+          {
+            name: "title",
+            type: "string",
+            description: "The new title for the post.",
+          },
+          {
+            name: "content",
+            type: "string",
+            description: "The new content for the post, in HTML format.",
+          },
+          {
+            name: "status",
+            type: "string",
+            description: "The new status for the post.",
+            enum: ["publish", "draft", "pending", "private"],
+          },
+        ],
+        handler: this.handleUpdatePost.bind(this),
+      },
+      {
+        name: "wp_delete_post",
+        description: "Deletes a post.",
+        parameters: [
+          {
+            name: "id",
+            type: "number",
+            required: true,
+            description: "The ID of the post to delete.",
+          },
+          {
+            name: "force",
+            type: "boolean",
+            description:
+              "If true, permanently delete. If false, move to trash. Defaults to false.",
+          },
+        ],
+        handler: this.handleDeletePost.bind(this),
+      },
+      {
+        name: "wp_get_post_revisions",
+        description: "Retrieves revisions for a specific post.",
+        parameters: [
+          {
+            name: "id",
+            type: "number",
+            required: true,
+            description: "The ID of the post to get revisions for.",
+          },
+        ],
+        handler: this.handleGetPostRevisions.bind(this),
+      },
+    ];
+  }
+
+  public async handleListPosts(
+    client: WordPressClient,
+    params: PostQueryParams,
+  ): Promise<any> {
+    try {
+      const posts = await client.getPosts(params);
+      if (posts.length === 0) {
+        return "No posts found matching the criteria.";
+      }
+      const content =
+        `Found ${posts.length} posts:\n\n` +
+        posts
+          .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 posts: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleGetPost(
+    client: WordPressClient,
+    params: { id: number },
+  ): Promise<any> {
+    try {
+      const post = await client.getPost(params.id);
+      const content =
+        `**Post Details (ID: ${post.id})**\n\n` +
+        `- **Title:** ${post.title.rendered}\n` +
+        `- **Status:** ${post.status}\n` +
+        `- **Link:** ${post.link}\n` +
+        `- **Date:** ${new Date(post.date).toLocaleString()}`;
+      return content;
+    } catch (error) {
+      throw new Error(`Failed to get post: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleCreatePost(
+    client: WordPressClient,
+    params: CreatePostRequest,
+  ): Promise<any> {
+    try {
+      const post = await client.createPost(params);
+      return `✅ Post created successfully!\n- ID: ${post.id}\n- Title: ${post.title.rendered}\n- Link: ${post.link}`;
+    } catch (error) {
+      throw new Error(`Failed to create post: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleUpdatePost(
+    client: WordPressClient,
+    params: UpdatePostRequest & { id: number },
+  ): Promise<any> {
+    try {
+      const post = await client.updatePost(params);
+      return `✅ Post ${post.id} updated successfully.`;
+    } catch (error) {
+      throw new Error(`Failed to update post: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleDeletePost(
+    client: WordPressClient,
+    params: { id: number; force?: boolean },
+  ): Promise<any> {
+    try {
+      await client.deletePost(params.id, params.force);
+      const action = params.force ? "permanently deleted" : "moved to trash";
+      return `✅ Post ${params.id} has been ${action}.`;
+    } catch (error) {
+      throw new Error(`Failed to delete post: ${getErrorMessage(error)}`);
+    }
+  }
+
+  public async handleGetPostRevisions(
+    client: WordPressClient,
+    params: { id: number },
+  ): Promise<any> {
+    try {
+      const revisions = await client.getPostRevisions(params.id);
+      if (revisions.length === 0) {
+        return `No revisions found for post ${params.id}.`;
+      }
+      const content =
+        `Found ${revisions.length} revisions for post ${params.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 post revisions: ${getErrorMessage(error)}`);
+    }
+  }
+}
+
+export default PostTools;