Fastly API - OpenAPI 仕様
このリポジトリには、 Fastly APIの包括的な非公式 OpenAPI 3.0 仕様が含まれています。これは、公開されている API ドキュメントをリバースエンジニアリングして作成されたものです。公式ウェブドキュメントと比較して大幅に強化されたドキュメントを備えており、詳細な説明、例、そして人間の開発者と AI エージェントの両方に最適化された構造化されたスキーマが含まれています。
主要コンポーネント
このプロジェクトは、Fastly API を操作するための 3 つの主要なリソースを提供します。
- 完全な OpenAPI 仕様(
fastly-openapi.yaml ) - すべての Fastly API エンドポイント用の包括的な OpenAPI 3.0 スキーマ - AI 最適化仕様(
fastly-openapi-mcp.yaml ) - AI エージェントの使用に最適化された合理化されたサブセット - モデルコンテキストプロトコルサーバー（
fastly-mcp-server/ ） - AIモデルが標準化されたプロトコルを介してFastlyと対話できるようにするMCPサーバーの実装
AI統合のためのMCPサーバー
リポジトリには、NPM で利用可能な Fastly 用の完全なModel Context Protocol (MCP)サーバーが含まれています。
# 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セキュリティ
- ログエンドポイント
- 統計と指標
- エッジコンピューティング
仕様
このリポジトリには、2 つの OpenAPI 仕様が含まれています。
fastly-openapi.yaml
Fastly API の完全な仕様。すべてのエンドポイント、パラメータ、スキーマが含まれています。この仕様には以下の特徴があります。
- 公式ウェブドキュメントよりも徹底的かつ構造化されたドキュメントを提供します
- パラメータだけでなく使用コンテキストを説明する詳細な説明が含まれています
- すべての操作とデータ スキーマの一貫した例が含まれています
- 包括的なAPIドキュメントとクライアント生成に役立ちます
fastly-openapi-mcp.yaml
AIエージェントとのインタラクションに特化して最適化されたAPIの合理化されたサブセット。この仕様は以下のとおりです。
- 一般的なFastlyタスクで最も頻繁に使用されるエンドポイントのみが含まれています
- 日々の管理に必要なコア業務に重点を置きます
- AIの理解に最適化された詳細な説明と例を維持
- 会話型インターフェースで最も有用なエンドポイントを優先します
- 一般的なユーザーワークフローに一致するタスクベースの構成に従います
- 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 仕様の具体的な使用例については、一般的な会話型タスクと対応する API ワークフローの概要を示すsubset.md を参照してください。
MCP サーバーの使用状況
AI アシスタント構成で MCP サーバーを使用するには:
パン（おすすめ）
{
"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 のドキュメントを参照してください。
リソース