Mcp Server Esa

ESA MCP 服务

阿里云 ESA 的 MCP 服务——从 AI 驱动的 IDE 部署到边缘节点、管理 DNS、证书和 Edge Routines。

English | 中文

功能

• 🚀 Pages — 通过一条命令将 HTML 或静态文件夹（dist/、build/）部署到边缘节点
• ⚡ Edge Routine — 完整的生命周期管理：创建、提交、部署、路由和拆除
• 🌐 Site — DNS 记录、SSL 证书、IPv6、托管转换和站点配置
• 🧩 模块化 — 加载全部 40+ 个工具，也可以只选择所需模块
• 🔌 随处可用 — 支持 Cursor、Claude Desktop、Cline 以及任何兼容 MCP 的客户端

快速开始

前提条件

1. 从阿里云 AccessKey 页面获取 AccessKey ID 和 Secret
2. 启用 Edge Routine 服务

配置

添加到 MCP 客户端配置中（例如 Cursor ~/.cursor/mcp.json、Claude Desktop、Cline）：

Pages（推荐） — 几秒钟内将静态网站部署到边缘节点：

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

一体化 — 包含 Pages、ER 和 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"
      }
    }
  }
}

模块化 — 只加载所需内容：

模块	二进制文件	适用场景
Pages	mcp-server-esa-pages	前端开发者——将 HTML/静态文件部署到边缘节点
ER	mcp-server-esa-er	边缘开发者——完整的 Edge Routine 生命周期管理
Site	mcp-server-esa-site	DevOps / SRE——DNS、证书、IPv6、站点配置

运行指定模块：npx -p mcp-server-esa <binary> 固定版本：npx -p [email protected] <binary>

Edge Routine — 对无服务器边缘函数进行完整的生命周期管理：

{
  "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、证书、IPv6 和站点配置：

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

多个模块：

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

演示

Claude Desktop

Cline

Cline 配置成功：

Claude Desktop 配置成功：

工具

Pages

工具	描述
html_deploy	将 HTML 页面部署到 ESA Pages，并返回默认访问 URL
folder_deploy	将本地静态文件文件夹（HTML/CSS/JS/图片）部署到 ESA Pages，并自动打包

Edge Routine (ER)

类别	工具	描述
例程	routine_create	创建新的 Edge Routine
	routine_delete	删除 Edge Routine
	routine_list	列出所有 Edge Routine
	routine_get	获取 Edge Routine 详情
部署	routine_code_commit	保存 Edge Routine 的代码版本
	routine_code_deploy	将代码版本部署到预发或生产环境
	deployment_delete	删除代码版本
路由	route_create	为 Edge Routine 创建路由
	route_update	更新路由配置
	route_delete	删除路由
	route_get	获取路由详情
	routine_route_list	列出 Edge Routine 的路由
	site_route_list	列出站点的路由
记录	er_record_create	为 Edge Routine 创建记录
	er_record_delete	删除记录
	er_record_list	列出 Edge Routine 的记录

站点

类别	工具	描述
站点	list_sites	列出所有站点
	site_active_list	列出活跃站点
	site_match	查找符合指定条件的站点
	create_site	创建新站点
	get_site_pause	查询 ESA 代理配置
	update_site_pause	更新 ESA 代理配置
DNS	site_record_list	列出站点的 DNS 记录
	create_site_a_or_aaaa_record	创建 A/AAAA 记录
	create_site_cname_record	创建 CNAME 记录
	create_site_txt_record	创建 TXT 记录
	create_site_ns_record	创建 NS 记录
	create_site_mx_record	创建 MX 记录
	update_record	更新 DNS 记录
	get_record	获取 DNS 记录
	list_records	列出 DNS 记录
	delete_record	删除 DNS 记录
IPv6	update_ipv6	更新 IPv6 配置
	get_ipv6	查询 IPv6 配置
转换	update_managed_transform	更新托管转换配置
	get_managed_transform	查询托管转换配置
证书	set_certificate	为站点启用/更新证书
	apply_certificate	申请免费 SSL 证书
	get_certificate	获取证书详情
	delete_certificate	删除证书
	list_certificates	列出站点的证书
	get_certificate_quota	查询证书配额和使用情况

提示词示例

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.

许可证

MIT