Skip to main content
Glama
deenesjakoruzh

Fastly

by jedisct1
GitHub
JavaScript
3
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Fastly API - OpenAPI 仕様

このリポジトリには、 Fastly APIの包括的な非公式 OpenAPI 3.0 仕様が含まれています。これは、公開されている API ドキュメントをリバースエンジニアリングして作成されたものです。公式ウェブドキュメントと比較して大幅に強化されたドキュメントを備えており、詳細な説明、例、そして人間の開発者と AI エージェントの両方に最適化された構造化されたスキーマが含まれています。

主要コンポーネント

このプロジェクトは、Fastly API を操作するための 3 つの主要なリソースを提供します。

  1. 完全な OpenAPI 仕様( fastly-openapi.yaml ) - すべての Fastly API エンドポイント用の包括的な OpenAPI 3.0 スキーマ
  2. AI 最適化仕様( fastly-openapi-mcp.yaml ) - AI エージェントの使用に最適化された合理化されたサブセット
  3. モデルコンテキストプロトコルサーバー（ 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 のドキュメントを参照してください。

リソース

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

速く

  1. 主要コンポーネント
    1. AI統合のためのMCPサーバー
      1. 免責事項
        1. 特徴
          1. 仕様
            1. fastly-openapi.yaml
            2. fastly-openapi-mcp.yaml
          2. 使用法
            1. ドキュメントの表示
            2. 検証
            3. コード生成
          3. エージェントの準備状況
            1. MCP サーバーの使用状況
              1. パン（おすすめ）
              2. Node.js
            2. リソース

              Related MCP Servers

              • Algoliaofficial

                algolia
                -
                security
                A
                license
                -
                quality
                Algolia
                Last updated -
                18
                Go
                MIT License
                • Apple

              • Mailmodoofficial

                mailmodo
                A
                security
                A
                license
                A
                quality
                Mailmodo
                Last updated -
                12
                134
                TypeScript
                GPL 3.0
                • Apple
                • Linux

              • Liveblocksofficial

                liveblocks
                A
                security
                A
                license
                A
                quality
                Liveblocks
                Last updated -
                39
                1
                TypeScript
                Apache 2.0

              View all related MCP servers

              New 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