Fastlymcp

🚀 Fastly NGWAF MCP 服務器

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
• 用戶管理功能