Fastlymcp

🚀 Fastly NGWAF MCP Server

このサーバーは、Fastly NGWAF（Next-Gen Web Application Firewall）APIとシームレスに統合する包括的なモデルコンテキストプロトコル（MCP）サーバーです。ClaudeのようなAIアシスタントが自然言語での対話を通じてWebアプリケーションのセキュリティを管理できるようになります。

✨ 主な機能

🛡️ 完全なWAF管理

• セキュリティルールの作成、読み取り、更新、削除
• IP許可/ブロックリストの管理
• レート制限とアラートの設定
• セキュリティイベントと分析の監視

🏢 マルチテナンシー対応

• 企業とサイトレベルの管理
• コンテキストを考慮した操作
• 複数サイトにまたがる一括操作

🤖 AIフレンドリーなインターフェイス

• 自然言語でのルール作成
• インテリジェントな脅威パターン検出
• 自動化されたセキュリティポリシー提案

📦 インストール

前提条件

• Node.js 18以上
• APIアクセスを持つFastly NGWAFアカウント
• MCP互換のAIアシスタント（Claude Desktopなど）

セットアップ

1. リポジトリをクローンする

git clone https://github.com/yourusername/FastlyMCP.git
cd FastlyMCP

2. 依存関係をインストールする

npm install

3. 環境変数を設定する（オプション）

# .envファイルを作成する
FASTLY_NGWAF_EMAIL=your-email@example.com
FASTLY_NGWAF_TOKEN=your-api-token
FASTLY_NGWAF_DEFAULT_CORP=your-corp-name
FASTLY_NGWAF_DEFAULT_SITE=your-site-name

4. サーバーを起動する

npm start

📚 ドキュメント

Claude Desktopとの統合

Claude Desktopの設定ファイルに以下を追加してください。

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fastly-ngwaf": {
      "command": "node",
      "args": ["path/to/FastlyMCP/server.js"],
      "env": {
        "FASTLY_NGWAF_EMAIL": "your-email@example.com",
        "FASTLY_NGWAF_TOKEN": "your-api-token"
      }
    }
  }
}

AIによる対話

自然言語: "Create a rule to block SQL injection attacks on my website"

AIの応答: アシスタントは自動的に以下を行います。

1. 意図（セキュリティルールの作成）を検出する
2. 脅威の種類（SQLインジェクション）を特定する
3. 適切なルール条件を生成する
4. 設定されたサイトにルールを適用する

💻 使用例

基本的な使用法

以下は、API接続をテストする基本的なコマンド例です。

# サーバーを起動する
npm start
# 別のターミナル/AIセッションで:
# test_connection()

高度な使用法

自然言語でのルール作成と適用の例です。

# サーバーを起動する
npm start
# AIセッションで:
# "Create a rule to block SQL injection attacks on my website"

利用可能なツール

認証とセットアップ

• set_credentials - API資格情報を設定する
• test_connection - API接続を検証する
• set_context - デフォルトの企業/サイトコンテキストを設定する
• discover_environment - 利用可能なリソースを探索する

ルール管理

• list_corp_rules / list_site_rules - セキュリティルールを一覧表示する
• create_corp_rule / create_site_rule - 新しいルールを作成する
• delete_corp_rule / delete_site_rule - ルールを削除する

セキュリティ監視

• list_events - セキュリティイベントを表示する
• search_requests - リクエストログを検索する
• get_suspicious_ips - 脅威の源を特定する
• expire_event - IPのブロックを手動で解除する

IPリスト管理

• manage_whitelist - IPアドレスを許可/ブロックする
• manage_blacklist - 悪意のあるIPをブロックする
• manage_lists - カスタムIP/国/文字列リストを管理する

分析とレポート

• get_analytics - セキュリティメトリクスとトレンドを取得する
• get_corp_overview - 攻撃の概要を取得する
• manage_alerts - 監視アラートを設定する

高度な機能

• manage_cloudwaf - CloudWAFインスタンスを管理する
• manage_users - ユーザーアクセスを制御する

一般的なユースケース

🚨 インシデント対応

"An IP address 1.2.3.4 is attacking my site, block it immediately"

• AIが自動的に脅威を特定する
• 適切な期間でIPをブラックリストに追加する
• ブロックが有効になったことを確認する

🛡️ 予防的なセキュリティ

"Set up protection against the latest OWASP top 10 vulnerabilities"

• 包括的なルールセットを作成する
• 適切なしきい値を設定する
• 監視アラートを設定する

📊 セキュリティ分析

"Show me attack trends from the past month and suggest improvements"

• 過去の攻撃データを分析する
• パターンと脅威の源を特定する
• ルールの最適化を提案する

🔧 一括管理

"Apply the same security rules from site A to sites B, C, and D"

• 既存のルール設定をエクスポートする
• 異なるサイトに適したルールを調整する
• 検証付きで一括適用する

📚 詳細ドキュメント

APIリファレンス

サーバーは、直感的なMCPツールを通じて完全なFastly NGWAF APIを公開します。各ツールは特定のAPIエンドポイントにマッピングされ、認証、コンテキスト解決、エラー管理を自動的に処理します。

レート制限

サーバーはFastly APIのレート制限を尊重し、適切なリトライロジックを実装しています。

🔧 技術詳細

プロジェクト構造

FastlyMCP/
├── server.js          # メインのMCPサーバー実装
├── package.json       # 依存関係とスクリプト
├── README.md          # このドキュメント
└── .env.example       # 環境変数のテンプレート

テスト

# API接続をテストする
npm start
# 別のターミナル/AIセッションで:
# test_connection()

トラブルシューティング

一般的な問題

認証失敗

• メールアドレスとAPIトークンが正しいことを確認する
• トークンに適切な権限があることを確認する
• Fastlyアカウントの状態を確認する

コンテキストエラー

• デフォルトの企業を設定する: set_context({ corpName: "your-corp" })
• 企業/サイト名が存在することを確認する: discover_environment()

許可が拒否された

• ユーザーロールに必要な権限があることを確認する
• Fastlyダッシュボードでサイトアクセスを確認する

デバッグモード

環境変数を設定して詳細なログを有効にします。

DEBUG=fastly-ngwaf npm start

セキュリティに関する考慮事項

• API資格情報を安全に保管する（環境変数または安全な資格情報マネージャーを使用）
• APIトークンに最小限の権限の原則を適用する
• API資格情報を定期的に更新する
• 不正なAPI使用を監視する
• 依存関係を最新の状態に保つ

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

サポート

• 📚 Fastly NGWAF Documentation

変更履歴

v1.0.0

• 完全なNGWAF APIカバレッジでの初期リリース
• MCPサーバーの実装
• ルール管理（CRUD操作）
• IPリスト管理
• 分析と監視
• CloudWAFサポート
• ユーザー管理機能