ESA MCP Server

Instructions

Implementation Reference

• src/tools/site/site.ts:278-287 (handler)

  The handler function that implements the core logic of the 'get_site_pause' tool by invoking the API service with the provided arguments and returning a formatted response.

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

• src/tools/site/site.ts:192-213 (registration)

  Tool registration exporting the Tool object with name 'get_site_pause', description, and input schema definition.

  export const GET_SITE_PAUSE_TOOL: Tool = {
    name: 'get_site_pause',
    description: 'Queries 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****'],
        },
      },
      required: ['siteId'],
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false,
      },
    },
  };

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

  Central registration of all tool handlers, including 'get_site_pause'.

  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)

  Registration of site-related tools list including GET_SITE_PAUSE_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,
  ];

• src/utils/service.ts:411-420 (helper)

  Helper method in the API service client that performs the actual Alibaba Cloud ESA API call for getting site pause status.

  getSitePause(params: GetSitePauseRequest) {
    const request = new GetSitePauseRequest(params);
    return this.callApi(
      this.client.getSitePause.bind(this.client) as ApiMethod<
        GetSitePauseRequest,
        GetSitePauseResponse
      >,
      request,
    );
  }