NVD و EPSS و CISA KEV و GitHub Advisory و OSV و Shodan و VulnCheck و Vulners و Nuclei و Metasploit و CIRCL و AttackerKB و MITRE ATT&CK — موحّدة في خادم MCP واحد.
يحصل وكيل الذكاء الاصطناعي الخاص بك على استخبارات الثغرات عند الطلب، وليس تقريراً من 200 صفحة.
---
## المشكلة
استخبارات الثغرات الأمنية مبعثرة عبر قواعد بيانات متعددة. NVD يحتوي على تفاصيل CVE. EPSS يخبرك باحتمالية الاستغلال. CISA KEV يتتبع الثغرات المُستغلّة فعلياً. GitHub Advisory يغطي حزم المصدر المفتوح. OSV يربط الثغرات بإصدارات حزم محددة. Shodan يتتبع التعرض على الإنترنت. Nuclei و Metasploit يخبرانك إذا كان هناك استغلال عامل. لا توجد أداة واحدة تجمعها، ولا أي منها يعمل مع وكلاء الذكاء الاصطناعي.
```
سير العمل التقليدي:
البحث في NVD عن تفاصيل CVE ← التنقل في واجهة ويب ثقيلة
التحقق من EPSS لمخاطر الاستغلال ← API منفصل، تنسيق منفصل
البحث عن حالة CISA KEV ← تحميل JSON feed يدوياً
البحث في GitHub advisories ← واجهة أخرى
الاستعلام من OSV عن تأثير الحزم ← API مختلف، مخطط مختلف
التحقق من Shodan للتعرض ← اشتراك منفصل
البحث عن استغلالات Nuclei/MSF ← بحث يدوي على GitHub
الربط بتقنيات ATT&CK ← استعلام MITRE منفصل
ربط كل شيء معاً ← نسخ ولصق في جدول بيانات
──────────────────────────────────
المجموع: 30+ دقيقة لكل CVE، أكثر للفرز الجماعي
```
**cve-mcp** يمنح وكيل الذكاء الاصطناعي الخاص بك 41 أداة عبر [Model Context Protocol](https://modelcontextprotocol.io). يستعلم الوكيل من 11 مصدراً بالتوازي، ويربط البيانات، ويكشف إشارات التسليح، ويحسب درجات المخاطر، ويخبرك بالضبط ما هو مهم.
```
مع cve-mcp:
أنت: "رتّب هذه الـ 10 CVE حسب مخاطر الاستغلال الفعلية"
الوكيل: → يجلب درجات CVSS من NVD
→ يحصل على احتمالية استغلال EPSS لكل منها
→ يتحقق من CISA KEV للمُستغلّة فعلياً
→ يتحقق من GitHub advisories للتصحيحات
→ "3 حرجة: CVE-2024-3400 (EPSS 97%، في KEV)،
CVE-2023-44487 (HTTP/2 rapid reset، EPSS 96%)،
CVE-2021-44228 (Log4Shell، EPSS 97%، في KEV).
إليك التصحيحات والإصدارات المتأثرة..."
```
---
## ما الذي يميّزه
الأدوات الموجودة تعطيك بيانات خام. cve-mcp يمنح وكيل الذكاء الاصطناعي القدرة على التفكير حول الثغرات.
الوكيل يُثري: "CVSS 9.8، EPSS 97%، في KEV، قالب Nuclei موجود، وحدة MSF متاحة، يُربط بـ T1190"
الفرز الجماعي
CVE واحد في كل مرة
الوكيل يرتب 50 CVE في محادثة واحدة
تأثير الحزم
بحث منفصل في OSV/GHSA
الوكيل يجد الحزم والإصدارات المتأثرة تلقائياً
التبعيات
أدوات CLI ثقيلة، بيئات Python
تبعيتان فقط في وقت التشغيل، يعمل مع npx
---
## البدء السريع
### الخيار 1: npx (بدون تثبيت)
```bash
npx cve-mcp
```
### الخيار 2: استنساخ
```bash
git clone https://github.com/badchars/cve-mcp.git
cd cve-mcp
bun install
```
### متغيرات البيئة (اختيارية)
```bash
# يزيد حد معدل NVD من 5 إلى 50 طلباً كل 30 ثانية
export NVD_API_KEY=مفتاح-api-nvd-الخاص-بك
# يمكّن بحث GitHub Advisory (60 → 5000 طلب/ساعة)
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# VulnCheck بحث KEV موسّع، CPE، PURL
export VULNCHECK_API_KEY=مفتاح-vulncheck-الخاص-بك
# Vulners بحث الثغرات عبر 200+ مصدر
export VULNERS_API_KEY=مفتاح-vulners-الخاص-بك
# AttackerKB تقييمات المجتمع
export ATTACKERKB_API_KEY=مفتاح-attackerkb-الخاص-بك
```
جميعها اختيارية. الخادم يعمل بدونها — بعض الأدوات فقط لديها حدود معدل أقل أو بيانات مخفّضة.
### الاتصال بوكيل الذكاء الاصطناعي
Claude Code
```bash
# مع npx
claude mcp add cve-mcp -- npx cve-mcp
# مع نسخة محلية
claude mcp add cve-mcp -- bun run /المسار/إلى/cve-mcp/src/index.ts
```
Claude Desktop
أضف إلى `~/Library/Application Support/Claude/claude_desktop_config.json`:
```
أنت: "حلّل هذا المتجه CVSS v4.0: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N"
الوكيل: → cvss_parse {vector: "CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N"}
→ "CVSS v4.0 — الدرجة: 9.3 (حرج)
هجوم شبكي، تعقيد منخفض، لا متطلبات هجوم.
لا امتيازات مطلوبة، لا تفاعل مستخدم.
النظام المُعرّض: تأثير كامل على C/I/A.
الأنظمة اللاحقة: لا تأثير."
```
---
## مرجع الأدوات (41 أداة)
NVD (4)
| الأداة | الوصف |
|--------|-------|
| `nvd_search` | البحث عن CVE حسب الكلمة المفتاحية، الخطورة، CWE، نطاق التاريخ |
| `nvd_get` | الحصول على تفاصيل CVE الكاملة (CVSS، CWE، CPE، المراجع) |
| `nvd_recent` | CVE المنشورة/المعدّلة مؤخراً |
| `cve_by_product` | البحث عن CVE حسب اسم المنتج (مطابقة كلمات CPE المفتاحية) |
EPSS (2)
| الأداة | الوصف |
|--------|-------|
| `epss_score` | احتمالية استغلال EPSS لواحد أو أكثر من CVE |
| `epss_top` | أعلى CVE حسب احتمالية الاستغلال |
KEV (3)
| الأداة | الوصف |
|--------|-------|
| `kev_check` | التحقق مما إذا كانت CVE في كتالوج CISA Known Exploited Vulnerabilities |
| `kev_search` | البحث في KEV حسب المورّد أو المنتج أو الكلمة المفتاحية |
| `kev_recent` | إدخالات KEV المضافة مؤخراً |
GHSA (2)
| الأداة | الوصف |
|--------|-------|
| `ghsa_search` | البحث في إرشادات أمان GitHub حسب الكلمة المفتاحية، النظام البيئي، الخطورة |
| `ghsa_get` | الحصول على تفاصيل الإرشاد حسب GHSA ID أو CVE ID |
OSV (3)
| الأداة | الوصف |
|--------|-------|
| `osv_query` | الاستعلام عن ثغرات لإصدار حزمة محدد |
| `osv_get` | الحصول على تفاصيل الثغرة حسب OSV/GHSA/CVE ID |
| `osv_batch` | استعلام دُفعي لحزم متعددة دفعة واحدة |
Exploit (1)
| الأداة | الوصف |
|--------|-------|
| `exploit_search` | البحث عن استغلالات PoC العامة (مستودعات GitHub) |
Shodan (3)
| الأداة | الوصف |
|--------|-------|
| `shodan_cve` | استعلام CVE عبر Shodan CVEDB (EPSS، KEV، CPE مدمج، بدون مصادقة) |
| `shodan_product` | إيجاد CVE حسب اسم المنتج/المورّد عبر Shodan |
| `shodan_ip_vulns` | الحصول على الثغرات المعروفة لعنوان IP (InternetDB) |
VulnCheck (3)
| الأداة | الوصف |
|--------|-------|
| `vulncheck_kev` | كتالوج KEV موسّع (~80% إدخالات أكثر من CISA) |
| `vulncheck_cpe` | بحث CVE حسب سلسلة CPE |
| `vulncheck_purl` | بحث CVE حسب Package URL (purl) |
Vulners (2)
| الأداة | الوصف |
|--------|-------|
| `vulners_lookup` | تفاصيل CVE من Vulners (200+ مصدر، مراجع استغلال) |
| `vulners_search` | بحث نص كامل عن الثغرات في قاعدة بيانات Vulners |
Nuclei & Metasploit (2)
| الأداة | الوصف |
|--------|-------|
| `nuclei_check` | التحقق من وجود قالب كشف Nuclei لـ CVE |
| `msf_check` | التحقق من وجود وحدة استغلال Metasploit لـ CVE |
CPE (2)
| الأداة | الوصف |
|--------|-------|
| `cpe_search` | البحث في قاموس NVD CPE حسب الكلمة المفتاحية |
| `cpe_match` | الحصول على مطابقات CPE لـ CVE محدد |
CIRCL (1)
| الأداة | الوصف |
|--------|-------|
| `circl_cve` | إثراء CVE من CIRCL (ربط CAPEC، مراجع بديلة، متجهات التأثير) |
AttackerKB (1)
| الأداة | الوصف |
|--------|-------|
| `attackerkb_assess` | تقييمات المجتمع من AttackerKB (قيمة المهاجم، قابلية الاستغلال) |
ATT&CK (1)
| الأداة | الوصف |
|--------|-------|
| `cve_to_attack` | ربط CWE IDs من CVE بتقنيات وتكتيكات MITRE ATT&CK |
CWE (4)
| الأداة | الوصف |
|--------|-------|
| `cwe_lookup` | البحث عن نقطة ضعف CWE حسب المعرّف أو البحث بالكلمة المفتاحية (قاعدة بيانات ثابتة) |
| `cwe_get` | تفاصيل CWE كاملة من MITRE API (1000+ CWE، تخفيفات، أمثلة) |
| `cwe_hierarchy` | تسلسل CWE الهرمي أب/ابن من MITRE API |
| `cwe_top25` | MITRE CWE Top 25 Most Dangerous Software Weaknesses |
CVSS (1)
| الأداة | الوصف |
|--------|-------|
| `cvss_parse` | تحليل وشرح سلسلة متجه CVSS v3.1 أو v4.0 مع حساب الدرجة |
Meta (6)
| الأداة | الوصف |
|--------|-------|
| `cve_enrich` | إثراء كاملة: NVD + EPSS + KEV + GHSA + OSV + Shodan + Nuclei + MSF بالتوازي |
| `cve_prioritize` | ترتيب CVE حسب المخاطر (CVSS × EPSS × KEV × مُضاعف الاستغلال) |
| `cve_trending` | CVE الرائجة حالياً حسب احتمالية الاستغلال |
| `cve_compare` | مقارنة جنباً إلى جنب لاثنين من CVE |
| `cve_list_sources` | سرد جميع مصادر البيانات الـ 11 وتوافرها |
| `cve_report` | إنشاء تقرير ثغرات بتنسيق markdown |
---
## مصادر البيانات
| المصدر | المصادقة | ما يوفره |
|--------|----------|----------|
| [NVD](https://nvd.nist.gov/) | اختياري `NVD_API_KEY` | تفاصيل CVE، درجات CVSS، تعيينات CWE، منتجات CPE المتأثرة، المراجع |
| [EPSS](https://www.first.org/epss/) | لا شيء | درجة احتمالية الاستغلال (0-1) وترتيب المئين |
| [CISA KEV](https://www.cisa.gov/known-exploited-vulnerabilities-catalog) | لا شيء | الثغرات المُستغلّة المعروفة مع مواعيد المعالجة النهائية |
| [GitHub Advisory](https://github.com/advisories) | اختياري `GITHUB_TOKEN` | إرشادات أمان المصدر المفتوح، الحزم المتأثرة، الخطورة |
| [OSV](https://osv.dev/) | لا شيء | بيانات الثغرات على مستوى الحزم عبر 16+ نظام بيئي |
| [Shodan CVEDB](https://cvedb.shodan.io/) | لا شيء | استعلام CVE مع EPSS/KEV/CPE مدمج، فحص ثغرات IP |
| [VulnCheck](https://vulncheck.com/) | اختياري `VULNCHECK_API_KEY` | KEV موسّع (~80% إدخالات أكثر)، بحث ثغرات CPE/PURL |
| [Vulners](https://vulners.com/) | اختياري `VULNERS_API_KEY` | بحث الثغرات عبر 200+ مصدر، مراجع استغلال |
| [Nuclei Templates](https://github.com/projectdiscovery/nuclei-templates) | لا شيء | التحقق من وجود قالب كشف CVE (الخطورة، العلامات) |
| [Metasploit](https://github.com/rapid7/metasploit-framework) | لا شيء | التحقق من وجود وحدة استغلال (النوع، الرتبة، المسار) |
| [CIRCL](https://cve.circl.lu/) | لا شيء | إثراء CVE مع ربط CAPEC، مراجع بديلة، متجهات التأثير |
| [AttackerKB](https://attackerkb.com/) | اختياري `ATTACKERKB_API_KEY` | تقييمات المجتمع (قيمة المهاجم، تصنيفات قابلية الاستغلال) |
| [MITRE ATT&CK](https://attack.mitre.org/) | لا شيء | ربط CWE بتقنيات ATT&CK (التكتيكات، التقنيات) |
| [MITRE CWE](https://cwe-api.mitre.org/) | لا شيء | قاعدة بيانات CWE كاملة (1000+ نقطة ضعف، التسلسل الهرمي، التخفيفات) |
### صيغة درجة المخاطر
```
درجة المخاطر = CVSS Base Score × EPSS Score × مُضاعف KEV × مُضاعف الاستغلال
حيث:
CVSS Base Score = 0-10 (الخطورة من NVD)
EPSS Score = 0-1 (احتمالية الاستغلال من FIRST)
مُضاعف KEV = 2 إذا كان في CISA KEV، 1 خلاف ذلك
مُضاعف الاستغلال = 1.5 إذا كان قالب Nuclei أو وحدة Metasploit موجودة، 1 خلاف ذلك
```
هذا يعطي درجة مخاطر عملية توازن بين الخطورة (CVSS) واحتمالية الاستغلال في العالم الحقيقي (EPSS) والاستغلال النشط المعروف (KEV) وإشارات التسليح (أدوات استغلال عامة).
---
## البنية المعمارية
```
src/
├── index.ts نقطة الدخول + MCP stdio
├── types/
│ └── index.ts ToolDef، ToolContext، ToolResult، أنواع API
├── protocol/
│ ├── tools.ts 41 تعريف أداة (مخططات Zod)
│ └── mcp-server.ts خادم MCP + نقل stdio
├── nvd/
│ ├── index.ts NVD API v2 — بحث، جلب، حديثة
│ └── cpe.ts بحث المنتجات/CPE
├── epss/
│ └── index.ts EPSS — درجة، أعلى
├── kev/
│ └── index.ts KEV — تحقق، بحث، حديثة (مخزنة مؤقتاً)
├── ghsa/
│ └── index.ts GitHub Advisory — بحث، جلب
├── osv/
│ └── index.ts OSV — استعلام، جلب، دُفعي
├── exploit/
│ └── index.ts بحث PoC عبر مستودعات GitHub
├── shodan/
│ └── index.ts Shodan CVEDB + InternetDB (بدون مصادقة)
├── vulncheck/
│ └── index.ts VulnCheck KEV، CPE، PURL
├── vulners/
│ └── index.ts Vulners بحث + استعلام
├── nuclei/
│ └── index.ts التحقق من وجود قالب Nuclei
├── metasploit/
│ └── index.ts فحص وحدة MSF (بيانات وصفية مخزنة مؤقتاً)
├── cpe/
│ └── index.ts NVD CPE dictionary API
├── circl/
│ └── index.ts CIRCL إثراء CVE
├── attackerkb/
│ └── index.ts تقييمات AttackerKB
├── attack/
│ └── index.ts CWE → MITRE ATT&CK ربط
├── cwe/
│ └── index.ts CWE API (MITRE) + احتياطي ثابت
├── cvss/
│ └── index.ts CVSS v3.1 + v4.0 محلل + حاسبة
├── meta/
│ ├── enrich.ts إثراء CVE الكاملة (8 مصادر بالتوازي)
│ ├── prioritize.ts ترتيب CVE بناءً على المخاطر
│ ├── trending.ts CVE الرائجة حسب EPSS
│ ├── compare.ts مقارنة CVE جنباً إلى جنب
│ └── sources.ts فحص صحة 11 مصدر
└── utils/
├── rate-limiter.ts محدد المعدل القائم على الطابور
└── cache.ts ذاكرة تخزين مؤقتة TTL
```
**قرارات التصميم:**
- **استخبارات، ليس تدقيق** — على عكس [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) و [github-security-mcp](https://github.com/badchars/github-security-mcp)، هذه أداة بيانات. لا CheckResult، لا تراكم نتائج. كل استعلام مستقل وبدون حالة.
- **إثراء متوازي** — `cve_enrich` يستدعي 8 مصادر عبر `Promise.allSettled`. إذا كان مصدر واحد معطلاً، يستمر الباقي في إرجاع البيانات.
- **كشف التسليح** — يتحقق من وجود قوالب Nuclei ووحدات Metasploit للإشارة إلى CVE التي لديها أدوات استغلال عامة.
- **محدد معدل مشترك** — جميع وحدات NVD تتشارك نسخة واحدة من `RateLimiter` (6 ثوانٍ بين الطلبات) لتجنب أخطاء 429.
- **تخزين KEV + MSF مؤقتاً** — كتالوج KEV (~1200 إدخال) والبيانات الوصفية لوحدات MSF (~15 ميجابايت) تُحمّل مرة واحدة، تُخزّن مؤقتاً بفترة TTL ساعة واحدة.
- **CWE وضع مزدوج** — MITRE CWE REST API للتفاصيل الكاملة (1000+ CWE)، مع احتياطي ثابت (40+ إدخال) عندما لا يكون API متاحاً.
- **CVSS v3.1 + v4.0** — اكتشاف تلقائي للإصدار من بادئة المتجه. V4.0 يستخدم نهج تسجيل MacroVector.
- **ربط ATT&CK** — جدول ثابت CWE-إلى-تقنية (33 إدخال CWE → تقنيات ATT&CK). لا استدعاءات API.
- **تبعيتان** — `@modelcontextprotocol/sdk` و `zod`. لا شيء آخر.
---
## القيود
- NVD API بدون `NVD_API_KEY` محدود بـ 5 طلبات كل 30 ثانية. عيّن المفتاح للاستخدام الإنتاجي
- بحث GitHub Advisory بدون `GITHUB_TOKEN` محدود بـ 60 طلباً في الساعة
- VulnCheck و Vulners و AttackerKB تتطلب مفاتيح API للوظائف الكاملة
- بحث الاستغلالات يستخدم بحث مستودعات GitHub الذي له حدود معدل خاصة به
- البيانات الوصفية لوحدات MSF (~15 ميجابايت) تُحمّل عند الاستخدام الأول — أول استدعاء لـ `msf_check` أبطأ
- تسجيل CVSS v4.0 يستخدم تقريب MacroVector (المواصفات الدقيقة معقدة جداً)
- ربط ATT&CK يغطي 33 إدخال CWE — CWE غير الشائعة قد لا تُربط
- macOS / Linux (لم يُختبر على Windows)
---
## جزء من MCP Security Suite
| المشروع | المجال | الأدوات |
|---------|--------|---------|
| [hackbrowser-mcp](https://github.com/badchars/hackbrowser-mcp) | اختبار الأمان عبر المتصفح | 39 أداة، Firefox، اختبار الحقن |
| [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) | أمان السحابة (AWS/Azure/GCP) | 38 أداة، 60+ فحص |
| [github-security-mcp](https://github.com/badchars/github-security-mcp) | الوضع الأمني لـ GitHub | 39 أداة، 45 فحص |
| **cve-mcp** | استخبارات الثغرات | 41 أداة، 11 مصدر |
---
للاختبار والتقييم الأمني المصرّح به فقط.
تأكد دائماً من حصولك على التفويض المناسب قبل اختبار الأنظمة.
