ESA MCP Server

Instructions

Implementation Reference

• src/tools/site/managedTransform.ts:81-90 (handler)

  The primary handler function for the MCP tool 'update_managed_transform'. It receives the tool call request, invokes the API service, and returns the response as tool output.

  export const update_managed_transform = async (request: CallToolRequest) => {
    const res = await api.updateManagedTransform(
      request.params.arguments as UpdateManagedTransformRequest,
    );
  
    return {
      content: [{ type: 'text', text: JSON.stringify(res) }],
      success: true,
    };
  };

• src/tools/site/managedTransform.ts:8-52 (schema)

  The tool metadata and input schema definition for 'update_managed_transform', including properties, required fields, and annotations.

  export const UPDATE_MANAGED_TRANSFORM_TOOL: Tool = {
    name: 'update_managed_transform',
    description:
      'Modifies the configuration of managed transforms for your website.',
    inputSchema: {
      type: 'object',
      properties: {
        siteId: {
          type: 'number',
          description:
            'The website ID, which can be obtained by calling the ListSites operation.',
          example: [12228828888],
        },
        addClientGeolocationHeader: {
          type: 'string',
          description:
            'Specifies whether to include the header that indicates the geographical location of a client in an origin request.',
          enum: ['on', 'off'],
        },
        siteVersion: {
          type: 'number',
          description:
            'The version number of the website. You can use this parameter to specify a version of your website to apply the feature settings. By default, version 0 is used.',
          example: [0],
        },
        addRealClientIpHeader: {
          type: 'string',
          description:
            "Specifies whether to include the 'ali-real-client-ip' header that indicates the 's real IP address in an origin request.",
          enum: ['on', 'off'],
        },
        realClientIpHeaderName: {
          type: 'string',
          description: 'The actual client IP header name.',
          example: ['test_header'],
        },
      },
      required: ['siteId'],
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
      },
    },
  };

• src/tools/list-esa-function.ts:152-155 (registration)

  Registration of the 'update_managed_transform' tool (via UPDATE_MANAGED_TRANSFORM_TOOL) in the MANAGED_TRANSFORM_LIST array, which is later included in the full ESA_OPENAPI_LIST.

  export const MANAGED_TRANSFORM_LIST = [
    UPDATE_MANAGED_TRANSFORM_TOOL,
    GET_MANAGED_TRANSFORM_TOOL,
  ];

• src/tools/list-esa-function.ts:164-208 (registration)

  Registration of the handler function 'update_managed_transform' in the esaHandlers map, mapping tool names to their handler implementations.

  export const esaHandlers: ToolHandlers = {
    site_active_list,
    site_match,
    site_route_list,
    site_record_list,
    routine_create,
    routine_code_commit,
    routine_delete,
    routine_list,
    routine_get,
    routine_code_deploy,
    routine_route_list,
    deployment_delete,
    route_create,
    route_delete,
    route_update,
    route_get,
    er_record_create,
    er_record_delete,
    er_record_list,
    html_deploy,
    create_site,
    update_site_pause,
    get_site_pause,
    create_site_mx_record,
    create_site_ns_record,
    create_site_txt_record,
    create_site_cname_record,
    create_site_a_or_aaaa_record,
    update_record,
    list_records,
    get_record,
    delete_record,
    update_ipv6,
    get_ipv6,
    update_managed_transform,
    get_managed_transform,
    set_certificate,
    apply_certificate,
    get_certificate,
    delete_certificate,
    list_certificates,
    get_certificate_quota,
    list_sites,
  };

• src/utils/service.ts:477-486 (helper)

  Supporting API wrapper method in the service client that wraps the Alibaba Cloud ESA updateManagedTransform API call, used by the tool handler.

  updateManagedTransform(params: UpdateManagedTransformRequest) {
    const request = new UpdateManagedTransformRequest(params);
    return this.callApi(
      this.client.updateManagedTransform.bind(this.client) as ApiMethod<
        UpdateManagedTransformRequest,
        UpdateManagedTransformResponse
      >,
      request,
    );
  }