mcp-server-esa

ESA MCP Server

An MCP server to conveniently use various Alibaba Cloud ESA services.

---

English | 中文

Installation

1. Apply for Alibaba Cloud's AK and SK on the Accesskey page

https://ram.console.aliyun.com/profile/access-keys

2. Enable Edge Routine service

https://esa.console.aliyun.com/edge/function/list

3. Configure in your MCP-enabled client config:

{
  "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)"
      }
    }
  }
}

Demo Videos

Claude Demo

Cline Demo

Cline configured successfully:

Claude configured successfully:

Tools List

The server provides the following ESA tools callable via the MCP protocol:

Category	Tool	Description
HTML	html_deploy	Quick deploy a HTML in a new Edge Routine (ER)
Routines	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 a the details of a Edge Routine (ER).
Deployments	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 the staging or production environment.
	deployment_delete	Delete a specified code version associated with an Edge Routine (ER).
Routes	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.
Records	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).
Sites	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 Domain Name System (DNS) records of a website.
	delete_record	Deletes a DNS record of a website based on the specified 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.
Certificate	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.

Prompt Examples

• Write a 2048 game and deploy it on Edge Routine, and display the default access URL provided by the Edge Routine.
• Delete Edge routines created after May 2025.
• List all Edge routines are under my account.
• What is the default access address for my Edge Routine named "hello-world"?
• Create a CNAME record for test.example.com with the value set to example2.com
• Create a A record for test.example.com with the value set to 1.1.1.1

License

MIT