ESA MCP Server

Instructions

Implementation Reference

• src/tools/site/site.ts:267-276 (handler)

  The main handler function for the 'update_site_pause' tool. It takes a CallToolRequest, extracts arguments as UpdateSitePauseRequest, calls api.updateSitePause, and returns a JSON stringified response.

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

• src/tools/site/site.ts:163-190 (schema)

  The Tool object definition for 'update_site_pause', including name, description, and detailed inputSchema with properties siteId (number) and paused (boolean).

  export const UPDATE_SITE_PAUSE_TOOL: Tool = {
    name: 'update_site_pause',
    description: 'Modifies the ESA proxy configuration of a website.',
    inputSchema: {
      type: 'object',
      properties: {
        siteId: {
          type: 'number',
          description:
            'The website ID, which can be obtained by calling the [ListSites] operation.',
          examples: ['123456****'],
        },
        paused: {
          type: 'boolean',
          description:
            'Specifies whether to temporarily pause ESA on the website. If you set this parameter to true, all requests to the domains in your DNS records go directly to your origin server. Valid values: true, false',
          examples: ['true'],
        },
      },
      required: ['siteId', 'paused'],
      annotations: {
        readOnlyHint: false,
        destructiveHint: true,
        idempotentHint: true,
        openWorldHint: false,
      },
    },
  };

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

  The esaHandlers object registers the update_site_pause handler function (line 186) along with other tools, likely used for MCP tool registration.

  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/tools/list-esa-function.ts:125-139 (registration)

  ESA_OPENAPI_SITE_LIST array includes UPDATE_SITE_PAUSE_TOOL (line 128), collecting Tool definitions for site-related OpenAPI tools.

  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,
  ];

• src/utils/service.ts:399-409 (helper)

  The api.updateSitePause helper method that wraps the Alibaba Cloud ESA client call to update site pause status.

  updateSitePause(params: UpdateSitePauseRequest) {
    params.pause = params.pause || false;
    const request = new UpdateSitePauseRequest(params);
    return this.callApi(
      this.client.updateSitePause.bind(this.client) as ApiMethod<
        UpdateSitePauseRequest,
        UpdateSitePauseResponse
      >,
      request,
    );
  }