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:

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

Edge Routine (ER)

Site

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