@contentful/mcp-server 1.0.5 → 1.2.0

package/build/config/env.js

@@ -4,7 +4,7 @@ dotenv.config();
 const EnvSchema = z.object({
     CONTENTFUL_MANAGEMENT_ACCESS_TOKEN: z
         .string()
-        .describe('Contentul CMA token'),
+        .describe('Contentful CMA token'),
     CONTENTFUL_HOST: z
         .string()
         .optional()
@@ -19,7 +19,7 @@ const EnvSchema = z.object({
         .describe('Contentful environment ID'),
 });
 export const env = EnvSchema.safeParse(process.env);
-if (!env.success) {
+if (!env.success && process.env.TEST_TYPE !== 'unit') {
     console.error('Invalid environment variables', env.error.format());
     process.exit(1);
 }

package/build/tools/ai-actions/mockClient.js

@@ -0,0 +1,228 @@
+import { vi } from 'vitest';
+import { createToolClient } from '../../utils/tools.js';
+import { VariableType, OutputFormat } from '../../utils/ai-actions.js';
+/**
+ * Shared mock objects for AI action tests
+ * Provides standardized mock client and AI action objects used across all AI action tests
+ */
+// Create mock functions for the client
+export const mockAiActionGet = vi.fn();
+export const mockAiActionCreate = vi.fn();
+export const mockAiActionUpdate = vi.fn();
+export const mockAiActionDelete = vi.fn();
+export const mockAiActionPublish = vi.fn();
+export const mockAiActionUnpublish = vi.fn();
+export const mockAiActionGetMany = vi.fn();
+export const mockAiActionInvoke = vi.fn();
+export const mockAiActionInvocationGet = vi.fn();
+/**
+ * Standard mock Contentful client with all AI action operations
+ */
+export const mockClient = {
+    aiAction: {
+        get: mockAiActionGet,
+        create: mockAiActionCreate,
+        update: mockAiActionUpdate,
+        delete: mockAiActionDelete,
+        publish: mockAiActionPublish,
+        unpublish: mockAiActionUnpublish,
+        getMany: mockAiActionGetMany,
+        invoke: mockAiActionInvoke,
+    },
+    aiActionInvocation: {
+        get: mockAiActionInvocationGet,
+    },
+};
+/**
+ * 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 AI action object used across tests
+ */
+export const mockAiAction = {
+    sys: {
+        id: 'test-ai-action-id',
+        type: 'AiAction',
+        version: 1,
+        space: {
+            sys: {
+                type: 'Link',
+                linkType: 'Space',
+                id: 'test-space-id',
+            },
+        },
+        environment: {
+            sys: {
+                type: 'Link',
+                linkType: 'Environment',
+                id: 'test-environment',
+            },
+        },
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+        publishedVersion: undefined,
+    },
+    name: 'Test AI Action',
+    description: 'A test AI action for unit tests',
+    instruction: {
+        template: 'Translate the following text from {{var.sourceLocale}} to {{var.targetLocale}}: {{var.sourceContent}}',
+        variables: [
+            {
+                id: 'sourceContent',
+                name: 'Source Content',
+                type: VariableType.TEXT,
+                description: 'The content to be translated',
+            },
+            {
+                id: 'sourceLocale',
+                name: 'Source Locale',
+                type: VariableType.LOCALE,
+                description: 'The source language locale',
+            },
+            {
+                id: 'targetLocale',
+                name: 'Target Locale',
+                type: VariableType.LOCALE,
+                description: 'The target language locale',
+            },
+        ],
+    },
+    configuration: {
+        modelType: 'gpt-4',
+        modelTemperature: 0.3,
+    },
+    testCases: [],
+};
+/**
+ * Mock AI action with published version
+ */
+export const mockPublishedAiAction = {
+    ...mockAiAction,
+    sys: {
+        ...mockAiAction.sys,
+        publishedVersion: 1,
+    },
+};
+/**
+ * Standard test arguments for AI action operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    aiActionId: 'test-ai-action-id',
+};
+/**
+ * Mock AI action invocation result
+ */
+export const mockAiActionInvocation = {
+    sys: {
+        id: 'test-invocation-id',
+        type: 'AiActionInvocation',
+        status: 'COMPLETED',
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+    },
+    result: {
+        content: 'Translated content result',
+    },
+};
+/**
+ * Mock AI action invocation status response
+ */
+export const mockInvocationStatusResponse = {
+    sys: {
+        id: 'test-invocation-id',
+        status: 'COMPLETED',
+    },
+    result: {
+        content: 'AI action completed successfully',
+    },
+};
+/**
+ * Mock AI actions list response
+ */
+export const mockAiActionsResponse = {
+    total: 2,
+    skip: 0,
+    limit: 3,
+    items: [
+        mockAiAction,
+        {
+            ...mockAiAction,
+            sys: { ...mockAiAction.sys, id: 'another-ai-action' },
+            name: 'Another AI Action',
+            description: 'Another test AI action',
+        },
+    ],
+};
+/**
+ * Mock variable values for AI action invocation
+ */
+export const mockVariables = [
+    {
+        id: 'sourceContent',
+        value: 'Hello, world!',
+    },
+    {
+        id: 'sourceLocale',
+        value: 'en-US',
+    },
+    {
+        id: 'targetLocale',
+        value: 'es-ES',
+    },
+];
+/**
+ * Mock fields for AI action invocation
+ */
+export const mockInvocationFields = [
+    {
+        outputFormat: OutputFormat.PLAIN_TEXT,
+        variables: mockVariables,
+    },
+];
+/**
+ * Mock complex AI action with all field types
+ */
+export const mockComplexAiAction = {
+    ...mockAiAction,
+    name: 'Complex AI Action',
+    description: 'An AI action with complex variable types',
+    instruction: {
+        template: 'Process content from {{var.entryRef}} with context {{var.smartContext}} for {{var.mediaRef}}',
+        variables: [
+            {
+                id: 'entryRef',
+                name: 'Entry Reference',
+                type: VariableType.REFERENCE,
+                description: 'Reference to a content entry',
+            },
+            {
+                id: 'smartContext',
+                name: 'Smart Context',
+                type: VariableType.SMART_CONTEXT,
+                description: 'AI-powered context understanding',
+            },
+            {
+                id: 'mediaRef',
+                name: 'Media Reference',
+                type: VariableType.MEDIA_REFERENCE,
+                description: 'Reference to media assets',
+            },
+        ],
+    },
+    configuration: {
+        modelType: 'gpt-3.5-turbo',
+        modelTemperature: 0.7,
+    },
+    testCases: [
+        {
+            name: 'Test case 1',
+            variables: {},
+        },
+    ],
+};

package/build/tools/assets/mockClient.js

@@ -0,0 +1,159 @@
+import { vi } from 'vitest';
+import { createToolClient } from '../../utils/tools.js';
+/**
+ * Shared mock objects for asset tests
+ * Provides standardized mock client and asset objects used across all asset tests
+ */
+// Create mock functions for the client
+export const mockAssetGet = vi.fn();
+export const mockAssetCreate = vi.fn();
+export const mockAssetUpdate = vi.fn();
+export const mockAssetDelete = vi.fn();
+export const mockAssetPublish = vi.fn();
+export const mockAssetUnpublish = vi.fn();
+export const mockAssetGetMany = vi.fn();
+export const mockAssetProcessForAllLocales = vi.fn();
+// Mock bulk operations
+export const mockBulkActionPublish = vi.fn();
+export const mockBulkActionUnpublish = vi.fn();
+export const mockBulkActionGet = vi.fn();
+/**
+ * Standard mock Contentful client with all asset operations
+ */
+export const mockClient = {
+    asset: {
+        get: mockAssetGet,
+        create: mockAssetCreate,
+        update: mockAssetUpdate,
+        delete: mockAssetDelete,
+        publish: mockAssetPublish,
+        unpublish: mockAssetUnpublish,
+        getMany: mockAssetGetMany,
+        processForAllLocales: mockAssetProcessForAllLocales,
+    },
+    bulkAction: {
+        publish: mockBulkActionPublish,
+        unpublish: mockBulkActionUnpublish,
+        get: mockBulkActionGet,
+    },
+};
+/**
+ * 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 asset object used across tests
+ */
+export const mockAsset = {
+    sys: {
+        id: 'test-asset-id',
+        type: 'Asset',
+        version: 1,
+        space: {
+            sys: {
+                type: 'Link',
+                linkType: 'Space',
+                id: 'test-space-id',
+            },
+        },
+        environment: {
+            sys: {
+                type: 'Link',
+                linkType: 'Environment',
+                id: 'test-environment',
+            },
+        },
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+        publishedVersion: 1,
+    },
+    fields: {
+        title: {
+            'en-US': 'Test Asset',
+        },
+        description: {
+            'en-US': 'A test asset for unit tests',
+        },
+        file: {
+            'en-US': {
+                fileName: 'test-image.jpg',
+                contentType: 'image/jpeg',
+                url: 'https://images.ctfassets.net/test/test-image.jpg',
+                details: {
+                    size: 12345,
+                    image: {
+                        width: 800,
+                        height: 600,
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Standard test arguments for asset operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    assetId: 'test-asset-id',
+};
+/**
+ * Mock file object for upload tests
+ */
+export const mockFile = {
+    fileName: 'test-image.jpg',
+    contentType: 'image/jpeg',
+    upload: 'https://upload.example.com/test-upload-url',
+};
+/**
+ * Mock assets list response
+ */
+export const mockAssetsResponse = {
+    total: 2,
+    skip: 0,
+    limit: 3,
+    items: [
+        mockAsset,
+        {
+            ...mockAsset,
+            sys: { ...mockAsset.sys, id: 'another-asset-id' },
+            fields: {
+                ...mockAsset.fields,
+                title: { 'en-US': 'Another Test Asset' },
+            },
+        },
+    ],
+};
+/**
+ * Mock bulk action response
+ */
+export const mockBulkAction = {
+    sys: {
+        id: 'bulk-action-id',
+        type: 'BulkAction',
+        status: 'succeeded',
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+    },
+    action: 'publish',
+    payload: {},
+};
+/**
+ * Mock processed asset for upload
+ */
+export const mockProcessedAsset = {
+    ...mockAsset,
+    fields: {
+        ...mockAsset.fields,
+        file: {
+            'en-US': {
+                ...mockAsset.fields.file['en-US'],
+                url: 'https://images.ctfassets.net/processed/test-image.jpg',
+            },
+        },
+    },
+};

package/build/tools/{types → content-types}/createContentType.js

@@ -9,6 +9,10 @@ export const CreateContentTypeToolParams = BaseToolSchema.extend({
         .string()
         .optional()
         .describe('Description of the content type'),
+    contentTypeId: z
+        .string()
+        .optional()
+        .describe('Optional ID for the content type. If provided, will use createWithId method'),
     fields: z
         .array(FieldSchema)
         .describe('Array of field definitions for the content type'),
@@ -19,13 +23,16 @@ async function tool(args) {
         environmentId: args.environmentId,
     };
     const contentfulClient = createToolClient(args);
-    // Create the content type
-    const contentType = await contentfulClient.contentType.create(params, {
+    const contentTypeData = {
         name: args.name,
         displayField: args.displayField,
         description: args.description,
         fields: args.fields,
-    });
+    };
+    // Create the content type with or without ID
+    const contentType = args.contentTypeId
+        ? await contentfulClient.contentType.createWithId({ ...params, contentTypeId: args.contentTypeId }, contentTypeData)
+        : await contentfulClient.contentType.create(params, contentTypeData);
     return createSuccessResponse('Content type created successfully', {
         contentType,
     });

package/build/tools/content-types/mockClient.js

@@ -0,0 +1,138 @@
+import { vi } from 'vitest';
+/**
+ * Shared mock objects for content type tests
+ * Provides standardized mock client and content type objects used across all content type tests
+ */
+const { mockContentTypeGet, mockContentTypeCreate, mockContentTypeCreateWithId, mockContentTypeUpdate, mockContentTypeDelete, mockContentTypePublish, mockContentTypeUnpublish, mockContentTypeGetMany, mockCreateToolClient, } = vi.hoisted(() => {
+    return {
+        mockContentTypeGet: vi.fn(),
+        mockContentTypeCreate: vi.fn(),
+        mockContentTypeCreateWithId: vi.fn(),
+        mockContentTypeUpdate: vi.fn(),
+        mockContentTypeDelete: vi.fn(),
+        mockContentTypePublish: vi.fn(),
+        mockContentTypeUnpublish: vi.fn(),
+        mockContentTypeGetMany: vi.fn(),
+        mockCreateToolClient: vi.fn(() => {
+            return {
+                contentType: {
+                    get: mockContentTypeGet,
+                    create: mockContentTypeCreate,
+                    createWithId: mockContentTypeCreateWithId,
+                    update: mockContentTypeUpdate,
+                    delete: mockContentTypeDelete,
+                    publish: mockContentTypePublish,
+                    unpublish: mockContentTypeUnpublish,
+                    getMany: mockContentTypeGetMany,
+                },
+            };
+        }),
+    };
+});
+vi.mock('../../utils/tools.js', async (importOriginal) => {
+    const org = await importOriginal();
+    return {
+        ...org,
+        createToolClient: mockCreateToolClient,
+    };
+});
+export { mockContentTypeGet, mockContentTypeCreate, mockContentTypeCreateWithId, mockContentTypeUpdate, mockContentTypeDelete, mockContentTypePublish, mockContentTypeUnpublish, mockContentTypeGetMany, mockCreateToolClient, };
+/**
+ * Standard mock content type object used across tests
+ */
+export const mockContentType = {
+    sys: {
+        id: 'test-content-type-id',
+        type: 'ContentType',
+        version: 1,
+        space: {
+            sys: {
+                type: 'Link',
+                linkType: 'Space',
+                id: 'test-space-id',
+            },
+        },
+        environment: {
+            sys: {
+                type: 'Link',
+                linkType: 'Environment',
+                id: 'test-environment',
+            },
+        },
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+    },
+    name: 'Test Content Type',
+    description: 'A test content type for unit tests',
+    displayField: 'title',
+    fields: [
+        {
+            id: 'title',
+            name: 'Title',
+            type: 'Symbol',
+            required: true,
+            localized: false,
+            validations: [],
+        },
+        {
+            id: 'description',
+            name: 'Description',
+            type: 'Text',
+            required: false,
+            localized: false,
+            validations: [],
+        },
+    ],
+};
+/**
+ * Standard test arguments for content type operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    contentTypeId: 'test-content-type-id',
+};
+/**
+ * Mock field definitions for testing
+ */
+export const mockField = {
+    id: 'title',
+    name: 'Title',
+    type: 'Symbol',
+    required: true,
+    localized: false,
+    validations: [],
+};
+export const mockTextField = {
+    id: 'description',
+    name: 'Description',
+    type: 'Text',
+    required: false,
+    localized: false,
+    validations: [],
+};
+export const mockLinkField = {
+    id: 'relatedEntry',
+    name: 'Related Entry',
+    type: 'Link',
+    linkType: 'Entry',
+    required: false,
+    localized: false,
+    validations: [],
+};
+/**
+ * Mock content types list response
+ */
+export const mockContentTypesResponse = {
+    total: 2,
+    skip: 0,
+    limit: 10,
+    items: [
+        mockContentType,
+        {
+            ...mockContentType,
+            sys: { ...mockContentType.sys, id: 'another-content-type' },
+            name: 'Another Content Type',
+        },
+    ],
+};

package/build/tools/locales/mockClient.js

@@ -0,0 +1,54 @@
+import { vi } from 'vitest';
+const { mockLocaleCreate, mockLocaleGet, mockLocaleDelete, mockLocaleGetMany, mockLocaleUpdate, mockCreateToolClient, } = vi.hoisted(() => {
+    return {
+        mockLocaleCreate: vi.fn(),
+        mockLocaleGet: vi.fn(),
+        mockLocaleDelete: vi.fn(),
+        mockLocaleGetMany: vi.fn(),
+        mockLocaleUpdate: vi.fn(),
+        mockCreateToolClient: vi.fn(() => {
+            return {
+                locale: {
+                    create: mockLocaleCreate,
+                    get: mockLocaleGet,
+                    delete: mockLocaleDelete,
+                    getMany: mockLocaleGetMany,
+                    update: mockLocaleUpdate,
+                },
+            };
+        }),
+    };
+});
+vi.mock('../../utils/tools.js', async (importOriginal) => {
+    const org = await importOriginal();
+    return {
+        ...org,
+        createToolClient: mockCreateToolClient,
+    };
+});
+export { mockLocaleCreate, mockLocaleGet, mockLocaleDelete, mockLocaleGetMany, mockLocaleUpdate, mockCreateToolClient, };
+export const testLocale = {
+    name: 'Test Locale',
+    code: 'en-US',
+    fallbackCode: null,
+    contentDeliveryApi: true,
+    contentManagementApi: true,
+    default: true,
+    optional: false,
+    sys: {
+        id: 'test-locale-id',
+        type: 'Locale',
+        space: { sys: { type: 'Link', linkType: 'Space', id: 'test-space-id' } },
+        environment: {
+            sys: { type: 'Link', linkType: 'Environment', id: 'test-environment-id' },
+        },
+        createdAt: '2025-08-25T10:00:00Z',
+        updatedAt: '2025-08-25T10:00:00Z',
+        version: 1,
+    },
+};
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment-id',
+    cmaToken: 'test-cma-token',
+};

package/build/tools/register.js

@@ -1,6 +1,6 @@
 import { registerContextTools } from './context/register.js';
 import { registerEntriesTools } from './entries/register.js';
-import { registerContentTypesTools } from './types/register.js';
+import { registerContentTypesTools } from './content-types/register.js';
 import { registerEnvironmentTools } from './environments/register.js';
 import { registerAssetTools } from './assets/register.js';
 import { registerSpaceTools } from './spaces/register.js';

package/build/types/fieldSchema.js

@@ -14,6 +14,7 @@ export const FieldSchema = z.object({
         .describe('Whether the field is omitted from the API response'),
     validations: z.array(z.any()).optional().describe('Field validations'),
     settings: z.record(z.any()).optional().describe('Field-specific settings'),
+    defaultValue: z.any().optional().describe('Default value for the field'),
     linkType: z
         .string()
         .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-server",
-  "version": "1.0.5",
+  "version": "1.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/contentful/contentful-mcp-server"
@@ -18,7 +18,8 @@
     "npm": ">=10.0.0"
   },
   "scripts": {
-    "build": "tsc",
+    "clean": "rimraf build",
+    "build": "npm run clean && tsc",
     "dev": "nodemon --ext ts --ignore build/ --watch src/ --exec 'npm run build && npm start'",
     "format": "prettier --write .",
     "lint": "eslint .",
@@ -58,6 +59,7 @@
     "nx": "^21.3.5",
     "prettier": "^3.6.2",
     "pretty-quick": "^4.2.2",
+    "rimraf": "^6.0.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4"