ESA MCP Server

Instructions

Implementation Reference

• src/tools/site/certificate.ts:193-202 (handler)

  The handler function that implements the core logic of the 'set_certificate' tool by calling the underlying API service.

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

• src/tools/site/certificate.ts:13-61 (schema)

  The Tool schema definition including name, description, and inputSchema for 'set_certificate'.

  export const SET_CERTIFICATE_TOOL: Tool = {
    name: 'set_certificate',
    description:
      'Configures whether to enable certificates and update certificate information for a website.',
    inputSchema: {
      type: 'object',
      properties: {
        siteId: {
          type: 'number',
          description: 'The website ID. Reference Value Source: list_sites',
          examples: ['123456****'],
        },
        name: {
          type: 'string',
          description: 'The name of the certificate.',
        },
        casId: {
          type: 'number',
          description: 'The ID of the cloud certificate.',
        },
        type: {
          type: 'string',
          description:
            'The type of certificate. Possible values: - cas (Cloud Certificate) - upload (Custom Upload Certificate)',
          enum: ['cas', 'upload'],
        },
        certificate: {
          type: 'string',
          description: 'The content of the certificate.',
        },
        privateKey: {
          type: 'string',
          description: 'The private key of the certificate.',
        },
        region: {
          type: 'string',
          description: 'The region.',
          example: 'cn-hangzhou',
        },
        id: {
          type: 'string',
          description: 'The ID of the certificate.',
          example: '30001303',
        },
      },
      required: ['siteId', 'type'],
      annotations: {},
    },
  };

• src/tools/list-esa-function.ts:143-150 (registration)

  Registration of the SET_CERTIFICATE_TOOL schema in the CERTIFICATE_LIST array, which is later included in the full ESA_OPENAPI_LIST.

  export const CERTIFICATE_LIST = [
    SET_CERTIFICATE_TOOL,
    APPLY_CERTIFICATE_TOOL,
    GET_CERTIFICATE_TOOL,
    DELETE_CERTIFICATE_TOOL,
    LIST_CERTIFICATES_TOOL,
    GET_CERTIFICATE_QUOTA_TOOL,
  ];

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

  Maps the 'set_certificate' handler function to the esaHandlers object for tool dispatching.

  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:498-507 (helper)

  The underlying API service method called by the tool handler to perform the setCertificate operation.

  setCertificate(params: SetCertificateRequest) {
    const request = new SetCertificateRequest(params);
    return this.callApi(
      this.client.setCertificate.bind(this.client) as ApiMethod<
        SetCertificateRequest,
        SetCertificateResponse
      >,
      request,
    );
  }