@kontent-ai/mcp-server 0.1.0 → 0.3.0

package/README.md

@@ -18,12 +18,11 @@ This server provides a Model Context Protocol (MCP) interface for interacting wi
 
 ### Environment Variables
 
-Create a `.env` file with the following variables:
+The following environment variables are needed:
 
 ```
 KONTENT_ENVIRONMENT_ID=your_environment_id
 KONTENT_API_KEY=your_api_key
-PORT=3001  # Optional, defaults to 3001
 ```
 
 ### Using with npx
@@ -38,6 +37,20 @@ npx @kontent-ai/mcp-server sse
 npx @kontent-ai/mcp-server stdio
 ```
 
+### Example mcp.json usage
+
+```json
+{
+  "kontent-ai-stdio": {
+      "command": "npx @kontent-ai/mcp stdio",
+      "env": {
+        "KONTENT_API_KEY": "<management-api-key>",
+        "KONTENT_ENVIRONMENT_ID": "<environment-id>"
+      }
+    },
+}
+```
+
 ### Local Installation
 
 ```bash
@@ -71,8 +84,7 @@ npm run start:stdio  # For STDIO transport
   - `clients/` - Kontent.ai API client setup
   - `schemas/` - Data validation schemas
   - `server.ts` - Main server setup and tool registration
-  - `sseTransport.ts` - SSE transport implementation
-  - `stdioTransport.ts` - STDIO transport implementation
+  - `bin.ts` - Single entry point that handles both transport types
 
 ## License
 

package/build/bin.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import express from "express";
+import { createServer } from "./server.js";
+async function startSSE() {
+    const app = express();
+    const { server } = createServer();
+    let transport;
+    app.get("/sse", async (req, res) => {
+        transport = new SSEServerTransport("/message", res);
+        await server.connect(transport);
+    });
+    app.post("/message", async (req, res) => {
+        await transport.handlePostMessage(req, res);
+    });
+    const PORT = process.env.PORT || 3001;
+    app.listen(PORT, () => {
+        console.log(`Kontent.ai MCP Server (SSE) running on port ${PORT}`);
+    });
+}
+async function startStdio() {
+    const { server } = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const transportType = args[0]?.toLowerCase();
+    if (!transportType || (transportType !== 'stdio' && transportType !== 'sse')) {
+        console.error('Please specify a valid transport type: stdio or sse');
+        process.exit(1);
+    }
+    if (transportType === 'stdio') {
+        await startStdio();
+    }
+    else if (transportType === 'sse') {
+        await startSSE();
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/build/schemas/taxonomySchemas.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+// Schema for a taxonomy term
+const taxonomyTermSchema = z.object({
+    name: z.string(),
+    codename: z.string().optional(),
+    external_id: z.string().optional(),
+    terms: z.lazy(() => z.array(taxonomyTermSchema)),
+});
+// Schema for a taxonomy group
+export const taxonomyGroupSchemas = {
+    name: z.string().describe("Display name of the taxonomy group"),
+    codename: z.string().optional().describe("Codename of the taxonomy group (optional, will be generated if not provided)"),
+    external_id: z.string().optional().describe("External ID of the taxonomy group (optional)"),
+    terms: z.array(taxonomyTermSchema).describe("Hierarchical structure of taxonomy terms"),
+};

package/build/server.js

@@ -9,6 +9,11 @@ import { registerTool as registerGetAssetMapi } from "./tools/get-asset-mapi.js"
 import { registerTool as registerListAssetsMapi } from "./tools/list-assets-mapi.js";
 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 registerGetTypeSnippetMapi } from "./tools/get-type-snippet-mapi.js";
+import { registerTool as registerListContentTypeSnippetsMapi } from "./tools/list-content-type-snippets-mapi.js";
+import { registerTool as registerAddTaxonomyGroupMapi } from "./tools/add-taxonomy-group-mapi.js";
+import { registerTool as registerListTaxonomyGroupsMapi } from "./tools/list-taxonomy-groups-mapi.js";
+import { registerTool as registerGetTaxonomyGroupMapi } from "./tools/get-taxonomy-group-mapi.js";
 // Create server instance
 export const createServer = () => {
     const server = new McpServer({
@@ -30,5 +35,10 @@ export const createServer = () => {
     registerListAssetsMapi(server);
     registerAddContentTypeMapi(server);
     registerAddContentTypeSnippetMapi(server);
+    registerGetTypeSnippetMapi(server);
+    registerListContentTypeSnippetsMapi(server);
+    registerAddTaxonomyGroupMapi(server);
+    registerListTaxonomyGroupsMapi(server);
+    registerGetTaxonomyGroupMapi(server);
     return { server };
 };

package/build/tools/add-taxonomy-group-mapi.js

@@ -0,0 +1,19 @@
+import { createMapiClient } from '../clients/kontentClients.js';
+import { taxonomyGroupSchemas } from '../schemas/taxonomySchemas.js';
+export const registerTool = (server) => {
+    server.tool("add-taxonomy-group-mapi", "Add a new taxonomy group via Management API", taxonomyGroupSchemas, async (taxonomyGroup) => {
+        const client = createMapiClient();
+        const response = await client
+            .addTaxonomy()
+            .withData(taxonomyGroup)
+            .toPromise();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data),
+                },
+            ],
+        };
+    });
+};

package/build/tools/get-taxonomy-group-mapi.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { createMapiClient } from '../clients/kontentClients.js';
+export const registerTool = (server) => {
+    server.tool("get-taxonomy-group-mapi", "Get taxonomy group by codename from Management API", {
+        codename: z.string().describe("Codename of the taxonomy group to get")
+    }, async ({ codename }) => {
+        const client = createMapiClient();
+        const response = await client
+            .getTaxonomy()
+            .byTaxonomyCodename(codename)
+            .toPromise();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data),
+                },
+            ],
+        };
+    });
+};

package/build/tools/get-type-snippet-mapi.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { createMapiClient } from '../clients/kontentClients.js';
+export const registerTool = (server) => {
+    server.tool("get-type-snippet-mapi", "Get content type snippet by codename from Management API", {
+        codename: z.string().describe("Codename of the content type snippet to get")
+    }, async ({ codename }) => {
+        const client = createMapiClient();
+        const response = await client
+            .viewContentTypeSnippet()
+            .byTypeCodename(codename)
+            .toPromise();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data),
+                },
+            ],
+        };
+    });
+};

package/build/tools/list-content-type-snippets-mapi.js

@@ -0,0 +1,17 @@
+import { createMapiClient } from '../clients/kontentClients.js';
+export const registerTool = (server) => {
+    server.tool("list-content-type-snippets-mapi", "Get all content type snippets from Management API", {}, async () => {
+        const client = createMapiClient();
+        const response = await client
+            .listContentTypeSnippets()
+            .toAllPromise();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data),
+                },
+            ],
+        };
+    });
+};

package/build/tools/list-taxonomy-groups-mapi.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { createMapiClient } from '../clients/kontentClients.js';
+export const registerTool = (server) => {
+    server.tool("list-taxonomy-groups-mapi", "Get all taxonomy groups from Management API", {
+        random_string: z.string().describe("Dummy parameter for no-parameter tools")
+    }, async () => {
+        const client = createMapiClient();
+        const response = await client
+            .listTaxonomies()
+            .toPromise();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data),
+                },
+            ],
+        };
+    });
+};

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@kontent-ai/mcp-server",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "scripts": {
     "build": "tsc",
-    "start:stdio": "node build/stdioTransport.js",
-    "start:sse": "node build/sseTransport.js"
+    "start:stdio": "node build/bin.js stdio",
+    "start:sse": "node build/bin.js sse"
   },
   "bin": {
-    "stdio": "./build/stdioTransport.js",
-    "sse": "./build/sseTransport.js"
+    "@kontent-ai/mcp-server": "./build/bin.js"
   },
   "files": [
     "build"

package/build/sseTransport.js

@@ -1,23 +0,0 @@
-import 'dotenv/config';
-import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
-import express from "express";
-import { createServer } from "./server.js";
-const app = express();
-const { server } = createServer();
-let transport;
-app.get("/sse", async (req, res) => {
-    transport = new SSEServerTransport("/message", res);
-    await server.connect(transport);
-    /*server.onclose = async () => {
-      //await cleanup();
-      await server.close();
-      process.exit(0);
-    };*/
-});
-app.post("/message", async (req, res) => {
-    await transport.handlePostMessage(req, res);
-});
-const PORT = process.env.PORT || 3001;
-app.listen(PORT, () => {
-    console.log(`Kontent.ai MCP Server (SSE) running on port ${PORT}`);
-});

package/build/stdioTransport.js

@@ -1,13 +0,0 @@
-import 'dotenv/config';
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createServer } from "./server.js";
-// Create server instance
-const { server } = createServer();
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-main().catch((error) => {
-    console.error("Fatal error in main():", error);
-    process.exit(1);
-});