mcp -esa

This MCP server bundle provides tools to deploy and manage Alibaba Cloud ESA resources from your MCP client. The Pages tool lets you deploy static sites to the edge in a single command, while the Edge Routine (ER) tools handle the full lifecycle of serverless edge functions (create, deploy, route, and tear down). The Site tooling covers DNS, SSL certificates, IPv6 configuration, and site-wide transforms. You can enable any combination of modules by running the corresponding npx commands or by loading multiple modules in a single MCP config. Use the modular binaries such as mcp-server-esa-pages, mcp-server-esa-er, and mcp-server-esa-site to tailor the server to your needs, or run the all-in-one wrapper to manage everything together.

Prerequisites:

• Node.js and npm (Node 14+ recommended)
• Internet access to fetch packages via npm/yarn

Installation steps:

1. Install Node.js from https://nodejs.org/ if not already installed.
2. Ensure npm works: npm -v
3. Install and run via npx (no global install required):

Usage examples:

• Deploy pages: npx -y -p mcp-server-esa mcp-server-esa-pages
• Run the all-in-one MCP: npx -y mcp-server-esa

If you want to pin versions for stability:

• npx -y -p mcp-server-esa@1.2.0 mcp-server-esa-pages

Configuration is provided in a JSON file as described in the README, containing mcpServers with command, args, and environment variables.

Environment variables:

• ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are required to authenticate with Alibaba Cloud.
• OPTIONALLY ALIBABA_CLOUD_SECURITY_TOKEN can be set if you are using STS tokens.

Tips:

• Use the modular approach to load only the modules you need (Pages, ER, Site).
• For security, avoid committing real credentials in config files; use secrets management where possible.
• If you encounter rate limits or network errors, ensure your AK/SK have the necessary ESA permissions and that Edge Routine service is enabled.
• The all-in-one module ESA-MCP-Server is convenient for development but consider deploying individual modules in production for finer access control.