ESA MCP Server

ESA MCP Server

Servidor MCP para Alibaba Cloud ESA: implementa en el edge, gestiona DNS, certificados y Edge Routines, todo desde tu IDE con IA.

English | 中文

Características

• 🚀 Pages — Implementa HTML o carpetas estáticas (dist/, build/) en el edge con un solo comando
• ⚡ Edge Routine — Gestión completa del ciclo de vida: crear, confirmar, implementar, enrutar y eliminar
• 🌐 Site — Registros DNS, certificados SSL, IPv6, transformaciones gestionadas y configuración del sitio
• 🧩 Modular — Carga las más de 40 herramientas o elige solo el módulo que necesites
• 🔌 Funciona en todas partes — Cursor, Claude Desktop, Cline y cualquier cliente compatible con MCP

Inicio rápido

Requisitos previos

1. Obtén tu AccessKey ID y Secret en la página de AccessKey de Alibaba Cloud
2. Habilita el servicio Edge Routine

Configuración

Añade a la configuración de tu cliente MCP (p. ej., Cursor ~/.cursor/mcp.json, Claude Desktop, Cline):

Pages (recomendado) — implementa sitios estáticos en el edge en 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"
      }
    }
  }
}

Todo en uno — incluye herramientas de Pages, ER y 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 — carga solo lo que necesites:

Módulo	Binario	Ideal para
Pages	mcp-server-esa-pages	Desarrolladores frontend: implementa archivos HTML/estáticos en el edge
ER	mcp-server-esa-er	Desarrolladores de edge: ciclo de vida completo de Edge Routine
Site	mcp-server-esa-site	DevOps / SRE: DNS, certificados, IPv6, configuración del sitio

Ejecuta un módulo específico: npx -p mcp-server-esa <binary> Fija una versión: npx -p mcp-server-esa@1.1.0 <binary>

Edge Routine — gestión completa del ciclo de vida para funciones edge serverless:

{
  "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 y configuración del sitio:

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

Demo

Claude Desktop

Cline

Cline configurado correctamente:

Claude Desktop configurado correctamente:

Herramientas

Pages

Herramienta	Descripción
html_deploy	Implementa una página HTML en ESA Pages y devuelve una URL de acceso predeterminada
folder_deploy	Implementa una carpeta local de archivos estáticos (HTML/CSS/JS/imágenes) en ESA Pages, empaquetada automáticamente

Edge Routine (ER)

Categoría	Herramienta	Descripción
Rutinas	routine_create	Crea una nueva Edge Routine
	routine_delete	Elimina una Edge Routine
	routine_list	Lista todas las Edge Routines
	routine_get	Obtén los detalles de una Edge Routine
Implementaciones	routine_code_commit	Guarda una versión de código para una Edge Routine
	routine_code_deploy	Implementa una versión de código en staging o producción
	deployment_delete	Elimina una versión de código
Rutas	route_create	Crea una ruta para una Edge Routine
	route_update	Actualiza la configuración de una ruta
	route_delete	Elimina una ruta
	route_get	Obtén los detalles de una ruta
	routine_route_list	Lista las rutas de una Edge Routine
	site_route_list	Lista las rutas de un sitio
Registros	er_record_create	Crea un registro para una Edge Routine
	er_record_delete	Elimina un registro
	er_record_list	Lista los registros de una Edge Routine

Site

Categoría	Herramienta	Descripción
Sitios	list_sites	Lista todos los sitios
	site_active_list	Lista los sitios activos
	site_match	Encuentra un sitio que coincida con los criterios dados
	create_site	Crea un nuevo sitio
	get_site_pause	Consulta la configuración del proxy de ESA
	update_site_pause	Actualiza la configuración del proxy de ESA
DNS	site_record_list	Lista los registros DNS de un sitio
	create_site_a_or_aaaa_record	Crea un registro A/AAAA
	create_site_cname_record	Crea un registro CNAME
	create_site_txt_record	Crea un registro TXT
	create_site_ns_record	Crea un registro NS
	create_site_mx_record	Crea un registro MX
	update_record	Actualiza un registro DNS
	get_record	Obtén un registro DNS
	list_records	Lista los registros DNS
	delete_record	Elimina un registro DNS
IPv6	update_ipv6	Actualiza la configuración de IPv6
	get_ipv6	Consulta la configuración de IPv6
Transformación	update_managed_transform	Actualiza la configuración de transformación gestionada
	get_managed_transform	Consulta la configuración de transformación gestionada
Certificado	set_certificate	Habilita/actualiza el certificado de un sitio
	apply_certificate	Solicita un certificado SSL gratuito
	get_certificate	Obtén los detalles del certificado
	delete_certificate	Elimina un certificado
	list_certificates	Lista los certificados de un sitio
	get_certificate_quota	Consulta la cuota y el uso de certificados

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