home / mcp / esa mcp server

ESA MCP Server

Provides MCP access to Alibaba Cloud ESA Edge Routine management, deployments, DNS, routes, and certificates.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aliyun-mcp-server-esa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-esa"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_SECURITY_TOKEN": "sts_security_token optional, required when using STS Token (By default, no need to pass)",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    }
  }
}

You can use this MCP server to call and manage Alibaba Cloud ESA Edge Routine services through the MCP protocol, enabling you to create, deploy, route, and monitor Edge Routines and their supporting resources from a unified client.

How to use

You connect your MCP-enabled client to the ESA MCP Server using the provided MCP server configuration. The server exposes a set of ESA tools that let you create, deploy, list, and manage Edge Routines, routes, deployments, DNS records, certificates, and more. Use the client’s standard MCP workflow to call the tools you need. All actions are exposed as MCP endpoints so you can automate routine operations, CI workflows, and site management tasks against your Alibaba Cloud ESA account.

Practical usage patterns include: creating a new Edge Routine, deploying code to staging or production, configuring routes for a site, managing DNS records, and applying SSL certificates. The server categorizes tools by area such as HTML deployment, Routines, Deployments, Routes, Records, Sites, and Certificate operations, each with concrete actions you can invoke from your MCP client.

How to install

Prerequisites: you need Node.js and npm installed on your machine or server.

Step 1: Install Node.js and npm if they are not already installed. On most systems you can install via your package manager or download from the Node.js website.

Step 2: Ensure you have npx available (it comes with npm).

Step 3: Create or update your MCP-enabled client configuration to include the ESA MCP Server. Use the following configuration snippet exactly as shown.

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": ["-y", "mcp-server-esa"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK",
        "ALIBABA_CLOUD_SECURITY_TOKEN": "sts_security_token optional, required when using STS Token (By default, no need to pass)"
      }
    }
  }
}

Additional notes

The ESA MCP Server supports a comprehensive set of tools for Edge Routine management, including HTML deployment, routine lifecycle operations, deployment versioning, route management, DNS records for sites, and certificate handling. You can reference these tools from your MCP client to orchestrate end-to-end ESA workflows across your Alibaba Cloud account.

Available tools

html_deploy

Quick deploy a HTML in a new Edge Routine (ER)

routine_create

Create a new Edge Routine (ER) in your Alibaba Cloud account

routine_delete

Delete an existing Edge Routine (ER) from your Alibaba Cloud account

routine_list

List all Edge Routines (ERs) in your Alibaba Cloud account

routine_get

Get details of a specific Edge Routine (ER)

routine_code_commit

Save a code version for future modifications or release within an Edge Routine (ER)

routine_code_deploy

Deploy a selected code version to staging or production

deployment_delete

Delete a specified code version associated with an Edge Routine (ER)

route_create

Create a new route associated with an Edge Routine (ER)

route_update

Modify the configuration of an existing Edge Routine route

route_delete

Delete a specified route associated with an Edge Routine (ER)

route_get

Get details of a specific route associated with an Edge Routine (ER)

routine_route_list

List all routes associated with a specific Edge Routine (ER)

site_route_list

List all routes associated with a specific site

er_record_create

Create a new record related to an Edge Routine (ER)

er_record_delete

Delete a specified record associated with an Edge Routine (ER)

er_record_list

List all records associated with a specific Edge Routine (ER)

site_active_list

List all active sites registered in your Alibaba Cloud account

site_match

Identify which site in the account matches the provided input criteria

site_record_list

List DNS records associated with a specific site

create_site_a_or_aaaa_record

Creates an A or AAAA DNS record for a specific website

create_site_cname_record

Creates a CNAME DNS record for a specific website

create_site_txt_record

Creates a TXT DNS record for a specific website

create_site_ns_record

Creates an NS DNS record for a specific website

create_site_mx_record

Creates an MX DNS record for a specific website

get_site_pause

Queries the ESA proxy configuration of a website

update_site_pause

Modifies the ESA proxy configuration of a website

create_site

Adds a website

update_record

This operation allows you to update multiple types of DNS records

get_record

Queries the configuration of a single DNS record

list_record

Queries a list of DNS records for a website

delete_record

Deletes a DNS record of a website by RecordId

update_ipv6

Modifies the IPv6 configuration of a website

get_ipv6

Queries the IPv6 configuration of a website

update_managed_transform

Modifies the configuration of managed transforms for your website

get_managed_transform

Query Managed Transform Configuration

list_sites

List all sites registered in your Alibaba Cloud account

set_certificate

Configures whether to enable certificates and update certificate information for a website

apply_certificate

Applies for a free SSL certificate

get_certificate

Retrieve the certificate, private key, and certificate information

delete_certificate

Deletes a certificate for a website

list_certificates

Lists certificates of a website

get_certificate_quota

Query certificate quota and usage