Fastlymcp

🚀 Fastly NGWAF MCP服務器

這是一個全面的模型上下文協議（MCP）服務器，可與Fastly NGWAF（下一代Web應用防火牆）API實現無縫集成。該服務器使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. 將規則應用到已配置的站點

🔧 技術細節

可用工具

認證與設置

• 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文檔

更新日誌

v1.0.0

• 初始版本，全面覆蓋NGWAF API
• 實現MCP服務器
• 規則管理（CRUD操作）
• IP列表管理
• 分析和監控
• 支持CloudWAF
• 用戶管理功能