convez.ai
MCP ServerSegurançaAvançado
astroicers

Security Weekly MCP

astroicers/security-weekly-mcp

Boletim de segurança automatizado com análise inteligente via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que automatiza a coleta e análise de notícias de segurança de 32 fontes internacionais e taiwanesas, gerando relatórios semanais em chinês tradicional. Integra WebSearch para complementar dados RSS, mantém histórico completo de relatórios e gerencia uma terminologia de 437+ termos de segurança.

Instalação

$npx convez-ai astroicers/security-weekly-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 2 dias
Versão
—
Issues abertas
9
Contribuidores
2

Casos de uso

  • Gerar relatórios semanais de segurança para equipes de TI
  • Monitorar vulnerabilidades e tendências globais de segurança
  • Manter terminologia padronizada em documentos de segurança
  • Criar histórico auditável de notícias de segurança

Veredito

Solução robusta e bem-arquitetada para comunidades de segurança que precisam de relatórios sistemáticos. A separação em duas fases (coleta automatizada + análise inteligente) resolve problemas reais de volatilidade de dados RSS e garante qualidade editorial.

README

A tradução para o português deste README ainda está na fila.

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 sync

2. 設定 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 資料,系統會:

  1. 使用 suggest_searches 產生帶時間過濾的搜尋查詢
  2. 透過 WebSearch 搜尋歷史資料
  3. 整合結果並產生報告

專案結構

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 編譯 PDFPDF
list_reports列出已產生的週報清單

資料來源 (32 個)

國際資安新聞 (8 個)

來源優先級說明
The Hacker Newshigh最受歡迎的資安新聞
Krebs on SecurityhighBrian Krebs 調查報導
SecurityWeekmedium企業資安新聞
Dark Readingmedium深度資安分析
Schneier on SecurityhighBruce Schneier 部落格
Infosecurity Magazinehigh獲獎資安媒體
CyberScoophigh政策與資安新聞
BleepingComputerdisabledCloudflare 防護

台灣來源 (5 個)

來源優先級說明
iThome 資安high台灣 IT 媒體 (RSS)
TWCERT/CC 資安新聞critical台灣 CERT 資安新聞 (RSS)
TWCERT/CC 漏洞公告critical台灣 CERT TVN 漏洞公告 (RSS)
TechNews 資安high科技新報資安專區 (RSS)
資安人medium台灣資安媒體 (WebFetch)

官方公告 (4 個)

來源優先級說明
CISA Alertscritical美國 CISA 公告
CISA KEVcritical已知被利用漏洞
CERT/CC Vulnerability Noteshigh卡內基美隆大學 CERT
CIS MS-ISAC Advisorieshigh網際網路安全中心

漏洞資料庫 (2 個)

來源優先級說明
NVDhighNIST 漏洞資料庫
GitHub Security Advisoriesmedium開源漏洞

威脅情報 (12 個)

來源優先級說明
Mandiant BloghighGoogle 威脅情報
Microsoft Security Bloghigh微軟安全部落格
Unit 42highPalo Alto 威脅研究
Recorded Futurehigh威脅情報領導者
Check Point ResearchhighCheck Point 研究
CrowdStrike BloghighCrowdStrike 威脅情報
SentinelOne BloghighSentinelLabs 研究
Securelist (Kaspersky)high卡巴斯基 GReAT
Sophos BlogmediumSophos 威脅研究
Google Security BlogmediumGoogle 安全部落格
WeLiveSecurity (ESET)mediumESET 威脅研究
Elastic Security LabsmediumElastic 安全研究

廠商公告 (1 個)

來源優先級說明
Microsoft MSRChigh微軟安全回應中心

開發指令

# 安裝依賴
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/glossary

CI/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 通知給訂閱者。

設定步驟

  1. 建立 LINE Notify 服務

    • 前往 LINE Notify
    • 點擊「產生權杖」
    • 選擇要接收通知的聊天室(個人或群組)
    • 複製產生的 Access Token
  2. 設定 GitHub Secret

    • 前往專案的 Settings > Secrets and variables > Actions
    • 點擊「New repository secret」
    • Name: LINE_NOTIFY_TOKEN
    • Value: 貼上步驟 1 取得的 Access Token
  3. 完成! 之後每次週報發布時,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

Ver o original no GitHub

Bom para

Relacionados