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 com um comando (dist/, build/) para a edge
• ⚡ Edge Routine — Gerenciamento completo do ciclo de vida: criar, commitar, fazer deploy, rotear e remover
• 🌐 Site — Registros DNS, certificados SSL, IPv6, transforms gerenciados 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. Habilite 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" } } } }

All-in-one — inclui as 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	Devs de frontend — deploy de arquivos HTML/estáticos para a edge
ER	mcp-server-esa-er	Devs 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>Fixar uma versão: npx -p mcp-server-esa@1.1.0 <binary>

Edge Routine — gerenciamento completo do ciclo de vida para funções serverless de 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
Rotinas	routine_create	Cria uma nova Edge Routine
routine_delete	Exclui uma Edge Routine
routine_list	Lista todas as Edge Routines
routine_get	Obtém detalhes da Edge Routine
Deploys	routine_code_commit	Salva uma versão de código para uma 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
Rotas	route_create	Cria uma rota para uma 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 uma Edge Routine
site_route_list	Lista rotas para um site
Registros	er_record_create	Cria um registro para uma Edge Routine
er_record_delete	Exclui um registro
er_record_list	Lista registros para uma 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
create_site	Cria um novo site
get_site_pause	Consulta a configuração do proxy ESA
update_site_pause	Atualiza a configuração do proxy ESA
DNS	site_record_list	Lista registros DNS para 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 IPv6
get_ipv6	Consulta a configuração IPv6
Transform	update_managed_transform	Atualiza a configuração de transform gerenciado
get_managed_transform	Consulta a configuração de transform gerenciado
Certificado	set_certificate	Habilita/atualiza certificado para 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 para 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.

Licença

MIT