@kontent-ai/mcp-server 0.21.9 → 0.21.11

package/build/tools/update-content-item-mapi.js

@@ -3,14 +3,14 @@ import { createMapiClient } from "../clients/kontentClients.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("update-content-item-mapi", "Update existing Kontent.ai content item by internal ID via Management API. The content item must already exist - this tool will not create new items.", {
-        id: z.string().describe("Internal ID of the content item to update"),
+    server.tool("update-content-item-mapi", "Update Kontent.ai content item", {
+        id: z.string().describe("Content item ID"),
         name: z
             .string()
             .min(1)
             .max(200)
             .optional()
-            .describe("New display name of the content item (1-200 characters, optional)"),
+            .describe("New name (1-200 chars)"),
         collection: z
             .object({
             id: z.string().optional(),
@@ -18,7 +18,7 @@ export const registerTool = (server) => {
             external_id: z.string().optional(),
         })
             .optional()
-            .describe("Reference to a collection by id, codename, or external_id (optional)"),
+            .describe("Collection reference"),
     }, async ({ id, name, collection }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {

package/build/tools/upsert-language-variant-mapi.js

@@ -2,20 +2,17 @@ import { z } from "zod";
 import { createMapiClient } from "../clients/kontentClients.js";
 import { languageVariantElementSchema } from "../schemas/contentItemSchemas.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
-import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+import { createVariantMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("upsert-language-variant-mapi", "Create or update Kontent.ai language variant of a content item via Management API. This adds actual content to the content item elements. When updating an existing variant, only the provided elements will be modified.", {
-        itemId: z.string().describe("Internal ID of the content item"),
+    server.tool("upsert-language-variant-mapi", "Create or update Kontent.ai variant", {
+        itemId: z.string().describe("Content item ID"),
         languageId: z
             .string()
-            .describe("Internal ID of the language variant (e.g., '00000000-0000-0000-0000-000000000000' for default language)"),
+            .describe("Language variant ID (default: 00000000-0000-0000-0000-000000000000)"),
         elements: z
             .array(languageVariantElementSchema)
-            .describe("Array of content elements, each with 'element' (reference object with id/codename/external_id) and 'value' properties. Additional properties may be required depending on element type (e.g., 'mode' for URL slugs)."),
-        workflow_step_id: z
-            .string()
-            .optional()
-            .describe("Internal ID of the workflow step (optional)"),
+            .describe("Content elements array"),
+        workflow_step_id: z.string().optional().describe("Workflow step ID"),
     }, async ({ itemId, languageId, elements, workflow_step_id }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         const data = {
@@ -31,7 +28,7 @@ export const registerTool = (server) => {
                 .byLanguageId(languageId)
                 .withData(() => data)
                 .toPromise();
-            return createMcpToolSuccessResponse(response.rawData);
+            return createVariantMcpToolSuccessResponse(response.rawData);
         }
         catch (error) {
             return handleMcpToolError(error, "Language Variant Upsert");

package/build/utils/responseHelper.js

@@ -1,17 +1,101 @@
 /**
  * Utility for creating standardized MCP tool success responses
  */
-/**
- * Creates a standardized MCP tool success response
- * @param data The data to include in the response
- * @returns Standardized MCP tool success response
- */
+export function isEmptyOrDefault(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === "string" && value === "") {
+        return true;
+    }
+    if (typeof value === "string" && value === "<p><br/></p>") {
+        return true;
+    }
+    if (Array.isArray(value) && value.length === 0) {
+        return true;
+    }
+    if (typeof value === "object" &&
+        !Array.isArray(value) &&
+        !(value instanceof Date) &&
+        !(value instanceof Function) &&
+        Object.keys(value).length === 0) {
+        return true;
+    }
+    return false;
+}
+export function removeEmptyElementsFromVariant(obj) {
+    if (obj === null || obj === undefined || typeof obj !== "object") {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => removeEmptyElementsFromVariant(item));
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === "elements" && Array.isArray(value)) {
+            const filteredElements = value
+                .filter((element) => {
+                if (typeof element !== "object" || element === null) {
+                    return true;
+                }
+                const keys = Object.keys(element);
+                return !(keys.length === 1 && keys[0] === "element");
+            })
+                .map((element) => removeEmptyElementsFromVariant(element));
+            if (filteredElements.length > 0) {
+                result[key] = filteredElements;
+            }
+        }
+        else {
+            const processedValue = removeEmptyElementsFromVariant(value);
+            if (processedValue !== undefined) {
+                result[key] = processedValue;
+            }
+        }
+    }
+    return result;
+}
+export function removeEmptyValues(obj) {
+    if (obj === null || obj === undefined) {
+        return undefined;
+    }
+    if (typeof obj !== "object") {
+        return isEmptyOrDefault(obj) ? undefined : obj;
+    }
+    if (Array.isArray(obj)) {
+        const cleaned = obj
+            .map((item) => removeEmptyValues(item))
+            .filter((item) => item !== undefined);
+        return cleaned.length === 0 ? undefined : cleaned;
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const cleanedValue = removeEmptyValues(value);
+        if (cleanedValue !== undefined) {
+            cleaned[key] = cleanedValue;
+        }
+    }
+    const keys = Object.keys(cleaned);
+    return keys.length === 0 ? undefined : cleaned;
+}
 export const createMcpToolSuccessResponse = (data) => {
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(data),
+                text: JSON.stringify(removeEmptyValues(data)),
+            },
+        ],
+    };
+};
+export const createVariantMcpToolSuccessResponse = (data) => {
+    const cleaned = removeEmptyValues(data);
+    const optimized = removeEmptyElementsFromVariant(cleaned);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(optimized),
             },
         ],
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontent-ai/mcp-server",
-  "version": "0.21.9",
+  "version": "0.21.11",
   "type": "module",
   "mcpName": "io.github.kontent-ai/mcp-server",
   "scripts": {
@@ -11,6 +11,7 @@
     "dev:shttp": "tsx watch src/bin.ts shttp",
     "format": "cross-env biome ci",
     "format:fix": "cross-env biome check --fix --unsafe",
+    "test": "npm run build && mocha --timeout 10s -- \"build/test/**/*.spec.js\"",
     "sync-version": "node --experimental-strip-types scripts/syncVersion.ts",
     "version": "npm run sync-version sync && npm run format:fix -- server.json && git add server.json"
   },
@@ -35,8 +36,10 @@
   "devDependencies": {
     "@biomejs/biome": "^2.0.5",
     "@types/express": "^5.0.2",
+    "@types/mocha": "^10.0.10",
     "@types/node": "^22.15.19",
     "cross-env": "^7.0.3",
+    "mocha": "^11.7.5",
     "rimraf": "^6.0.1",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3"