ESA MCP Server

Instructions

Implementation Reference

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

  The MCP tool handler function for 'update_managed_transform'. It extracts arguments from the request, calls the underlying API via api.updateManagedTransform, stringifies the response, and returns it in the expected MCP format.
  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 definition including name, description, and detailed inputSchema for validation. This is used for registration.
  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:78-208 (registration)

  Imports the tool handler and TOOL object, adds to MANAGED_TRANSFORM_LIST which is aggregated into the main ESA_OPENAPI_LIST, and maps the handler in esaHandlers for tool dispatch.
  import { get_managed_transform, GET_MANAGED_TRANSFORM_TOOL, update_managed_transform, UPDATE_MANAGED_TRANSFORM_TOOL, } from './site/managedTransform'; import { ToolHandlers } from '../utils/types'; import { routine_code_deploy, ROUTINE_CODE_DEPLOY_TOOL } from './er/deploy'; import { deployment_delete, DEPLOYMENT_DELETE_TOOL } from './er/deployments'; import { routine_code_commit, ROUTINE_CODE_COMMIT_TOOL } from './er/commit'; import { apply_certificate, APPLY_CERTIFICATE_TOOL, delete_certificate, DELETE_CERTIFICATE_TOOL, get_certificate, get_certificate_quota, GET_CERTIFICATE_QUOTA_TOOL, GET_CERTIFICATE_TOOL, list_certificates, LIST_CERTIFICATES_TOOL, set_certificate, SET_CERTIFICATE_TOOL, } from './site/certificate'; export const ESA_OPENAPI_ER_LIST = [ HTML_DEPLOY_TOOL, ROUTINE_CREATE_TOOL, ROUTINE_DELETE_TOOL, ROUTINE_LIST_TOOL, ROUTINE_GET_TOOL, ROUTINE_CODE_COMMIT_TOOL, ROUTINE_CODE_DEPLOY_TOOL, ROUTINE_ROUTE_LIST_TOOL, DEPLOYMENT_DELETE_TOOL, SITE_ACTIVE_LIST_TOOL, SITE_ROUTE_LIST_TOOL, ROUTE_CREATE_TOOL, ROUTE_DELETE_TOOL, ROUTE_UPDATE_TOOL, ROUTE_GET_TOOL, SITE_MATCH_TOOL, ER_RECORD_CREATE_TOOL, ER_RECORD_DELETE_TOOL, ER_RECORD_LIST_TOOL, ]; export const ESA_OPENAPI_SITE_LIST = [ LIST_SITES_TOOL, CREATE_SITE_TOOL, UPDATE_SITE_PAUSE_TOOL, GET_SITE_PAUSE_TOOL, UPDATE_RECORD_TOOL, CREATE_SITE_MX_RECORD_TOOL, CREATE_SITE_NS_RECORD_TOOL, CREATE_SITE_TXT_RECORD_TOOL, CREATE_SITE_CNAME_RECORD_TOOL, CREATE_SITE_A_OR_AAAA_RECORD_TOOL, DELETE_RECORD_TOOL, LIST_RECORDS_TOOL, GET_RECORD_TOOL, ]; export const IPV6_LIST = [UPDATE_IPV6_TOOL, GET_IPV6_TOOL]; export const CERTIFICATE_LIST = [ SET_CERTIFICATE_TOOL, APPLY_CERTIFICATE_TOOL, GET_CERTIFICATE_TOOL, DELETE_CERTIFICATE_TOOL, LIST_CERTIFICATES_TOOL, GET_CERTIFICATE_QUOTA_TOOL, ]; export const MANAGED_TRANSFORM_LIST = [ UPDATE_MANAGED_TRANSFORM_TOOL, GET_MANAGED_TRANSFORM_TOOL, ]; export const ESA_OPENAPI_LIST = [ ...ESA_OPENAPI_ER_LIST, ...ESA_OPENAPI_SITE_LIST, ...IPV6_LIST, ...CERTIFICATE_LIST, ...MANAGED_TRANSFORM_LIST, ]; 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)

  The underlying API wrapper method in the service client that performs the actual Alibaba Cloud ESA API call for updating managed transforms, 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, ); }