ESA MCP Server

ESA MCP Server

Servidor MCP para Alibaba Cloud ESA — faça deploy para a edge, gerencie DNS, certificados e Edge Routines, tudo a partir da sua IDE com IA.

English | 中文

Recursos

• 🚀 Pages — Deploy de HTML ou pastas estáticas (dist/, build/) para a edge com um único comando
• ⚡ Edge Routine — Gerenciamento completo do ciclo de vida: criar, commitar, fazer deploy, rotear e desmontar
• 🌐 Site — Registros DNS, certificados SSL, IPv6, transformações gerenciadas e configuração do site
• 🧩 Modular — Carregue todas as 40+ ferramentas ou escolha apenas o módulo que você precisa
• 🔌 Funciona em qualquer lugar — Cursor, Claude Desktop, Cline e qualquer cliente compatível com MCP

Início Rápido

Pré-requisitos

1. Obtenha seu AccessKey ID e Secret na página de AccessKey da Alibaba Cloud
2. Ative o serviço Edge Routine

Configuração

Adicione à configuração do seu cliente MCP (ex.: Cursor ~/.cursor/mcp.json, Claude Desktop, Cline):

Pages (recomendado) — faça deploy de sites estáticos para a edge em segundos:

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

Tudo-em-um — inclui ferramentas de Pages, ER e Site:

{
  "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 — carregue apenas o que você precisa:

Módulo	Binário	Ideal para
Pages	mcp-server-esa-pages	Desenvolvedores frontend — deploy de arquivos HTML/estáticos para a edge
ER	mcp-server-esa-er	Desenvolvedores de edge — ciclo de vida completo do Edge Routine
Site	mcp-server-esa-site	DevOps / SREs — DNS, certificados, IPv6, configuração do site

Execute um módulo específico: npx -p mcp-server-esa <binary> Fixe uma versão: npx -p mcp-server-esa@1.1.0 <binary>

Edge Routine — gerenciamento completo do ciclo de vida para funções serverless na edge:

{
  "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, certificados, IPv6 e configuração do site:

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

Múltiplos módulos:

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

Demonstração

Claude Desktop

Cline

Cline configurado com sucesso:

Claude Desktop configurado com sucesso:

Ferramentas

Pages

Ferramenta	Descrição
html_deploy	Faz deploy de uma página HTML para ESA Pages, retorna uma URL de acesso padrão
folder_deploy	Faz deploy de uma pasta local de arquivos estáticos (HTML/CSS/JS/imagens) para ESA Pages, empacotada automaticamente

Edge Routine (ER)

Categoria	Ferramenta	Descrição
Routines	routine_create	Cria um novo Edge Routine
	routine_delete	Exclui um Edge Routine
	routine_list	Lista todos os Edge Routines
	routine_get	Obtém detalhes do Edge Routine
Deployments	routine_code_commit	Salva uma versão de código para um Edge Routine
	routine_code_deploy	Faz deploy de uma versão de código para staging ou produção
	deployment_delete	Exclui uma versão de código
Routes	route_create	Cria uma rota para um Edge Routine
	route_update	Atualiza a configuração de uma rota
	route_delete	Exclui uma rota
	route_get	Obtém detalhes da rota
	routine_route_list	Lista rotas para um Edge Routine
	site_route_list	Lista rotas para um site
Records	er_record_create	Cria um registro para um Edge Routine
	er_record_delete	Exclui um registro
	er_record_list	Lista registros para um Edge Routine

Site

Categoria	Ferramenta	Descrição
Sites	list_sites	Lista todos os sites
	site_active_list	Lista sites ativos
	site_match	Encontra um site que corresponda aos critérios informados
	create_site	Cria um novo site
	get_site_pause	Consulta a configuração de proxy da ESA
	update_site_pause	Atualiza a configuração de proxy da ESA
DNS	site_record_list	Lista registros DNS de um site
	create_site_a_or_aaaa_record	Cria um registro A/AAAA
	create_site_cname_record	Cria um registro CNAME
	create_site_txt_record	Cria um registro TXT
	create_site_ns_record	Cria um registro NS
	create_site_mx_record	Cria um registro MX
	update_record	Atualiza um registro DNS
	get_record	Obtém um registro DNS
	list_records	Lista registros DNS
	delete_record	Exclui um registro DNS
IPv6	update_ipv6	Atualiza a configuração de IPv6
	get_ipv6	Consulta a configuração de IPv6
Transform	update_managed_transform	Atualiza a configuração de transformação gerenciada
	get_managed_transform	Consulta a configuração de transformação gerenciada
Certificate	set_certificate	Habilita/atualiza o certificado de um site
	apply_certificate	Solicita um certificado SSL gratuito
	get_certificate	Obtém detalhes do certificado
	delete_certificate	Exclui um certificado
	list_certificates	Lista certificados de um site
	get_certificate_quota	Consulta cota e uso de certificados

Exemplos de Prompts

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.