JUHE API Marketplace
aliyun avatar
MCP Server

ESA MCP Server

An implementation of the Model Context Protocol server that enables AI models to communicate with Edge Security Acceleration (ESA) services, allowing models to manage routines, deployments, routes, records, and sites through standardized protocols.

24
GitHub Stars
8/23/2025
Last Updated
No Configuration
Please check the documentation below.

README Documentation

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

  1. Enable Edge Routine service

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

  1. 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

1744168230082

1744168440370

Cline Demo

1744168966418

Cline configured successfully:

1744114625974

Claude configured successfully:

1744165412296

Tools List

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

CategoryToolDescription
HTMLhtml_deployQuick deploy a HTML in a new Edge Routine (ER)
Routinesroutine_createCreate a new Edge Routine (ER) in your Alibaba Cloud account.
routine_deleteDelete an existing Edge Routine (ER) from your Alibaba Cloud account.
routine_listList all Edge Routines (ERs) in your Alibaba Cloud account.
routine_getGet a the details of a Edge Routine (ER).
Deploymentsroutine_code_commitSave a code version for future modifications or release within an Edge Routine (ER).
routine_code_deployDeploy a selected code version to the staging or production environment.
deployment_deleteDelete a specified code version associated with an Edge Routine (ER).
Routesroute_createCreate a new route associated with an Edge Routine (ER).
route_updateModify the configuration of an existing Edge Routine route.
route_deleteDelete a specified route associated with an Edge Routine (ER).
route_getGet details of a specific route associated with an Edge Routine (ER).
routine_route_listList all routes associated with a specific Edge Routine (ER).
site_route_listList all routes associated with a specific site.
Recordser_record_createCreate a new record related to an Edge Routine (ER).
er_record_deleteDelete a specified record associated with an Edge Routine (ER).
er_record_listList all records associated with a specific Edge Routine (ER).
Sitessite_active_listList all active sites registered in your Alibaba Cloud account.
site_matchIdentify which site in the account matches the provided input criteria.
site_record_listList DNS records associated with a specific site.
create_site_a_or_aaaa_recordCreates an A or AAAA DNS record for a specific website.
create_site_cname_recordCreates a CNAME DNS record for a specific website.
create_site_txt_recordCreates a TXT DNS record for a specific website.
create_site_ns_recordCreates an NS DNS record for a specific website.
create_site_mx_recordCreates an MX DNS record for a specific website.
get_site_pauseQueries the ESA proxy configuration of a website.
update_site_pauseModifies the ESA proxy configuration of a website.
create_siteAdds a website.
update_recordThis operation allows you to update multiple types of DNS records.
get_recordQueries the configuration of a single DNS record.
list_recordQueries a list of Domain Name System (DNS) records of a website.
delete_recordDeletes a DNS record of a website based on the specified RecordId.
update_ipv6Modifies the IPv6 configuration of a website.
get_ipv6Queries the IPv6 configuration of a website.
update_managed_transformModifies the configuration of managed transforms for your website.
get_managed_transformQuery Managed Transform Configuration.
list_sitesList all sites registered in your Alibaba Cloud account.
Certificateset_certificateConfigures whether to enable certificates and update certificate information for a website.
apply_certificateApplies for a free SSL certificate.
get_certificateRetrieve the certificate, private key, and certificate information
delete_certificateDeletes a certificate for a website.
list_certificatesLists certificates of a website.
get_certificate_quotaQuery 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

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source