@contentful/mcp-server 1.0.0

package/build/utils/response.js

@@ -0,0 +1,37 @@
+import { formatResponse } from './formatters.js';
+/**
+ * Creates a standardized success response
+ */
+export function createSuccessResponse(message, data) {
+    const text = data ? formatResponse(message, data) : message;
+    return {
+        content: [
+            {
+                type: 'text',
+                text,
+            },
+        ],
+    };
+}
+/**
+ * Higher-order function that wraps tool handlers with standardized error handling
+ */
+export function withErrorHandling(handler, errorPrefix = 'Error') {
+    return async (params, extra) => {
+        try {
+            return await handler(params, extra);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `${errorPrefix}: ${errorMessage}`,
+                    },
+                ],
+            };
+        }
+    };
+}

package/build/utils/summarizer.js

@@ -0,0 +1,39 @@
+export const summarizeData = (data, options = {}) => {
+    const { maxItems = 3, remainingMessage = 'To see more items, please ask me to retrieve the next page.', } = options;
+    // Handle Contentful-style responses with items and total
+    if (data && typeof data === 'object' && 'items' in data && 'total' in data) {
+        const items = data.items;
+        const total = data.total;
+        // Type guard to ensure items is an array and total is a number
+        if (!Array.isArray(items) || typeof total !== 'number') {
+            return data;
+        }
+        if (items.length <= maxItems) {
+            return data;
+        }
+        return {
+            items: items.slice(0, maxItems),
+            total: total,
+            showing: maxItems,
+            remaining: total - maxItems,
+            message: remainingMessage,
+            skip: maxItems, // Add skip value for next page
+        };
+    }
+    // Handle plain arrays
+    if (Array.isArray(data)) {
+        if (data.length <= maxItems) {
+            return data;
+        }
+        return {
+            items: data.slice(0, maxItems),
+            total: data.length,
+            showing: maxItems,
+            remaining: data.length - maxItems,
+            message: remainingMessage,
+            skip: maxItems, // Add skip value for next page
+        };
+    }
+    // Return non-array data as-is (cast to expected return type)
+    return data;
+};

package/build/utils/tools.js

@@ -0,0 +1,20 @@
+import ctfl from 'contentful-management';
+import { getDefaultClientConfig } from '../config/contentful.js';
+import { z } from 'zod';
+export const BaseToolSchema = z.object({
+    spaceId: z.string().describe('The ID of the Contentful space'),
+    environmentId: z.string().describe('The ID of the Contentful environment'),
+});
+/**
+ * Creates a Contentful client with the correct configuration based on resource parameters
+ *
+ * @param params - Tool parameters that may include a resource
+ * @returns Configured Contentful client
+ */
+export function createToolClient(params) {
+    const clientConfig = getDefaultClientConfig();
+    if (params.spaceId) {
+        clientConfig.space = params.spaceId;
+    }
+    return ctfl.createClient(clientConfig, { type: 'plain' });
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@contentful/mcp-server",
+  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/contentful/contentful-mcp-server"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "contentful-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "engines": {
+    "node": ">=22.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "nodemon --ext ts --ignore build/ --watch src/ --exec 'npm run build && npm start'",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "start": "node build/index.js",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "inspect": "node -r dotenv/config ./scripts/inspect.js",
+    "inspect:watch": "node ./scripts/inspect-watch.js",
+    "logs:watch": "npx mcps-logger",
+    "update-licenses": "node scripts/update-licenses.js",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.16.0",
+    "contentful-management": "^11.52.2",
+    "dotenv": "^16.4.7",
+    "fast-xml-parser": "^5.2.0",
+    "get-it": "^8.6.10",
+    "gpt-tokenizer": "^2.9.0",
+    "outdent": "^0.8.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@modelcontextprotocol/inspector": "0.15.0",
+    "@nx/js": "^21.3.2",
+    "@types/node": "^22.13.11",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "husky": "^9.1.7",
+    "mcps-logger": "^1.0.0",
+    "nodemon": "^3.1.0",
+    "nx": "^21.2.3",
+    "prettier": "^3.6.2",
+    "pretty-quick": "^4.2.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.1"
+  }
+}