ESA MCP Server

MCP server for Alibaba Cloud ESA — deploy to the edge, manage DNS, certificates, and Edge Routines, all from your AI-powered IDE.

English | 中文

Features

• 🚀 Pages — One-command deploy HTML or static folders (dist/, build/) to the edge
• ⚡ Edge Routine — Full lifecycle management: create, commit, deploy, route, and tear down
• 🌐 Site — DNS records, SSL certificates, IPv6, managed transforms, and site configuration
• 🧩 Modular — Load all 40+ tools or pick only the module you need
• 🔌 Works everywhere — Cursor, Claude Desktop, Cline, and any MCP-compatible client

Quick Start

Prerequisites

1. Get your AccessKey ID and Secret from the Alibaba Cloud AccessKey page
2. Enable the Edge Routine service

Configuration

Add to your MCP client config (e.g., Cursor ~/.cursor/mcp.json, Claude Desktop, Cline):

Pages (recommended) — deploy static sites to the edge in seconds:

{
  "mcpServers": {
    "esa-pages": {
      "command": "npx",
      "args": ["-y", "-p", "mcp-server-esa", "mcp-server-esa-pages"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    }
  }
}

All-in-one — includes Pages, ER, and Site tools:

{
  "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": "optional, required when using STS Token"
      }
    }
  }
}

Modular — load only what you need:

Module	Binary	Best for
Pages	mcp-server-esa-pages	Frontend devs — deploy HTML/static files to the edge
ER	mcp-server-esa-er	Edge developers — full Edge Routine lifecycle
Site	mcp-server-esa-site	DevOps / SREs — DNS, certificates, IPv6, site config

Run a specific module: npx -p mcp-server-esa <binary> Pin a version: npx -p mcp-server-esa@1.1.0 <binary>

Edge Routine — full lifecycle management for serverless edge functions:

{
  "mcpServers": {
    "esa-er": {
      "command": "npx",
      "args": ["-y", "-p", "mcp-server-esa", "mcp-server-esa-er"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    }
  }
}

Site — DNS, certificates, IPv6, and site configuration:

{
  "mcpServers": {
    "esa-site": {
      "command": "npx",
      "args": ["-y", "-p", "mcp-server-esa", "mcp-server-esa-site"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    }
  }
}

Multiple modules:

{
  "mcpServers": {
    "esa-pages": {
      "command": "npx",
      "args": ["-y", "-p", "mcp-server-esa", "mcp-server-esa-pages"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    },
    "esa-site": {
      "command": "npx",
      "args": ["-y", "-p", "mcp-server-esa", "mcp-server-esa-site"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your AK",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your SK"
      }
    }
  }
}

Demo

Claude Desktop

Cline

Cline configured successfully:

Claude Desktop configured successfully:

Tools

Pages

Tool	Description
html_deploy	Deploy an HTML page to ESA Pages, returns a default access URL
folder_deploy	Deploy a local folder of static files (HTML/CSS/JS/images) to ESA Pages, auto-packaged

Edge Routine (ER)

Category	Tool	Description
Routines	routine_create	Create a new Edge Routine
	routine_delete	Delete an Edge Routine
	routine_list	List all Edge Routines
	routine_get	Get Edge Routine details
Deployments	routine_code_commit	Save a code version for an Edge Routine
	routine_code_deploy	Deploy a code version to staging or production
	deployment_delete	Delete a code version
Routes	route_create	Create a route for an Edge Routine
	route_update	Update a route configuration
	route_delete	Delete a route
	route_get	Get route details
	routine_route_list	List routes for an Edge Routine
	site_route_list	List routes for a site
Records	er_record_create	Create a record for an Edge Routine
	er_record_delete	Delete a record
	er_record_list	List records for an Edge Routine

Site

Category	Tool	Description
Sites	list_sites	List all sites
	site_active_list	List active sites
	site_match	Find a site matching given criteria
	create_site	Create a new site
	get_site_pause	Query ESA proxy configuration
	update_site_pause	Update ESA proxy configuration
DNS	site_record_list	List DNS records for a site
	create_site_a_or_aaaa_record	Create an A/AAAA record
	create_site_cname_record	Create a CNAME record
	create_site_txt_record	Create a TXT record
	create_site_ns_record	Create an NS record
	create_site_mx_record	Create an MX record
	update_record	Update a DNS record
	get_record	Get a DNS record
	list_records	List DNS records
	delete_record	Delete a DNS record
IPv6	update_ipv6	Update IPv6 configuration
	get_ipv6	Query IPv6 configuration
Transform	update_managed_transform	Update managed transform configuration
	get_managed_transform	Query managed transform configuration
Certificate	set_certificate	Enable/update certificate for a site
	apply_certificate	Apply for a free SSL certificate
	get_certificate	Get certificate details
	delete_certificate	Delete a certificate
	list_certificates	List certificates for a site
	get_certificate_quota	Query certificate quota and usage

Prompt Examples

Write a 2048 game and deploy it on Edge Routine, show me the access URL.
Deploy the ./dist folder to ESA Pages.
List all Edge Routines under my account.
Delete Edge Routines created after May 2025.
What is the default access URL for my Edge Routine "hello-world"?
Create a CNAME record for test.example.com pointing to example2.com.
Create an A record for test.example.com with value 1.1.1.1.
Apply a free SSL certificate for my site example.com.
Show me the IPv6 configuration for my site.

License

MIT