@contentful/mcp-server 1.0.4 → 1.0.5

package/README.md

@@ -48,6 +48,10 @@ This MCP server provides a comprehensive set of tools for content management, al
 
 _Note: This requires [Cursor](https://cursor.com/) to be installed. If the link doesn't work, try the manual installation below._
 
+**Claude Desktop:**
+
+Download the .dxt configuration file [here](https://github.com/contentful/contentful-mcp-server/releases) from the latest release and import it into Claude Desktop to automatically configure the MCP server with your environment variables.
+
 #### Install from source
 
 ```bash

package/build/tools/entries/mockClient.js

@@ -0,0 +1,78 @@
+import { vi } from 'vitest';
+import { createToolClient } from '../../utils/tools.js';
+/**
+ * Shared mock objects for entry tests
+ * Provides standardized mock client and entry objects used across all entry tests
+ */
+// Create mock functions for the client
+export const mockEntryGet = vi.fn();
+export const mockEntryCreate = vi.fn();
+export const mockEntryUpdate = vi.fn();
+export const mockEntryDelete = vi.fn();
+export const mockEntryPublish = vi.fn();
+export const mockEntryUnpublish = vi.fn();
+export const mockEntryGetMany = vi.fn();
+export const mockBulkActionPublish = vi.fn();
+export const mockBulkActionUnpublish = vi.fn();
+/**
+ * Standard mock Contentful client with all entry operations
+ */
+export const mockClient = {
+    entry: {
+        get: mockEntryGet,
+        create: mockEntryCreate,
+        update: mockEntryUpdate,
+        delete: mockEntryDelete,
+        publish: mockEntryPublish,
+        unpublish: mockEntryUnpublish,
+        getMany: mockEntryGetMany,
+    },
+    bulkAction: {
+        publish: mockBulkActionPublish,
+        unpublish: mockBulkActionUnpublish,
+    },
+};
+/**
+ * Sets up the mock client for tests
+ * Call this in beforeEach to ensure the mock is properly configured
+ */
+export function setupMockClient() {
+    vi.mocked(createToolClient).mockReturnValue(mockClient);
+}
+/**
+ * Standard mock entry object used across tests
+ */
+export const mockEntry = {
+    sys: {
+        id: 'test-entry-id',
+        type: 'Entry',
+        contentType: {
+            sys: {
+                id: 'test-content-type',
+                type: 'Link',
+                linkType: 'ContentType',
+            },
+        },
+        version: 1,
+    },
+    fields: {
+        title: { 'en-US': 'Test Entry Title' },
+        description: { 'en-US': 'Test Entry Description' },
+    },
+};
+/**
+ * Standard test arguments for entry operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    entryId: 'test-entry-id',
+};
+/**
+ * Standard test arguments for bulk operations
+ */
+export const mockBulkArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    entryId: ['entry-1', 'entry-2'],
+};

package/build/tools/entries/publishEntry.js

@@ -17,27 +17,19 @@ async function tool(args) {
     const entryIds = Array.isArray(args.entryId) ? args.entryId : [args.entryId];
     // For single entry, use individual publish for simplicity
     if (entryIds.length === 1) {
-        try {
-            const entryId = entryIds[0];
-            const params = {
-                ...baseParams,
-                entryId,
-            };
-            // Get the entry first
-            const entry = await contentfulClient.entry.get(params);
-            // Publish the entry
-            const publishedEntry = await contentfulClient.entry.publish(params, entry);
-            return createSuccessResponse('Entry published successfully', {
-                status: publishedEntry.sys.status,
-                entryId,
-            });
-        }
-        catch (error) {
-            return createSuccessResponse('Entry publish failed', {
-                status: error,
-                entryId: entryIds[0],
-            });
-        }
+        const entryId = entryIds[0];
+        const params = {
+            ...baseParams,
+            entryId,
+        };
+        // Get the entry first
+        const entry = await contentfulClient.entry.get(params);
+        // Publish the entry
+        const publishedEntry = await contentfulClient.entry.publish(params, entry);
+        return createSuccessResponse('Entry published successfully', {
+            status: publishedEntry.sys.status,
+            entryId,
+        });
     }
     // For multiple entries, use bulk action API
     // Get the current version of each entry

package/build/tools/entries/unpublishEntry.js

@@ -15,29 +15,21 @@ async function tool(args) {
     const contentfulClient = createToolClient(args);
     // Normalize input to always be an array
     const entryIds = Array.isArray(args.entryId) ? args.entryId : [args.entryId];
-    // For single entry, use individual publish for simplicity
+    // For single entry, use individual unpublish for simplicity
     if (entryIds.length === 1) {
-        try {
-            const entryId = entryIds[0];
-            const params = {
-                ...baseParams,
-                entryId,
-            };
-            // Get the entry first
-            const entry = await contentfulClient.entry.get(params);
-            // Unpublish the entry
-            const unpublishedEntry = await contentfulClient.entry.unpublish(params, entry);
-            return createSuccessResponse('Entry unpublished successfully', {
-                status: unpublishedEntry.sys.status,
-                entryId,
-            });
-        }
-        catch (error) {
-            return createSuccessResponse('Entry unpublish failed', {
-                status: error,
-                entryId: entryIds[0],
-            });
-        }
+        const entryId = entryIds[0];
+        const params = {
+            ...baseParams,
+            entryId,
+        };
+        // Get the entry first
+        const entry = await contentfulClient.entry.get(params);
+        // Unpublish the entry
+        const unpublishedEntry = await contentfulClient.entry.unpublish(params, entry);
+        return createSuccessResponse('Entry unpublished successfully', {
+            status: unpublishedEntry.sys.status,
+            entryId,
+        });
     }
     // For multiple entries, use bulk action API
     // Get the unversioned links for each entry (unpublish doesn't need version info)

package/build/tools/locales/createLocale.js

@@ -6,7 +6,7 @@ export const CreateLocaleToolParams = BaseToolSchema.extend({
     code: z.string().describe('The locale code (e.g., "en-US")'),
     fallbackCode: z
         .string()
-        .optional()
+        .nullable()
         .describe('The locale code to fallback to when there is no content for the current locale'),
     contentDeliveryApi: z
         .boolean()

package/build/types/fieldSchema.js

@@ -5,8 +5,8 @@ export const FieldSchema = z.object({
     type: z
         .string()
         .describe('The field type (e.g., "Symbol", "Text", "Integer", "Boolean", "Date", "Location", "Link", "Array", "Object")'),
-    required: z.boolean().optional().describe('Whether the field is required'),
-    localized: z.boolean().optional().describe('Whether the field is localized'),
+    required: z.boolean().describe('Whether the field is required'),
+    localized: z.boolean().describe('Whether the field is localized'),
     disabled: z.boolean().optional().describe('Whether the field is disabled'),
     omitted: z
         .boolean()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-server",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "repository": {
     "type": "git",
     "url": "https://github.com/contentful/contentful-mcp-server"
@@ -43,6 +43,7 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@anthropic-ai/dxt": "^0.2.6",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@modelcontextprotocol/inspector": "0.16.2",