readme_zh.md•7.14 kB
# ESA MCP Server
一个MCP服务器，简化对阿里云ESA多种服务的调用
---
[English](./readme.md) | [中文](./readme_zh.md)
## 安装
1. **在 Accesskey 页面申请阿里云的 AK 和 SK**
https://ram.console.aliyun.com/profile/access-keys
2. **开通边缘函数服务**
https://esa.console.aliyun.com/edge/function/list
3. **在支持 MCP 的客户端配置中进行设置：**
```json
{
"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": "sts_security_token optional, required when using STS Token (默认不需要传)"
}
}
}
}
```
## 演示视频
**Claude 演示**
**Cline 演示**
**Cline 配置成功：**
**Claude 配置成功：**
## 工具列表
**服务器提供以下可通过 MCP 协议调用的 ESA 工具：**
| 类别 | 工具 | 描述 |
| ------------ | ---------------------------- | ------------------------------------------------------ |
| **HTML** | html_deploy | 快速部署一个HTML到新的边缘函数（ER） |
| **边缘函数** | routine_create | 在你的阿里云账户中创建新的边缘函数（ER）。 |
| | routine_delete | 从你的阿里云账户中删除现有的边缘函数（ER）。 |
| | routine_list | 列出你的阿里云账户中的所有边缘函数（ER）。 |
| | routine_get | 获取特定边缘函数（ER）的详细信息。 |
| **部署** | routine_code_commit | 在边缘函数（ER）中保存代码版本以供后续修改或发布使用。 |
| | routine_code_deploy | 将选定的代码版本部署到测试或生产环境。 |
| | deployment_delete | 删除与边缘函数（ER）相关的指定代码版本。 |
| **路由** | route_create | 创建与边缘函数（ER）相关的新路由。 |
| | route_update | 修改现有边缘函数路由的配置。 |
| | route_delete | 删除与边缘函数（ER）相关的指定路由。 |
| | route_get | 获取与边缘函数（ER）相关的特定路由的详细信息。 |
| | routine_route_list | 列出与特定边缘函数（ER）相关的所有路由。 |
| | site_route_list | 列出与特定站点相关的所有路由。 |
| **记录** | er_record_create | 创建与边缘函数（ER）相关的新记录。 |
| | er_record_delete | 删除与边缘函数（ER）相关的指定记录。 |
| | er_record_list | 列出与特定边缘函数（ER）相关的所有记录。 |
| **站点** | site_active_list | 列出你的阿里云账户中所有激活的站点。 |
| | site_match | 识别账户中与提供的输入条件匹配的站点。 |
| | site_record_list | 列出与特定站点相关的所有 DNS 记录。 |
| | create_site_a_or_aaaa_record | 在站点下创建一条 A/AAAA 类型的 DNS 解析记录。 |
| | create_site_cname_record | 在站点下创建一条 CNAME 类型的 DNS 解析记录。 |
| | create_site_txt_record | 在站点下创建一条 TXT 类型的 DNS 解析记录。 |
| | create_site_ns_record | 在站点下创建一条 NS 类型的 DNS 解析记录。 |
| | create_site_mx_record | 在站点下创建一条 MX 类型的 DNS 解析记录。 |
| | get_site_pause | 查询站点暂停配置。 |
| | update_site_pause | 修改站点暂停配置。 |
| | create_site | 让用户创建一个新的站点。 |
| | update_record | 更新多种类型的 DNS 记录。 |
| | get_record | 查询单个 DNS 记录的配置。 |
| | list_record | 查询站点的 DNS 记录列表。 |
| | delete_record | 根据指定的 RecordId 删除站点的 DNS 记录。 |
| | update_ipv6 | 修改站点的 IPv6 配置。 |
| | get_ipv6 | 查询站点的 IPv6 配置。 |
| | update_managed_transform | 修改站点的托管转换配置。 |
| | get_managed_transform | 查询托管转换配置。 |
| | list_sites | 列出您阿里云账户中注册的所有站点。 |
| Certificate | set_certificate | 用于设置某站点下是否启用证书功能及更新证书信息 |
| | apply_certificate | 申请免费 SSL 证书。 |
| | get_certificate | 获取站点下指定证书信息。 |
| | delete_certificate | 删除站点下的特定证书。 |
| | list_certificates | 查询特定站点下的证书列表。 |
| | get_certificate_quota | 查询证书配额和使用情况。 |
## Prompt示例
- 编写一个 2048 游戏并将其部署在边缘函数上，显示边缘函数提供的默认访问 URL。
- 删除 2025 年 5 月之后创建的边缘函数。
- 列出我的账户下的所有边缘函数。
- 我的边缘函数“hello-world”的默认访问地址是什么？
- 为 `test.example.com` 创建一个 CNAME 记录，值设置为 `example2.com`。
- 为 `test.example.com` 创建一个 A 记录，值设置为 `1.1.1.1`。
- 编写一个五子棋HTML到ER中
## 许可证
MIT