项目简介

该项目提供一个MCP服务器实现,允许AI模型或MCP客户端通过标准接口与Fastly API进行交互。它将复杂的Fastly API操作封装为结构化的工具,使AI能够轻松理解和调用,从而实现自动化管理和自然语言控制Fastly CDN资源。

主要功能点

  • Fastly API接口: 通过标准化的MCP工具接口访问Fastly API。
  • 服务管理: 创建、列出、获取、更新和删除Fastly服务。
  • 版本控制: 列出服务版本,克隆和激活特定版本。
  • 域名和后端管理: 列出、创建和删除域名,以及管理源站(origins)和后端服务器(backends)。
  • 缓存控制: 列出、创建和更新缓存设置,执行全面、按URL或按Key的内容清除(Purge)。
  • 安全配置: 获取WAF设置,创建WAF配置,更新WAF规则状态,以及管理速率限制规则。
  • 统计和监控: 获取全局统计、服务统计摘要和实时指标流。
  • VCL管理: 列出和创建VCL配置。
  • 字典管理: 列出、创建边缘字典(Edge Dictionaries)及其条目。
  • 安全认证: 支持通过环境变量配置API密钥等安全信息进行API调用。

安装步骤

该服务器作为一个Node.js包发布在NPM上。可以通过npm或bun进行安装和运行。通常,为了让MCP客户端能够启动服务器,最方便的方式是使用'npx'直接运行包。

使用npm全局安装(可选,如果使用npx则不需要):

npm install -g fastly-mcp-server

服务器配置

MCP客户端需要知道如何启动这个服务器来建立连接。以下是典型的JSON配置示例,描述了如何启动服务器并传递必要的参数。请注意,MCP客户端不需要手动运行命令,只需在配置中提供这些信息,客户端会自动管理服务器的启动和通信。

{
  "fastly": { // 服务器的唯一标识名称,用于在MCP客户端中引用
    "command": "npx", // 启动服务器的命令,这里使用npx执行npm包
    "args": ["-y", "fastly-mcp-server@latest", "run"], // 传递给command的参数,"-y" 用于自动确认安装 (仅首次), "fastly-mcp-server@latest" 是要执行的npm包名及其版本, "run" 是服务器启动命令
    "env": { // 可选的环境变量,用于配置API密钥等敏感信息
      "API_KEY_APIKEYAUTH": "你的Fastly API密钥" // Fastly API认证所需的密钥环境变量名,格式通常为 "API_KEY_" + OpenAPI规范中定义的安全方案名称的大写形式。此处 "ApiKeyAuth" 来自Fastly OpenAPI规范。请将 "你的Fastly API密钥" 替换为你实际的Fastly API token。
    }
  }
}

请将 '"你的Fastly API密钥"' 替换为你实际的Fastly API token。具体的配置方式(如环境变量、MCP客户端的特定配置语法等)取决于你使用的MCP客户端。

基本使用方法

  1. 确保你已经安装了MCP客户端。
  2. 在MCP客户端的配置中添加上述MCP服务器配置,包括正确的'command'、'args'以及用于认证Fastly API的'env'变量(设置'API_KEY_APIKEYAUTH'为你的Fastly API密钥)。
  3. 启动MCP客户端。客户端将根据配置自动启动Fastly MCP服务器。
  4. 通过MCP客户端发送MCP请求(例如,ListToolsRequest获取可用工具列表,或CallToolRequest调用特定的Fastly API工具),即可与Fastly API进行交互。例如,AI代理可以通过理解用户的自然语言指令,将其转化为CallToolRequest请求,然后由这个MCP服务器代为调用Fastly API完成任务。

信息

分类

AI与计算