CVE i obavještajne informacije o ranjivostima za AI agente.

NVD, EPSS, CISA KEV, GitHub Advisory, OSV, Shodan, VulnCheck, Vulners, Nuclei, Metasploit, CIRCL, AttackerKB i MITRE ATT&CK — objedinjeni u jednom MCP serveru.
Vaš AI agent dobija obavještajne informacije o ranjivostima na zahtjev, a ne izvještaj od 200 stranica.

Problem • Po čemu se razlikuje • Brzi početak • Šta AI agent može • Alati • Izvori podataka • Arhitektura

--- ## Problem Obavještajne informacije o ranjivostima su raspršene po više baza podataka. NVD sadrži detalje o CVE. EPSS vam govori vjerovatnoću eksploatacije. CISA KEV prati aktivno eksploatisane ranjivosti. GitHub Advisory pokriva pakete otvorenog koda. OSV mapira ranjivosti na specifične verzije paketa. Shodan prati izloženost na internetu. Nuclei i Metasploit vam govore postoji li radni eksploit. Nijedan alat ih ne objedinjuje, i nijedan ne radi sa AI agentima. ``` Tradicionalni radni tok: pretraži NVD za detalje o CVE → navigiraj kroz nezgrapan web UI provjeri EPSS za rizik eksploatacije → zasebno API, zaseban format provjeri status CISA KEV → preuzmi JSON feed ručno pretraži GitHub advisories → još jedan interfejs upitaj OSV za utjecaj na pakete → drugačije API, drugačija shema provjeri Shodan za izloženost → zasebna pretplata traži Nuclei/MSF eksploite → ručno pretraživanje na GitHub mapiraj na ATT&CK tehnike → zaseban MITRE upit koreliraj sve → kopiraj-zalijepi u tabelu ────────────────────────────────── Ukupno: 30+ minuta po CVE, duže za masovnu triažu ``` **cve-mcp** daje vašem AI agentu 41 alat putem [Model Context Protocol](https://modelcontextprotocol.io). Agent upituje 11 izvora paralelno, korelira podatke, detektuje signale naoružavanja, izračunava ocjene rizika i govori vam tačno šta je bitno. ``` Sa cve-mcp: Vi: "Prioritiziraj ovih 10 CVE prema stvarnom riziku eksploatacije" Agent: → preuzima CVSS ocjene iz NVD → dobija EPSS vjerovatnoću eksploatacije za svaki → provjerava CISA KEV za aktivno eksploatisane → unakrsno provjerava GitHub advisories za zakrpe → "3 su kritična: CVE-2024-3400 (EPSS 97%, u KEV), CVE-2023-44487 (HTTP/2 rapid reset, EPSS 96%), CVE-2021-44228 (Log4Shell, EPSS 97%, u KEV). Evo zakrpa i pogođenih verzija..." ``` --- ## Po čemu se razlikuje Postojeći alati vam daju sirove podatke. cve-mcp daje vašem AI agentu sposobnost da rezonuje o ranjivostima.

	Tradicionalni alati	cve-mcp
Interfejs	Web UI / CLI / sirovi API pozivi	MCP — AI agent poziva alate konverzacijski
Izvori podataka	Jedna baza podataka istovremeno	11 izvora paralelno: NVD, EPSS, KEV, GHSA, OSV, Shodan, VulnCheck, Vulners, Nuclei, Metasploit, CIRCL
Ocjena rizika	Samo CVSS (ozbiljnost, ne eksploatabilnost)	CVSS × EPSS × KEV × multiplikator eksploita (Nuclei/MSF) = stvarni rizik
Korelacija	Ručno kopiraj-zalijepi	Agent obogaćuje: "CVSS 9.8, EPSS 97%, KEV, Nuclei šablon postoji, MSF modul dostupan, mapira se na T1190"
Masovna trijaža	Jedan CVE istovremeno	Agent prioritizira 50 CVE u jednom razgovoru
Utjecaj na pakete	Zasebno OSV/GHSA pretraživanje	Agent automatski pronalazi pogođene pakete + verzije
Zavisnosti	Teški CLI alati, Python okruženja	2 runtime zavisnosti, pokreće se sa npx

--- ## Brzi početak ### Opcija 1: npx (bez instalacije) ```bash npx cve-mcp ``` ### Opcija 2: Kloniranje ```bash git clone https://github.com/badchars/cve-mcp.git cd cve-mcp bun install ``` ### Varijable okruženja (opcionalno) ```bash # Povećava NVD ograničenje brzine sa 5 na 50 zahtjeva po 30 sekundi export NVD_API_KEY=vaš-nvd-api-ključ # Omogućava GitHub Advisory pretragu (60 → 5000 zahtjeva/sat) export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # VulnCheck prošireni KEV, CPE, PURL pretraga export VULNCHECK_API_KEY=vaš-vulncheck-ključ # Vulners pretraga ranjivosti po 200+ izvora export VULNERS_API_KEY=vaš-vulners-ključ # AttackerKB procjene zajednice export ATTACKERKB_API_KEY=vaš-attackerkb-ključ ``` Svi su opcionalni. Server radi bez njih — neki alati samo imaju niža ograničenja brzine ili smanjene podatke. ### Povežite sa vašim AI agentom

Claude Code

```bash # Sa npx claude mcp add cve-mcp -- npx cve-mcp # Sa lokalnim klonom claude mcp add cve-mcp -- bun run /putanja/do/cve-mcp/src/index.ts ```

Claude Desktop

Dodajte u `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "cve-mcp": { "command": "npx", "args": ["cve-mcp"], "env": { "NVD_API_KEY": "opcionalni-ključ", "GITHUB_TOKEN": "opcionalni-token", "VULNCHECK_API_KEY": "opcionalni-ključ", "VULNERS_API_KEY": "opcionalni-ključ", "ATTACKERKB_API_KEY": "opcionalni-ključ" } } } } ```

Cursor / Windsurf / drugi MCP klijenti

Isti JSON format konfiguracije. Usmjerite komandu na `npx cve-mcp` ili vašu putanju instalacije.

### Počnite sa upitima ``` Vi: "Šta znaš o CVE-2024-3400?" ``` To je to. Agent se brine za ostalo. --- ## Šta AI agent može ### Odgovor na incident ``` Vi: "Pogodio nas je CVE-2024-3400. Daj mi sve." Agent: → cve_enrich {cveId: "CVE-2024-3400"} → NVD: PAN-OS command injection, CVSS 10.0 → EPSS: 97.2% vjerovatnoća eksploatacije → KEV: Dodano 2024-04-12, rok 2024-05-01 → Shodan: 4 CPE, izložen na internetu → Nuclei: Šablon za detekciju postoji (critical) → Metasploit: Modul eksploita dostupan (excellent rank) → "Kritično. Naoružano — i Nuclei i MSF moduli postoje. PAN-OS GlobalProtect, verzije < 10.2.9-h1. Zakrpite odmah. CISA rok: 1. maj." ``` ### Prioritizacija ranjivosti ``` Vi: "Prioritiziraj ove CVE iz našeg skena: CVE-2021-44228, CVE-2024-3400, CVE-2023-44487, CVE-2024-21762, CVE-2023-4966" Agent: → cve_prioritize {cves: [...]} → Rangira po CVSS × EPSS × KEV multiplikator → "#1: CVE-2024-3400 (rizik: 19.44, CVSS 10.0, EPSS 97%, KEV) #2: CVE-2021-44228 (rizik: 19.40, CVSS 10.0, EPSS 97%, KEV) #3: CVE-2023-4966 (rizik: 19.10, CVSS 9.4, EPSS 97%, KEV) Svih 5 su u CISA KEV — zakrpite sve odmah." ``` ### Revizija zavisnosti ``` Vi: "Provjeri da li lodash 4.17.20 i django 3.2.0 imaju poznate ranjivosti" Agent: → osv_batch {queries: [ {package: "lodash", version: "4.17.20", ecosystem: "npm"}, {package: "django", version: "3.2.0", ecosystem: "PyPI"} ]} → "lodash 4.17.20: 3 ranjivosti (prototype pollution) django 3.2.0: 12 ranjivosti (SQL injection, XSS) Nadogradite lodash na 4.17.21+, django na 4.2+" ``` ### Praćenje prijetnji ``` Vi: "Koji CVE imaju trenutno najveću vjerovatnoću eksploatacije?" Agent: → cve_trending {limit: 10, minEpss: 0.9} → "Top 10 po vjerovatnoći eksploatacije: 1. CVE-2024-3400 — PAN-OS (EPSS 97.2%, CVSS 10.0, KEV) 2. CVE-2023-44487 — HTTP/2 Rapid Reset (EPSS 96.5%, CVSS 7.5, KEV) ..." ``` ### Dubinska analiza CVSS (v3.1 i v4.0) ``` Vi: "Raščlani ovaj CVSS v4.0 vektor: 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" Agent: → 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 — Ocjena: 9.3 (KRITIČNO) Mrežni napad, niska složenost, bez zahtjeva za napad. Bez privilegija, bez interakcije korisnika. Ranjivi sistem: puni C/I/A utjecaj. Naknadni sistemi: bez utjecaja." ``` ### ATT&CK mapiranje ``` Vi: "Mapiraj CVE-2024-3400 na MITRE ATT&CK tehnike" Agent: → cve_to_attack {cweIds: ["CWE-77"]} → "CWE-77 (Command Injection) mapira se na: T1059 — Command and Scripting Interpreter (Execution) T1190 — Exploit Public-Facing Application (Initial Access)" ``` --- ## Referenca alata (41 alat)

NVD (4)

| Alat | Opis | |------|------| | `nvd_search` | Pretraži CVE po ključnoj riječi, ozbiljnosti, CWE, rasponu datuma | | `nvd_get` | Preuzmi pune detalje CVE (CVSS, CWE, CPE, reference) | | `nvd_recent` | Nedavno objavljeni/izmijenjeni CVE | | `cve_by_product` | Pretraži CVE po nazivu proizvoda (CPE podudaranje ključnih riječi) |

EPSS (2)

| Alat | Opis | |------|------| | `epss_score` | EPSS vjerovatnoća eksploatacije za jedan ili više CVE | | `epss_top` | Vrh CVE po vjerovatnoći eksploatacije |

KEV (3)

| Alat | Opis | |------|------| | `kev_check` | Provjeri da li su CVE u katalogu CISA Known Exploited Vulnerabilities | | `kev_search` | Pretraži KEV po proizvođaču, proizvodu ili ključnoj riječi | | `kev_recent` | Nedavno dodani KEV unosi |

GHSA (2)

| Alat | Opis | |------|------| | `ghsa_search` | Pretraži GitHub sigurnosne savjete po ključnoj riječi, ekosistemu, ozbiljnosti | | `ghsa_get` | Preuzmi detalje savjeta po GHSA ID ili CVE ID |

OSV (3)

| Alat | Opis | |------|------| | `osv_query` | Upitaj ranjivosti za specifičnu verziju paketa | | `osv_get` | Preuzmi detalje ranjivosti po OSV/GHSA/CVE ID | | `osv_batch` | Grupni upit za više paketa odjednom |

Exploit (1)

| Alat | Opis | |------|------| | `exploit_search` | Pretraži javne PoC eksploite (GitHub repozitoriji) |

Shodan (3)

| Alat | Opis | |------|------| | `shodan_cve` | CVE upit putem Shodan CVEDB (EPSS, KEV, CPE integrisano, bez autentifikacije) | | `shodan_product` | Pronađi CVE po imenu proizvoda/proizvođača putem Shodan | | `shodan_ip_vulns` | Preuzmi poznate ranjivosti za IP adresu (InternetDB) |

VulnCheck (3)

| Alat | Opis | |------|------| | `vulncheck_kev` | Prošireni KEV katalog (~80% više unosa od CISA) | | `vulncheck_cpe` | CVE pretraga po CPE stringu | | `vulncheck_purl` | CVE pretraga po Package URL (purl) |

Vulners (2)

| Alat | Opis | |------|------| | `vulners_lookup` | CVE detalji iz Vulners (200+ izvora, reference na eksploite) | | `vulners_search` | Pretraga ranjivosti po punom tekstu kroz Vulners bazu podataka |

Nuclei & Metasploit (2)

| Alat | Opis | |------|------| | `nuclei_check` | Provjeri da li postoji Nuclei šablon za detekciju CVE | | `msf_check` | Provjeri da li postoji Metasploit modul eksploita za CVE |

CPE (2)

| Alat | Opis | |------|------| | `cpe_search` | Pretraži NVD CPE rječnik po ključnoj riječi | | `cpe_match` | Preuzmi CPE podudaranja za specifičan CVE |

CIRCL (1)

| Alat | Opis | |------|------| | `circl_cve` | CIRCL CVE obogaćenje (CAPEC mapiranje, alternativne reference, vektori utjecaja) |

AttackerKB (1)

| Alat | Opis | |------|------| | `attackerkb_assess` | Procjene zajednice iz AttackerKB (vrijednost za napadača, eksploatabilnost) |

ATT&CK (1)

| Alat | Opis | |------|------| | `cve_to_attack` | Mapiraj CVE CWE ID-ove na MITRE ATT&CK tehnike i taktike |

CWE (4)

| Alat | Opis | |------|------| | `cwe_lookup` | Potraži CWE slabost po ID-u ili pretraži po ključnoj riječi (statička baza) | | `cwe_get` | Puni CWE detalji iz MITRE API (1000+ CWE, mjere, primjeri) | | `cwe_hierarchy` | CWE hijerarhija roditelj/dijete iz MITRE API | | `cwe_top25` | MITRE CWE Top 25 Most Dangerous Software Weaknesses |

CVSS (1)

| Alat | Opis | |------|------| | `cvss_parse` | Parsiraj i objasni CVSS v3.1 ili v4.0 vektor sa izračunom ocjene |

Meta (6)

| Alat | Opis | |------|------| | `cve_enrich` | Potpuno obogaćenje: NVD + EPSS + KEV + GHSA + OSV + Shodan + Nuclei + MSF paralelno | | `cve_prioritize` | Rangiraj CVE po riziku (CVSS × EPSS × KEV × multiplikator eksploita) | | `cve_trending` | Trenutno u trendu CVE po vjerovatnoći eksploatacije | | `cve_compare` | Uporedni prikaz dva CVE | | `cve_list_sources` | Izlistaj svih 11 izvora podataka i njihovu dostupnost | | `cve_report` | Generiši markdown izvještaj o ranjivostima |

--- ## Izvori podataka | Izvor | Autentifikacija | Šta pruža | |-------|-----------------|-----------| | [NVD](https://nvd.nist.gov/) | Opcionalni `NVD_API_KEY` | Detalji CVE, CVSS ocjene, CWE mapiranja, CPE pogođeni proizvodi, reference | | [EPSS](https://www.first.org/epss/) | Ništa | Ocjena vjerovatnoće eksploatacije (0-1) i percentilni rang | | [CISA KEV](https://www.cisa.gov/known-exploited-vulnerabilities-catalog) | Ništa | Poznate eksploatisane ranjivosti sa rokovima za sanaciju | | [GitHub Advisory](https://github.com/advisories) | Opcionalni `GITHUB_TOKEN` | Sigurnosni savjeti za otvoreni kod, pogođeni paketi, ozbiljnost | | [OSV](https://osv.dev/) | Ništa | Podaci o ranjivostima na nivou paketa u 16+ ekosistema | | [Shodan CVEDB](https://cvedb.shodan.io/) | Ništa | CVE upit sa integrisanim EPSS/KEV/CPE, skeniranje ranjivosti IP-a | | [VulnCheck](https://vulncheck.com/) | Opcionalni `VULNCHECK_API_KEY` | Prošireni KEV (~80% više unosa), CPE/PURL pretraga ranjivosti | | [Vulners](https://vulners.com/) | Opcionalni `VULNERS_API_KEY` | Pretraga ranjivosti po 200+ izvora, reference na eksploite | | [Nuclei Templates](https://github.com/projectdiscovery/nuclei-templates) | Ništa | Provjera postojanja šablona za detekciju CVE (ozbiljnost, tagovi) | | [Metasploit](https://github.com/rapid7/metasploit-framework) | Ništa | Provjera postojanja modula eksploita (tip, rang, putanja) | | [CIRCL](https://cve.circl.lu/) | Ništa | CVE obogaćenje sa CAPEC mapiranjem, alternativne reference, vektori utjecaja | | [AttackerKB](https://attackerkb.com/) | Opcionalni `ATTACKERKB_API_KEY` | Procjene zajednice (vrijednost za napadača, ocjene eksploatabilnosti) | | [MITRE ATT&CK](https://attack.mitre.org/) | Ništa | CWE-u-ATT&CK mapiranje tehnika (taktike, tehnike) | | [MITRE CWE](https://cwe-api.mitre.org/) | Ništa | Puna CWE baza podataka (1000+ slabosti, hijerarhija, mjere) | ### Formula ocjene rizika ``` Ocjena rizika = CVSS Base Score × EPSS Score × KEV Multiplikator × Multiplikator eksploita Gdje: CVSS Base Score = 0-10 (ozbiljnost iz NVD) EPSS Score = 0-1 (vjerovatnoća eksploatacije iz FIRST) KEV Multiplikator = 2 ako je u CISA KEV, 1 inače Multiplikator eksploita = 1.5 ako postoji Nuclei šablon ILI Metasploit modul, 1 inače ``` Ovo daje praktičnu ocjenu rizika koja balansira ozbiljnost (CVSS) sa vjerovatnoćom eksploatacije u stvarnom svijetu (EPSS), poznatom aktivnom eksploatacijom (KEV) i signalima naoružavanja (javni alati za eksploataciju). --- ## Arhitektura ``` src/ ├── index.ts Ulazna tačka + MCP stdio ├── types/ │ └── index.ts ToolDef, ToolContext, ToolResult, API tipovi ├── protocol/ │ ├── tools.ts 41 definicija alata (Zod sheme) │ └── mcp-server.ts MCP server + stdio transport ├── nvd/ │ ├── index.ts NVD API v2 — pretraga, preuzimanje, nedavni │ └── cpe.ts Pretraga proizvoda/CPE ├── epss/ │ └── index.ts EPSS — ocjena, vrh ├── kev/ │ └── index.ts KEV — provjera, pretraga, nedavni (keširan) ├── ghsa/ │ └── index.ts GitHub Advisory — pretraga, preuzimanje ├── osv/ │ └── index.ts OSV — upit, preuzimanje, grupni ├── exploit/ │ └── index.ts PoC pretraga putem GitHub repozitorija ├── shodan/ │ └── index.ts Shodan CVEDB + InternetDB (bez autentifikacije) ├── vulncheck/ │ └── index.ts VulnCheck KEV, CPE, PURL ├── vulners/ │ └── index.ts Vulners pretraga + upit ├── nuclei/ │ └── index.ts Provjera postojanja Nuclei šablona ├── metasploit/ │ └── index.ts Provjera MSF modula (keširani metapodaci) ├── cpe/ │ └── index.ts NVD CPE dictionary API ├── circl/ │ └── index.ts CIRCL CVE obogaćenje ├── attackerkb/ │ └── index.ts AttackerKB procjene ├── attack/ │ └── index.ts CWE → MITRE ATT&CK mapiranje ├── cwe/ │ └── index.ts CWE API (MITRE) + statički fallback ├── cvss/ │ └── index.ts CVSS v3.1 + v4.0 parser + kalkulator ├── meta/ │ ├── enrich.ts Potpuno obogaćenje CVE (8 izvora paralelno) │ ├── prioritize.ts Rangiranje CVE zasnovano na riziku │ ├── trending.ts CVE u trendu po EPSS │ ├── compare.ts Uporedni prikaz CVE │ └── sources.ts Provjera zdravlja 11 izvora └── utils/ ├── rate-limiter.ts Red-bazirani rate limiter └── cache.ts TTL keš ``` **Projektne odluke:** - **Obavještajne informacije, ne revizija** — Za razliku od [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) i [github-security-mcp](https://github.com/badchars/github-security-mcp), ovo je alat za podatke. Nema CheckResult, nema akumulacije nalaza. Svaki upit je nezavisan i bez stanja. - **Paralelno obogaćenje** — `cve_enrich` poziva 8 izvora putem `Promise.allSettled`. Ako je jedan izvor nedostupan, ostali i dalje vraćaju podatke. - **Detekcija naoružavanja** — Provjerava postojanje Nuclei šablona i Metasploit modula da označi CVE sa javnim alatima za eksploataciju. - **Dijeljeni rate limiter** — Svi NVD moduli dijele jednu instancu `RateLimiter` (6s između zahtjeva) da izbjegnu 429 greške. - **KEV + MSF keširanje** — KEV katalog (~1200 unosa) i MSF metapodaci modula (~15MB) učitavaju se jednom, keširaju sa TTL od 1 sata. - **CWE dvojni režim** — MITRE CWE REST API za pune detalje (1000+ CWE), sa statičkim fallback-om (40+ unosa) kada API nije dostupan. - **CVSS v3.1 + v4.0** — Automatska detekcija verzije po prefiksu vektora. V4.0 koristi MacroVector pristup ocjenjivanju. - **ATT&CK mapiranje** — Statička CWE-u-tehniku tabela (33 CWE unosa → ATT&CK tehnike). Bez API poziva. - **2 zavisnosti** — `@modelcontextprotocol/sdk` i `zod`. Ništa drugo. --- ## Ograničenja - NVD API bez `NVD_API_KEY` je ograničen na 5 zahtjeva po 30 sekundi. Postavite ključ za produkcijsku upotrebu - GitHub Advisory pretraga bez `GITHUB_TOKEN` je ograničena na 60 zahtjeva po satu - VulnCheck, Vulners i AttackerKB zahtijevaju API ključeve za punu funkcionalnost - Pretraga eksploita koristi GitHub pretragu repozitorija koja ima svoja ograničenja brzine - MSF metapodaci modula (~15MB) se učitavaju pri prvoj upotrebi — prvi poziv `msf_check` je sporiji - CVSS v4.0 ocjenjivanje koristi MacroVector aproksimaciju (tačna specifikacija je veoma složena) - ATT&CK mapiranje pokriva 33 CWE unosa — neuobičajeni CWE se možda neće mapirati - macOS / Linux (Windows nije testiran) --- ## Dio MCP Security Suite | Projekat | Domena | Alati | |----------|--------|-------| | [hackbrowser-mcp](https://github.com/badchars/hackbrowser-mcp) | Sigurnosno testiranje zasnovano na pretraživaču | 39 alata, Firefox, testiranje injekcija | | [cloud-audit-mcp](https://github.com/badchars/cloud-audit-mcp) | Sigurnost oblaka (AWS/Azure/GCP) | 38 alata, 60+ provjera | | [github-security-mcp](https://github.com/badchars/github-security-mcp) | GitHub sigurnosni stav | 39 alata, 45 provjera | | **cve-mcp** | Obavještajne informacije o ranjivostima | 41 alat, 11 izvora | ---

Samo za autorizirano sigurnosno testiranje i procjenu.
Uvijek se uvjerite da imate odgovarajuću autorizaciju prije testiranja sistema.

MIT licenca • Izgrađeno sa Bun + TypeScript