Skip to main content
Glama

Fastly

by jedisct1

Fastly API - OpenAPI 规范

此存储库包含Fastly API的全面、非官方 OpenAPI 3.0 规范,该规范是通过对公开的 API 文档进行逆向工程创建的。与官方网页文档相比,它具有显著增强的文档,包含详细的描述、示例和针对人类开发人员和 AI 代理优化的结构化模式。

关键组件

该项目提供了使用 Fastly API 的三个关键资源:

  1. 完整的 OpenAPI 规范fastly-openapi.yaml ) - 适用于所有 Fastly API 端点的全面 OpenAPI 3.0 架构
  2. AI 优化规范( fastly-openapi-mcp.yaml ) - 针对 AI 代理使用情况优化的精简子集
  3. 模型上下文协议服务器( fastly-mcp-server/ ) - 一种 MCP 服务器实现,允许 AI 模型通过标准化协议与 Fastly 交互

用于 AI 集成的 MCP 服务器

该存储库包含 Fastly 的完整模型上下文协议 (MCP)服务器,可在 NPM 上获取:

# Install globally npm install -g fastly-mcp-server # Or run directly npx fastly-mcp-server run

该 MCP 服务器使 AI 助手和代理能够:

  • 通过自然语言与 Fastly 服务进行交互
  • 管理 CDN 配置、缓存设置和安全功能
  • 执行内容清除、统计数据收集和服务部署
  • 通过标准化界面访问所有主要的 Fastly 功能

请参阅fastly-mcp-server目录以了解详细的使用示例和配置选项。

免责声明

本规范为非官方规范,Fastly 不对其提供任何认可、支持或保证。本规范可能不完整或包含不准确之处。本规范“按原样”提供,不提供任何形式的担保。

特征

  • Fastly CDN API 的全面 OpenAPI 3.0 架构
  • 增强的文档,其清晰度和详细程度超越了官方网站文档
  • 专为大型语言模型和 AI 代理使用而设计的AI 优化模式
  • 带有操作上下文和示例的详细端点描述
  • 所有请求和响应对象的完整模式定义
  • 支持所有主要的 Fastly API 功能:
    • 服务管理
    • 域配置
    • 后端管理
    • VCL 操作
    • 缓存控制
    • 清除操作
    • 边缘词典
    • WAF 安全
    • 日志记录端点
    • 统计数据和指标
    • 边缘计算

规格

该存储库包含两个 OpenAPI 规范:

fastly-openapi.yaml

Fastly API 的完整规范,包含所有端点、参数和架构。本规范:

  • 提供比官方网站文档更全面、更结构化的文档
  • 包含解释使用环境(而不仅仅是参数)的详细描述
  • 包含所有操作和数据模式的一致示例
  • 对于全面的 API 文档和客户端生成很有用

fastly-openapi-mcp.yaml

精简的 API 子集,专门针对 AI 代理交互进行了优化。此规范:

  • 仅包含常见 Fastly 任务最常用的端点
  • 专注于日常管理所需的核心操作
  • 保留针对 AI 理解进行优化的详细描述和示例
  • 优先考虑对话界面中最有用的端点
  • 遵循与常见用户工作流程相匹配的基于任务的组织
  • 减少人工智能环境的代币消耗,同时最大化效用

MCP 版本非常适合与需要通过自然语言界面与 Fastly 交互的 AI 助手和工具集成。

用法

查看文档

您可以使用以下工具根据这些规范生成交互式文档:

例子:

# For the complete API npx @redocly/cli preview-docs fastly-openapi.yaml # For the AI-optimized subset npx @redocly/cli preview-docs fastly-openapi-mcp.yaml

验证

验证规范:

# For the complete API npx @stoplight/spectral-cli lint fastly-openapi.yaml # Or use swagger-cli npx swagger-cli validate fastly-openapi.yaml # For the AI-optimized subset npx @stoplight/spectral-cli lint fastly-openapi-mcp.yaml

代码生成

这些规范可与 OpenAPI 代码生成器一起使用,以创建各种编程语言的客户端库:

# For the complete API npx @openapitools/openapi-generator-cli generate -i fastly-openapi.yaml -g javascript -o ./client # For the AI-optimized subset npx @openapitools/openapi-generator-cli generate -i fastly-openapi-mcp.yaml -g javascript -o ./client-mcp

特工准备就绪

这两种规范均设计为“代理就绪”——针对 AI 代理和工具的使用进行了优化。它们遵循机器可读性的最佳实践:

  • 详细的操作说明,信息密度比官方文档更高
  • 相关端点之间的一致命名模式
  • 完整的架构文档,包含详尽的属性描述
  • 所有操作和架构组件的示例
  • 组件之间结构合理的引用和关系

MCP 版本通过以下方式进一步提高了代理准备程度:

  • 为常见任务精心挑选高价值端点
  • 以任务为导向的组织与用户意图相一致
  • 增强描述,重点关注对话上下文
  • 删除日常使用中很少出现的专用端点
  • 针对 AI 环境中的代币消耗进行优化

有关 MCP 规范的具体用例,请参阅subset.md ,其中概述了常见的对话任务和相应的 API 工作流程。

MCP 服务器使用情况

要将 MCP 服务器与您的 AI 助手配置一起使用:

包子(推荐)

{ "mcpServers": { "fastly api": { "command": "bunx", "args": ["fastly-mcp-server@latest", "run"], "env": { "API_KEY_APIKEYAUTH": "your-fastly-api-key" } } } }

Node.js

{ "mcpServers": { "fastly": { "command": "npx", "args": ["-y", "fastly-mcp-server@latest", "run"], "env": { "API_KEY_APIKEYAUTH": "your-fastly-api-key" } } } }

注意:Bun 因其卓越的性能和启动时间而成为 fastly-mcp-server 的首选运行时。

有关配置和使用的更多详细信息,请参阅fastly-mcp-server 文档

资源

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    Algolia
    Last updated -
    18
    Go
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    Mailmodo
    Last updated -
    12
    134
    TypeScript
    GPL 3.0
    • Apple
    • Linux
  • A
    security
    A
    license
    A
    quality
    Liveblocks
    Last updated -
    39
    1
    TypeScript
    Apache 2.0

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jedisct1/fastly-openapi-schema'

If you have feedback or need assistance with the MCP directory API, please join our Discord server