AEM MCP Server

Instructions

Implementation Reference

• src/operations/utility-operations.ts:201-230 (handler)

  Core implementation of the fetchAvailableLocales tool logic. Queries the languageMasterPath .json endpoint with depth 2, parses child nodes (skipping jcr/sling prefixed), extracts locales with name, title, language, and wraps in success response.

  async fetchAvailableLocales(site: string, languageMasterPath: string): Promise<LocalesResponse> {
    return safeExecute<LocalesResponse>(async () => {
      const response = await this.httpClient.get(`${languageMasterPath}.json`, { 
        params: { ':depth': '2' } 
      });
      
      const locales: Array<{
        name: string;
        title: string;
        language: string;
      }> = [];
  
      Object.entries(response.data).forEach(([key, value]: [string, any]) => {
        if (key.startsWith('jcr:') || key.startsWith('sling:')) return;
        if (value && typeof value === 'object') {
          locales.push({
            name: key,
            title: value['jcr:content']?.['jcr:title'] || key,
            language: value['jcr:content']?.['jcr:language'] || key,
          });
        }
      });
  
      return createSuccessResponse({
        site,
        languageMasterPath,
        availableLocales: locales,
      }, 'fetchAvailableLocales') as LocalesResponse;
    }, 'fetchAvailableLocales');
  }

• src/mcp-server.ts:91-102 (registration)

  MCP tool registration entry defining name, description, and input schema (object with required string properties 'site' and 'languageMasterPath').

  {
    name: 'fetchAvailableLocales',
    description: 'Get available locales for a site and language master',
    inputSchema: {
      type: 'object',
      properties: {
        site: { type: 'string' },
        languageMasterPath: { type: 'string' },
      },
      required: ['site', 'languageMasterPath'],
    },
  },

• src/mcp-server.ts:625-629 (handler)

  MCP server request handler dispatch case for 'fetchAvailableLocales' that extracts params from args and invokes aemConnector.fetchAvailableLocales.

  case 'fetchAvailableLocales': {
    const { site, languageMasterPath } = args as { site: string; languageMasterPath: string };
    const result = await aemConnector.fetchAvailableLocales(site, languageMasterPath);
    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
  }

• src/interfaces/index.ts:573-583 (schema)

  TypeScript interface defining the output structure LocalesResponse for fetchAvailableLocales, extending BaseResponse with site, languageMasterPath, and array of locales (name, title, language).

  export interface LocalesResponse extends BaseResponse {
    data: {
      site: string;
      languageMasterPath: string;
      availableLocales: Array<{
        name: string;
        title: string;
        language: string;
      }>;
    };
  }

• src/aem-connector-new.ts:213-215 (helper)

  Delegation wrapper in AEMConnector class that forwards fetchAvailableLocales call to the underlying utilityOps instance.

  async fetchAvailableLocales(site: string, languageMasterPath: string) {
    return this.utilityOps.fetchAvailableLocales(site, languageMasterPath);
  }