mcp-wordpress 3.1.8 → 3.1.10

package/src/tools/media.ts

@@ -2,6 +2,7 @@ import * as fs from "fs";
 import { WordPressClient } from "@/client/api.js";
 import { MediaQueryParams, UpdateMediaRequest, UploadMediaRequest } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
+import { toolParams } from "./params.js";
 
 /**
  * Comprehensive media management tools for WordPress sites.
@@ -228,7 +229,7 @@ export class MediaTools {
   }
 
   public async handleUploadMedia(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const uploadParams = params as unknown as UploadMediaRequest & { file_path: string };
+    const uploadParams = toolParams<UploadMediaRequest & { file_path: string }>(params);
     try {
       try {
         await fs.promises.access(uploadParams.file_path);
@@ -244,7 +245,7 @@ export class MediaTools {
   }
 
   public async handleUpdateMedia(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const updateParams = params as unknown as UpdateMediaRequest & { id: number };
+    const updateParams = toolParams<UpdateMediaRequest & { id: number }>(params);
     try {
       const media = await client.updateMedia(updateParams);
       return `✅ Media ${media.id} updated successfully.`;

package/src/tools/pages.ts

@@ -1,6 +1,7 @@
 import { WordPressClient } from "@/client/api.js";
 import { CreatePageRequest, PostQueryParams as PageQueryParams, UpdatePageRequest } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
+import { toolParams } from "./params.js";
 
 /**
  * Provides tools for managing pages on a WordPress site.
@@ -154,7 +155,7 @@ export class PageTools {
   }
 
   public async handleListPages(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const queryParams = params as unknown as PageQueryParams;
+    const queryParams = toolParams<PageQueryParams>(params);
     try {
       const pages = await client.getPages(queryParams);
       if (pages.length === 0) {
@@ -191,7 +192,7 @@ export class PageTools {
   }
 
   public async handleCreatePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const createParams = params as unknown as CreatePageRequest;
+    const createParams = toolParams<CreatePageRequest>(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}`;
@@ -201,7 +202,7 @@ export class PageTools {
   }
 
   public async handleUpdatePage(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const updateParams = params as unknown as UpdatePageRequest & { id: number };
+    const updateParams = toolParams<UpdatePageRequest & { id: number }>(params);
     try {
       const page = await client.updatePage(updateParams);
       return `✅ Page ${page.id} updated successfully.`;

package/src/tools/params.ts

@@ -0,0 +1,14 @@
+/**
+ * Type-safe parameter casting for tool handlers.
+ *
+ * Tool handler parameters arrive as Record<string, unknown> but have already
+ * been validated by Zod in ToolRegistry.registerTool(). This utility provides
+ * a centralized, documented assertion that replaces scattered `as unknown as T`
+ * casts throughout tool handlers.
+ *
+ * @example
+ *   const data = toolParams<CreatePostRequest>(params);
+ */
+export function toolParams<T>(params: Record<string, unknown>): T {
+  return params as T;
+}

package/src/tools/taxonomies.ts

@@ -1,11 +1,7 @@
 import { WordPressClient } from "@/client/api.js";
-import {
-  CreateCategoryRequest,
-  CreateTagRequest,
-  UpdateCategoryRequest,
-  UpdateTagRequest,
-} from "@/types/wordpress.js";
+import { CreateCategoryRequest, CreateTagRequest, UpdateCategoryRequest, UpdateTagRequest } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
+import { toolParams } from "./params.js";
 
 /**
  * Provides tools for managing taxonomies (categories and tags) on a WordPress site.
@@ -216,7 +212,7 @@ export class TaxonomyTools {
   }
 
   public async handleCreateCategory(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const createParams = params as unknown as CreateCategoryRequest;
+    const createParams = toolParams<CreateCategoryRequest>(params);
     try {
       const category = await client.createCategory(createParams);
       return `✅ Category "${category.name}" created successfully with ID: ${category.id}.`;
@@ -226,7 +222,7 @@ export class TaxonomyTools {
   }
 
   public async handleUpdateCategory(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const updateParams = params as unknown as UpdateCategoryRequest;
+    const updateParams = toolParams<UpdateCategoryRequest>(params);
     try {
       const category = await client.updateCategory(updateParams);
       return `✅ Category ${category.id} updated successfully.`;
@@ -277,7 +273,7 @@ export class TaxonomyTools {
   }
 
   public async handleCreateTag(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const createParams = params as unknown as CreateTagRequest;
+    const createParams = toolParams<CreateTagRequest>(params);
     try {
       const tag = await client.createTag(createParams);
       return `✅ Tag "${tag.name}" created successfully with ID: ${tag.id}.`;
@@ -287,7 +283,7 @@ export class TaxonomyTools {
   }
 
   public async handleUpdateTag(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const updateParams = params as unknown as UpdateTagRequest;
+    const updateParams = toolParams<UpdateTagRequest>(params);
     try {
       const tag = await client.updateTag(updateParams);
       return `✅ Tag ${tag.id} updated successfully.`;

package/src/tools/users.ts

@@ -2,6 +2,7 @@ import { WordPressClient } from "@/client/api.js";
 import { CreateUserRequest, UpdateUserRequest, UserQueryParams } from "@/types/wordpress.js";
 import { getErrorMessage } from "@/utils/error.js";
 import { WordPressDataStreamer, StreamingUtils, StreamingResult } from "@/utils/streaming.js";
+import { toolParams } from "./params.js";
 
 /**
  * Provides tools for managing users on a WordPress site.
@@ -313,7 +314,7 @@ export class UserTools {
   }
 
   public async handleCreateUser(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const createParams = params as unknown as CreateUserRequest;
+    const createParams = toolParams<CreateUserRequest>(params);
     try {
       const user = await client.createUser(createParams);
       return `✅ User "${user.name}" created successfully with ID: ${user.id}.`;
@@ -323,7 +324,7 @@ export class UserTools {
   }
 
   public async handleUpdateUser(client: WordPressClient, params: Record<string, unknown>): Promise<unknown> {
-    const updateParams = params as unknown as UpdateUserRequest;
+    const updateParams = toolParams<UpdateUserRequest>(params);
     try {
       const user = await client.updateUser(updateParams);
       return `✅ User ${user.id} updated successfully.`;