@kontent-ai/mcp-server 0.5.0 → 0.6.0

package/README.md

@@ -19,19 +19,13 @@ Kontent.ai MCP Server implements the Model Context Protocol to connect your Kont
 
 ## Table of Contents
 
-* [🔌 Quickstart](#-quickstart)
-  * [🔑 Prerequisites](#-prerequisites)
-  * [🛠 Setup Options](#-setup-options)
-* [🛠️ Available Tools](#️-available-tools)
-* [⚙️ Configuration](#️-configuration)
-* [🚀 Transport Options](#-transport-options)
-  * [📟 STDIO Transport](#-stdio-transport)
-  * [🌐 SSE Transport](#-sse-transport)
-* [💻 Development](#-development)
-  * [🛠 Local Installation](#-local-installation)
-  * [📂 Project Structure](#-project-structure)
-  * [🔍 Debugging](#-debugging)
-* [License](#license)
+- [✨ Key Features](#-key-features)
+- [🔌 Quickstart](#-quickstart)
+- [🛠️ Available Tools](#️-available-tools)
+- [⚙️ Configuration](#️-configuration)
+- [🚀 Transport Options](#-transport-options)
+- [💻 Development](#-development)
+- [License](#license)
 
 ## 🔌 Quickstart
 
@@ -86,7 +80,10 @@ npx @kontent-ai/mcp-server@latest sse
 * **get-item-dapi** – Get a content item by codename from Delivery API
 * **get-variant-mapi** – Get a language variant of a content item
 * **add-content-item-mapi** – Create a new content item (structure only)
+* **update-content-item-mapi** – Update an existing content item by codename (name, collection)
+* **delete-content-item-mapi** – Delete a content item by codename
 * **upsert-language-variant-mapi** – Create or update a language variant with content
+* **delete-language-variant-mapi** – Delete a language variant of a content item
 
 ### Asset Management
 
@@ -168,6 +165,10 @@ npm run build
 # Start the server
 npm run start:sse  # For SSE transport
 npm run start:stdio  # For STDIO transport
+
+# Start the server with automatic reloading (no need to build first)
+npm run dev:sse  # For SSE transport
+npm run dev:stdio  # For STDIO transport
 ```
 
 ### 📂 Project Structure

package/build/server.js

@@ -4,6 +4,8 @@ import { registerTool as registerAddContentItemMapi } from "./tools/add-content-
 import { registerTool as registerAddContentTypeMapi } from "./tools/add-content-type-mapi.js";
 import { registerTool as registerAddContentTypeSnippetMapi } from "./tools/add-content-type-snippet-mapi.js";
 import { registerTool as registerAddTaxonomyGroupMapi } from "./tools/add-taxonomy-group-mapi.js";
+import { registerTool as registerDeleteContentItemMapi } from "./tools/delete-content-item-mapi.js";
+import { registerTool as registerDeleteLanguageVariantMapi } from "./tools/delete-language-variant-mapi.js";
 import { registerTool as registerGetAssetMapi } from "./tools/get-asset-mapi.js";
 import { registerTool as registerGetItemDapi } from "./tools/get-item-dapi.js";
 import { registerTool as registerGetItemMapi } from "./tools/get-item-mapi.js";
@@ -16,6 +18,7 @@ import { registerTool as registerListContentTypeSnippetsMapi } from "./tools/lis
 import { registerTool as registerListContentTypesMapi } from "./tools/list-content-types-mapi.js";
 import { registerTool as registerListLanguagesMapi } from "./tools/list-languages-mapi.js";
 import { registerTool as registerListTaxonomyGroupsMapi } from "./tools/list-taxonomy-groups-mapi.js";
+import { registerTool as registerUpdateContentItemMapi } from "./tools/update-content-item-mapi.js";
 import { registerTool as registerUpsertLanguageVariantMapi } from "./tools/upsert-language-variant-mapi.js";
 // Create server instance
 export const createServer = () => {
@@ -44,6 +47,9 @@ export const createServer = () => {
     registerListTaxonomyGroupsMapi(server);
     registerGetTaxonomyGroupMapi(server);
     registerAddContentItemMapi(server);
+    registerUpdateContentItemMapi(server);
+    registerDeleteContentItemMapi(server);
     registerUpsertLanguageVariantMapi(server);
+    registerDeleteLanguageVariantMapi(server);
     return { server };
 };

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-content-item-mapi", "Delete a content item by codename from Management API", {
+        codename: z.string().describe("Codename of the content item to delete"),
+    }, async ({ codename }) => {
+        const client = createMapiClient();
+        try {
+            const response = await client
+                .deleteContentItem()
+                .byItemCodename(codename)
+                .toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Content item '${codename}' deleted successfully`,
+                deletedItem: response.data,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Content Item Deletion");
+        }
+    });
+};

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-language-variant-mapi", "Delete a language variant of a content item from Management API", {
+        itemCodename: z.string().describe("Codename of the content item"),
+        languageCodename: z
+            .string()
+            .describe("Codename of the language variant to delete"),
+    }, async ({ itemCodename, languageCodename }) => {
+        const client = createMapiClient();
+        try {
+            const response = await client
+                .deleteLanguageVariant()
+                .byItemCodename(itemCodename)
+                .byLanguageCodename(languageCodename)
+                .toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Language variant '${languageCodename}' of content item '${itemCodename}' deleted successfully`,
+                deletedVariant: response.data,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Language Variant Deletion");
+        }
+    });
+};

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

@@ -0,0 +1,74 @@
+import { z } from "zod";
+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 an existing content item by codename via Management API. The content item must already exist - this tool will not create new items.", {
+        codename: z.string().describe("Codename of the content item to update"),
+        name: z
+            .string()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("New display name of the content item (1-200 characters, optional)"),
+        collection: z
+            .object({
+            id: z.string().optional(),
+            codename: z.string().optional(),
+            external_id: z.string().optional(),
+        })
+            .optional()
+            .describe("Reference to a collection by id, codename, or external_id (optional)"),
+    }, async ({ codename, name, collection }) => {
+        const client = createMapiClient();
+        try {
+            // First, verify the item exists by trying to get it
+            await client.viewContentItem().byItemCodename(codename).toPromise();
+            // If we get here, the item exists, so we can update it
+            const updateData = {};
+            if (name !== undefined) {
+                updateData.name = name;
+            }
+            if (collection !== undefined) {
+                updateData.collection = collection;
+            }
+            // If no update data is provided, return an error
+            if (Object.keys(updateData).length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Update Content Item: No update data provided. At least one field (name or collection) must be specified.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const response = await client
+                .upsertContentItem()
+                .byItemCodename(codename)
+                .withData(updateData)
+                .toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Content item '${codename}' updated successfully`,
+                updatedItem: response.rawData,
+            });
+        }
+        catch (error) {
+            // Check if the error is because the item doesn't exist
+            if (error?.response?.status === 404 ||
+                error?.message?.includes("not found")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Update Content Item: Content item with codename '${codename}' does not exist. Use add-content-item-mapi to create new items.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return handleMcpToolError(error, "Content Item Update");
+        }
+    });
+};

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@kontent-ai/mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "scripts": {
     "build": "rimraf build && tsc",
     "start:stdio": "node build/bin.js stdio",
     "start:sse": "node build/bin.js sse",
+    "dev:stdio": "tsx watch src/bin.ts stdio",
+    "dev:sse": "tsx watch src/bin.ts sse",
     "format": "cross-env node node_modules/@biomejs/biome/bin/biome ci ./ --config-path=./biome.json",
     "format:fix": "cross-env node node_modules/@biomejs/biome/bin/biome check ./ --fix --unsafe  --config-path=./biome.json"
   },
@@ -32,6 +34,7 @@
     "@types/node": "^22.15.19",
     "cross-env": "^7.0.3",
     "rimraf": "^6.0.1",
+    "tsx": "^4.20.3",
     "typescript": "^5.8.3"
   }
 }