Security Weekly MCP
MCP Server 架構的資安週報與術語庫管理系統，專為台灣資安社群設計。
功能特色
- 32 個資安來源 - 自動收集國際與台灣資安新聞（並行抓取優化）
- 兩階段週報架構 - GitHub Actions 保存原始資料，Claude 分析產生高品質報告
- WebSearch/WebFetch 整合 - 透過 Claude Code 補充 RSS 無法取得的資訊
- 歷史週報支援 - 可產生任意時間範圍的歷史報告
- 術語庫整合 - 自動提取並標註資安術語 (437+ 個術語)
- 術語審核工具 - 批准/拒絕待審術語的完整工作流程
- HTML 週報 - 透過 GitHub Pages 發布的線上週報
- 安全審計 - CI 整合 pip-audit 自動檢測依賴漏洞
- 健康檢查 - 每月自動驗證 RSS 來源可用性
快速開始
1. 安裝依賴
git clone --recursive https://github.com/your-repo/security-weekly-mcp.git
cd security-weekly-mcp
uv sync2. 設定 Claude Code MCP
在 ~/.claude/settings.json 加入：
{
"mcpServers": {
"security-weekly-tw": {
"command": "/home/ubuntu/.local/bin/uv",
"args": [
"run",
"--directory",
"/path/to/security-weekly-mcp",
"--package",
"security-weekly-mcp-server",
"python",
"-m",
"security_weekly_mcp.server"
]
}
}
}3. 產生週報
在 Claude Code 中輸入：
產生本週資安週報---
週報產生架構
本系統採用兩階段架構，解決 RSS 資料揮發性問題：
┌──────────────────────────────────────────────────────────────────────┐
│ 階段 1：自動資料收集 │
│ (GitHub Actions 每週一自動執行) │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ weekly-collect.yml (週一 09:00 UTC+8) │
│ │ │
│ ▼ │
│ collect_weekly_data.py │
│ │ │
│ ├─ fetch_security_news → 32 個 RSS 來源 (並行抓取) │
│ ├─ fetch_vulnerabilities → NVD + CISA KEV │
│ └─ suggest_searches → 搜尋查詢建議 │
│ │ │
│ ▼ │
│ output/raw/YYYY-WNN.json ← Git 自動提交保存 │
│ │
└──────────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────┐
│ 階段 2：智慧報告產生 │
│ (使用者說「產生週報」時執行) │
├──────────────────────────────────────────────────────────────────────┤
│ │
│ load_weekly_data → 載入已保存的原始資料 │
│ │ │
│ ▼ │
│ Claude 分析 + WebSearch 補充 │
│ │ │
│ ├─ 分析新聞趨勢 │
│ ├─ 執行建議搜尋查詢 │
│ ├─ extract_terms → 提取術語 │
│ └─ validate_terminology → 驗證用詞 │
│ │ │
│ ▼ │
│ generate_report_draft → JSON 結構化資料 │
│ │ │
│ ▼ │
│ output/reports/SEC-WEEKLY-YYYY-WW.json │
│ deploy-rss.yml → HTML 頁面發布至 GitHub Pages │
│ │
└──────────────────────────────────────────────────────────────────────┘方式一：透過 Claude Code (推薦)
# 使用已保存的資料產生週報
產生本週資安週報
# 查看可用的週報資料
列出已收集的週報資料
# 產生歷史週報
產生 2026-W05 的週報方式二：手動資料收集 + 報告產生
# 1. 手動收集資料 (如果 GitHub Actions 未執行)
uv run python scripts/collect_weekly_data.py --days 7
# 2. 之後在 Claude Code 中說「產生週報」歷史週報
對於已過期的 RSS 資料，系統會：
- 使用
suggest_searches產生帶時間過濾的搜尋查詢 - 透過 WebSearch 搜尋歷史資料
- 整合結果並產生報告
---
專案結構
security-weekly-mcp/
├── packages/
│ ├── glossary/ # 術語庫 (Git Submodule)
│ │ ├── src/security_glossary_tw/
│ │ ├── terms/ # 術語 YAML 檔案 (7 個分類)
│ │ ├── meta/ # 元資料 (categories, style_guide)
│ │ └── pending/ # 待審術語
│ │
│ └── mcp-server/ # MCP Server 套件
│ └── src/security_weekly_mcp/
│ ├── server.py # MCP Server 主程式
│ └── tools/ # MCP 工具模組
│ ├── glossary.py # 術語庫工具 (8 個)
│ ├── news.py # 新聞收集工具 (6 個)
│ └── report.py # 週報工具 (3 個)
│
├── skill/ # Claude Code Skill
│ └── SKILL.md # 自然語言介面定義
│
├── config/
│ ├── sources.yaml # 32 個資料來源設定
│ ├── search_templates.yaml # WebSearch 查詢模板
│ └── writing_style.yaml # 寫作風格指南
│
├── scripts/
│ ├── collect_weekly_data.py # 資料收集腳本 (階段 1)
│ └── generate_weekly_report.py # 直接產生週報 (傳統模式)
│
├── output/
│ ├── raw/ # 原始資料 (GitHub Actions 自動提交)
│ │ └── YYYY-WNN.json # 週報原始資料
│ └── reports/ # 產生的週報
│ └── SEC-WEEKLY-YYYY-WW.md # Markdown 週報
│
└── .github/workflows/
├── ci.yml # CI 測試 + 安全審計
├── weekly-collect.yml # 每週一自動收集資料
├── weekly-reminder.yml # 每週五提醒 Issue
└── monthly-health.yml # 每月 RSS 健康檢查---
MCP 工具清單 (16 個)
術語庫工具 (8 個)
| 工具 | 功能 | 用途 | |------|------|------| | search_term | 模糊搜尋術語庫 | 查詢英/中文術語 | | get_term_definition | 取得完整術語定義 | 深入了解術語 | | validate_terminology | 驗證用詞規範 | 檢查禁止用詞 | | add_term_links | 為文本加術語連結 | Markdown/HTML 輸出 | | list_pending_terms | 列出待審術語 | 術語審核流程 | | extract_terms | 從文本自動提取術語 | 週報產生自動填充 | | approve_pending_term | 批准待審術語 | 移至正式術語庫 | | reject_pending_term | 拒絕待審術語 | 刪除待審檔案 |
新聞收集工具 (6 個)
| 工具 | 功能 | 資料來源 | |------|------|----------| | fetch_security_news | 收集資安新聞 (並行) | RSS (32 個來源) | | fetch_vulnerabilities | 收集漏洞資訊 | NVD + CISA KEV | | list_news_sources | 列出新聞來源 | sources.yaml | | suggest_searches | 產生搜尋建議 | search_templates.yaml | | list_weekly_data | 列出已保存週報資料 | output/raw/ | | load_weekly_data | 載入指定週的資料 | output/raw/YYYY-WNN.json |
週報工具 (3 個)
| 工具 | 功能 | 輸出格式 | |--------------------------|--------------------| -------- | | generate_report_draft | 產生週報結構化資料 | JSON | | compile_report_pdf | 使用 Typst 編譯 PDF | PDF | | list_reports | 列出已產生的週報 | 清單 |
---
資料來源 (32 個)
國際資安新聞 (8 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | The Hacker News | high | 最受歡迎的資安新聞 | | Krebs on Security | high | Brian Krebs 調查報導 | | SecurityWeek | medium | 企業資安新聞 | | Dark Reading | medium | 深度資安分析 | | Schneier on Security | high | Bruce Schneier 部落格 | | Infosecurity Magazine | high | 獲獎資安媒體 | | CyberScoop | high | 政策與資安新聞 | | BleepingComputer | disabled | Cloudflare 防護 |
台灣來源 (5 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | iThome 資安 | high | 台灣 IT 媒體 (RSS) | | TWCERT/CC 資安新聞 | critical | 台灣 CERT 資安新聞 (RSS) | | TWCERT/CC 漏洞公告 | critical | 台灣 CERT TVN 漏洞公告 (RSS) | | TechNews 資安 | high | 科技新報資安專區 (RSS) | | 資安人 | medium | 台灣資安媒體 (WebFetch) |
官方公告 (4 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | CISA Alerts | critical | 美國 CISA 公告 | | CISA KEV | critical | 已知被利用漏洞 | | CERT/CC Vulnerability Notes | high | 卡內基美隆大學 CERT | | CIS MS-ISAC Advisories | high | 網際網路安全中心 |
漏洞資料庫 (2 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | NVD | high | NIST 漏洞資料庫 | | GitHub Security Advisories | medium | 開源漏洞 |
威脅情報 (12 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | Mandiant Blog | high | Google 威脅情報 | | Microsoft Security Blog | high | 微軟安全部落格 | | Unit 42 | high | Palo Alto 威脅研究 | | Recorded Future | high | 威脅情報領導者 | | Check Point Research | high | Check Point 研究 | | CrowdStrike Blog | high | CrowdStrike 威脅情報 | | SentinelOne Blog | high | SentinelLabs 研究 | | Securelist (Kaspersky) | high | 卡巴斯基 GReAT | | Sophos Blog | medium | Sophos 威脅研究 | | Google Security Blog | medium | Google 安全部落格 | | WeLiveSecurity (ESET) | medium | ESET 威脅研究 | | Elastic Security Labs | medium | Elastic 安全研究 |
廠商公告 (1 個)
| 來源 | 優先級 | 說明 | |------|--------|------| | Microsoft MSRC | high | 微軟安全回應中心 |
---
開發指令
# 安裝依賴
uv sync
# 執行測試
uv run pytest
# 執行測試 (跳過慢速網路測試)
uv run pytest -m "not slow"
# 測試 MCP Server
uv run --package security-weekly-mcp-server python -c \
"from security_weekly_mcp.server import app; print(f'MCP Server: {app.name}')"
# 啟動 MCP Server (stdio 模式)
uv run --package security-weekly-mcp-server python -m security_weekly_mcp.server
# 開發模式 (MCP Inspector)
uv run --package security-weekly-mcp-server mcp dev \
packages/mcp-server/src/security_weekly_mcp/server.py
# 更新術語庫 (Git Submodule)
git submodule update --remote packages/glossary
# 列出新聞來源
uv run python -c "
import asyncio
from security_weekly_mcp.tools import news
result = asyncio.run(news.call_tool('list_news_sources', {}))
print(result[0].text)
"---
術語庫同步
packages/glossary/ 是 Git Submodule，指向 astroicers/security-glossary-tw。
# 初始化 (clone 後)
git submodule update --init --recursive
# 更新術語庫
git submodule update --remote packages/glossaryCI/CD 已設定 submodules: recursive，自動處理。
---
GitHub Actions
CI 測試 (ci.yml)
- Python 3.11 / 3.12 矩陣測試
- Ruff 程式碼檢查
- MCP Server 載入測試
- pip-audit 安全審計 - 檢測依賴套件漏洞
週報資料收集 (weekly-collect.yml)
- 每週一 09:00 (台灣時間) 執行
- 收集 RSS 新聞、NVD/KEV 漏洞
- 保存原始 JSON 至
output/raw/ - Git 自動提交並推送
- 支援手動觸發 (workflow_dispatch)
週報提醒 (weekly-reminder.yml)
- 每週五 09:00 (台灣時間) 執行
- 建立 GitHub Issue 提醒產生週報
- 列出本週收集的資料統計
RSS 健康檢查 (monthly-health.yml)
- 每月 1 日 執行
- 驗證所有 RSS 來源可用性
- 產生健康報告至 GitHub Summary
---
LINE Notify 整合
當週報部署到 GitHub Pages 時，自動發送 LINE 通知給訂閱者。
設定步驟
- 建立 LINE Notify 服務
- 前往 LINE Notify
- 點擊「產生權杖」
- 選擇要接收通知的聊天室（個人或群組）
- 複製產生的 Access Token
- 設定 GitHub Secret
- 前往專案的 Settings > Secrets and variables > Actions
- 點擊「New repository secret」
- Name:
LINE_NOTIFY_TOKEN - Value: 貼上步驟 1 取得的 Access Token
- 完成！ 之後每次週報發布時，LINE 會自動收到通知：
📰 台灣資安週報 2026-W08 已發布
本週摘要：
• 3 起資安事件
• 5 個高風險漏洞
• 威脅等級：中
閱讀完整報告：
https://glossary.astroicers.link/weekly/reports/SEC-WEEKLY-2026-W08.html手動發送測試
# 設定環境變數
export LINE_NOTIFY_TOKEN="your-token-here"
# 預覽訊息（不實際發送）
uv run python scripts/notify_line.py --latest --dry-run
# 發送通知
uv run python scripts/notify_line.py --latest---
相關專案
| 專案 | 說明 | |------|------| | security-glossary-tw | 術語庫獨立倉庫 | | Claude Code Skill | 自然語言介面（位於 skill/ 目錄） |
Claude Code Skill 設定
Skill 已包含在本專案的 skill/ 目錄中，使用 symlink 連結：
# 建立 symlink（如果尚未存在）
ln -s /path/to/security-weekly-mcp/skill ~/.claude/skills/security-weekly-tw---
授權
MIT License
