关键词

阿里云ESA边缘例程管理站点配置DNS记录LLM工具调用

使用说明

项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在作为大型语言模型 (LLM) 客户端与阿里云边缘安全加速 (ESA) 服务之间的桥梁。它将 ESA 的各种管理 API 封装为标准的 MCP 工具，允许 LLM 通过 MCP 协议调用这些工具，实现对 ESA 资源的自动化管理和操作，例如创建、删除、部署和管理边缘例程 (Edge Routines) 以及相关的域名记录和站点配置。

主要功能点

  • 暴露 ESA API 为工具： 将阿里云 ESA 服务的 API 接口转换为遵循 MCP Tool 规范的工具集合，供 LLM 客户端调用。
  • 边缘例程 (Routine) 管理： 提供创建、删除、列出、获取例程详情、提交例程代码至暂存环境以及部署例程代码至指定环境（生产/预发/金丝雀）的能力。
  • 例程路由 (Route) 管理： 支持创建、更新、删除、获取路由详情以及列出例程或站点的路由信息，用于控制流量如何匹配并转发到边缘例程。
  • 站点 (Site) 与记录管理： 能够列出账号下的活跃站点，查找与用户输入匹配的站点，以及在站点下创建 A 记录和 CNAME 记录，并列出站点的所有记录。
  • 记录 (Record) 管理： 提供创建、删除和列出例程相关的记录的能力。
  • 通过 Stdio 通信： 服务器通过标准输入输出 (Stdio) 协议与 MCP 客户端进行交互。

安装步骤

该服务器通常作为 MCP 生态系统的一部分，以 npm 包的形式发布。用户无需手动在系统上全局安装。标准的 MCP 客户端（例如 'cline' 或支持 MCP 的其他应用）会根据其配置文件自动下载并运行该服务器。您只需确保您的系统具备运行 Node.js 应用的环境即可。

服务器配置

该 MCP 服务器的配置需要在您使用的 MCP 客户端的配置文件中完成。通常，您需要在客户端配置文件的 'mcpServers' 字段中添加一个条目来描述如何启动和连接到此服务器。以下是一个典型的配置示例（以 JSON 格式表示）：

{
  "mcpServers": {
    "esa-mcp-server": { // 您为该服务器在客户端中指定的唯一名称
      "command": "npx", // 用于启动服务器进程的命令
      "args": ["-y", "mcp-server-esa"], // 传递给 command 的参数，"-y mcp-server-esa" 表示使用 npx 直接运行 mcp-server-esa 包
      "env": { // 启动服务器进程时需要设置的环境变量，用于阿里云认证
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "此处填写您阿里云账号的Access Key ID",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "此处填写您阿里云账号的Access Key Secret",
        "ALIBABA_CLOUD_SECURITY_TOKEN": "此处填写STS Token (如果使用STS临时凭证则必需，否则可留空或省略此行)"
      }
    }
    // 如果有其他MCP服务器，可以在此处继续添加配置...
  },
  // 客户端的其他配置项...
}

配置完成后，当您启动配置了上述信息的 MCP 客户端时，客户端会自动尝试启动并连接到 'esa-mcp-server'。

基本使用方法

在 MCP 客户端成功连接到 'esa-mcp-server' 后，客户端会通过 MCP 协议发现该服务器提供的所有工具（如 'routine_create', 'site_active_list' 等）及其详细的输入参数定义 ('inputSchema') 和描述。之后，LLM 就可以利用这些信息，通过客户端发起 Tool Calling 的请求，调用相应的 ESA 管理工具来执行具体任务。具体的交互方式取决于您的 MCP 客户端如何集成 Tool Calling 功能。LLM 会根据用户的指令和工具的描述，生成符合工具 'inputSchema' 格式的参数，并通过客户端发送给 'esa-mcp-server' 执行。服务器执行完成后，会将结果返回给客户端，进而呈现给 LLM 或用户。

信息

分类

AI与计算

访问项目