🛡️ CVE MCP Server

Интеллект безопасности на основе ИИ у вас под рукой — 28 инструментов + однострочный оркестратор triage_cve, 24 источника данных, один протокол.

Производственный сервер Model Context Protocol (MCP), который превращает Claude в всезнающего аналитика по безопасности. Вместо того чтобы переключаться между 15+ вкладками браузера с NVD, EPSS, CISA KEV, Shodan, VirusTotal и GreyNoise, задайте Claude один вопрос и получите коррелированную информацию за секунды. Создан на Python, FastMCP, httpx, aiosqlite, Pydantic v2 и defusedxml.

Проблема: Триаж одной CVE означает запрос CVSS-оценок в NVD, вероятности эксплуатации в EPSS, статуса активной эксплуатации в CISA KEV, патчей на GitHub и связей с вредоносным ПО в VirusTotal — а затем мысленная корреляция всей информации. Для 50 CVE это целый потерянный день.

Решение: CVE MCP Server дает Claude прямой доступ к 28 инструментам безопасности через 24 API — с оркестратором triage_cve для одного вызова. Спросите «Нужно ли нам исправлять CVE-2024-3400?», и Claude параллельно обратится ко всем релевантным источникам, рассчитает комплексную оценку риска (с жестким приоритетом CISA KEV) и выдаст приоритизированную рекомендацию с доказательствами.

🌍 GARS-2026 — Глобальное исследование готовности к агентному ИИ

Я провожу глобальное академическое исследование, измеряющее реальную готовность специалистов по безопасности, разработчиков и корпоративных команд к агентному ИИ — MCP-серверам, вызовам инструментов, управлению и рабочим процессам с участием человека.

Если вы используете этот репозиторий, ваш ответ станет действительно ценным точка данных.

📋 Пройдите опрос (10 минут): Опрос

• 60 вопросов · Анонимный · Кураторство SRH Berlin
• Вы получите 50 Casky Tokens для раннего доступа к casky.ai
• Результаты будут опубликованы в открытом доступе по лицензии CC-BY 4.0

📑 Содержание

• Архитектура
• Каталог инструментов
• Установка
• Настройка ключей API
• Конфигурация
• Быстрый старт
• Примеры использования
• Пояснение к оценке риска
• Источники данных
• Запуск тестов
• Детали архитектуры
• Безопасность и конфиденциальность
• Устранение неполадок
• Дорожная карта и известные ограничения
• Участие в разработке
• Лицензия

🏗️ Архитектура

┌─────────────────────────────────────────────────────────────────────┐
│                        Claude Desktop / Claude Code                 │
│                         (MCP Client via stdio)                      │
└──────────────────────────────┬──────────────────────────────────────┘
                               │ Model Context Protocol (stdio)
                               ▼
┌─────────────────────────────────────────────────────────────────────┐
│                        CVE MCP Server (Python)                      │
│  ┌─────────────┐  ┌──────────────┐  ┌───────────────┐              │
│  │  27 MCP      │  │  Composite   │  │  SQLite Cache │              │
│  │  Tools       │  │  Risk Engine │  │  + Audit Log  │              │
│  └──────┬──────┘  └──────┬───────┘  └───────┬───────┘              │
│         │                │                   │                      │
│  ┌──────┴────────────────┴───────────────────┴──────┐               │
│  │              Async HTTP Client (httpx)            │               │
│  │         Rate Limiter · Response Cache             │               │
│  └──────────────────────┬───────────────────────────┘               │
└─────────────────────────┼───────────────────────────────────────────┘
                          │ HTTPS (только исходящий трафик)
          ┌───────────────┼───────────────────────────┐
          ▼               ▼                           ▼
┌──────────────┐ ┌──────────────┐            ┌──────────────┐
│ VULNERABILITY│ │   NETWORK    │            │   THREAT     │
│ INTELLIGENCE │ │ INTELLIGENCE │            │ INTELLIGENCE │
├──────────────┤ ├──────────────┤            ├──────────────┤
│ NVD API 2.0  │ │ AbuseIPDB    │            │ VirusTotal   │
│ EPSS / FIRST │ │ GreyNoise v3 │            │ MalwareBazaar│
│ CISA KEV     │ │ Shodan       │            │ ThreatFox    │
│ OSV.dev      │ │ CIRCL PDNS   │            │ Ransomwhere  │
│ GitHub GHSA  │ │              │            │ AlienVault   │
│ MITRE ATT&CK │ │              │            │ URLScan.io   │
└──────────────┘ └──────────────┘            └──────────────┘

Весь трафик является только исходящим HTTPS — входящие порты не открываются. Ключи API загружаются из переменных окружения и никогда не логируются. Частные/внутренние IP-адреса заблокированы во всех инструментах поиска.

🔍 Каталог инструментов (28 инструментов)

⭐ Оркестрация (v0.2.0) — начните здесь

Также доступен через примитивы MCP — Ресурсы: kev://catalog, epss://scores/{cve_id}, manifest://tool-hash (SHA-256 от поверхности зарегистрированных инструментов для обнаружения подделки). Промпты: patch_decision, compare_and_prioritize, dependency_triage.

Основной интеллект по уязвимостям (8 инструментов)

Этап 3: Расширенный анализ рисков и отчетность (4 инструмента)

Сетевая разведка (4 инструмента)

Угрозы и разведка (4 инструмента)

DevSecOps (3 инструмента)

📦 Установка

Предварительные требования

• Python 3.10+ (рекомендуются 3.11 или 3.12)
• Менеджер пакетов pip или uv
• Git для клонирования репозитория
• Терминал с доступом к переменным окружения

Пошаговая настройка

# 1. Клонируйте репозиторий
git clone https://github.com/mukul975/cve-mcp-server.git
cd cve-mcp-server

# 2. Создайте и активируйте виртуальное окружение
python -m venv venv

# macOS / Linux:
source venv/bin/activate

# Windows (PowerShell):
.\venv\Scripts\Activate.ps1

# Windows (CMD):
venv\Scripts\activate.bat

# 3. Установите зависимости
pip install -e .

# 4. Скопируйте и настройте переменные окружения
cp .env.example .env
# Отредактируйте .env с вашими ключами API (см. раздел "Настройка ключей API" ниже)

# 5. Проверьте запуск сервера
python -m cve_mcp.server

Использование uv (более быстрая альтернатива)

git clone https://github.com/mukul975/cve-mcp-server.git
cd cve-mcp-server
uv venv
source .venv/bin/activate  # или .venv\Scripts\activate в Windows
uv pip install -e .
cp .env.example .env

С тестовыми зависимостями

pip install -e ".[test]"

🔑 Настройка ключей API

Ключи API организованы по приоритету — сначала получите ключи Уровня 1 для максимального покрытия бесплатными инструментами, затем постепенно добавляйте ключи Уровня 2 и Уровня 3 по мере необходимости.

Уровень 1: Высокий приоритет (бесплатно, мгновенный доступ, максимальное покрытие)

Уровень 2: Рекомендуемые (бесплатные аккаунты, значительная ценность)

Уровень 3: Необязательные (расширенная разведка)

⚡ Начало без ключей: Восемь инструментов работают без каких-либо ключей API — EPSS, CISA KEV, OSV.dev, MITRE ATT&CK, поиск CWE, парсинг CVSS, Ransomwhere и NVD (со сниженным рейтингом запросов). Вы можете начать использовать сервер сразу и добавлять ключи постепенно.

⚙️ Конфигурация

Переменные окружения (.env.example)

# Ключ API NVD — бесплатно на https://nvd.nist.gov/developers/request-an-api-key
# Без ключа: 5 запросов/30 сек  |  С ключом: 50 запросов/30 сек
NVD_API_KEY=


# Токен GitHub — увеличивает лимит запросов с 60/час до 5000/час (scope не требуются)
GITHUB_TOKEN=

# Ключи для разведки угроз (все необязательные — инструменты работают и без них, но с ограниченным функционалом)
ABUSEIPDB_KEY=       # https://www.abuseipdb.com/account/api
VIRUSTOTAL_KEY=      # https://www.virustotal.com/gui/join-us
URLSCAN_KEY=         # https://urlscan.io/user/signup
SHODAN_KEY=          # https://account.shodan.io/register

# GreyNoise — использует эндпоинт /v3/ip/{ip} (НЕ устаревший /v3/community)
GREYNOISE_API_KEY=   # https://viz.greynoise.io/signup

# Пассивный DNS CIRCL — требует партнёрской регистрации
CIRCL_PDNS_USER=
CIRCL_PDNS_PASS=

# Необязательные переопределения
CACHE_DB_PATH=       # по умолчанию ~/.cve-mcp/cache.db
AUDIT_LOG_PATH=      # по умолчанию ~/.cve-mcp/audit.log
REQUEST_TIMEOUT=30   # Тайм-аут HTTP-запроса в секундах
MAX_RETRIES=3        # Повторы при временных ошибках

Конфигурация Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cve-mcp": {
      "command": "python",
      "args": ["-m", "cve_mcp.server"],
      "cwd": "/absolute/path/to/cve-mcp-server",
      "env": {
        "NVD_API_KEY": "your-key-here",
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx",
        "ABUSEIPDB_KEY": "your-abuseipdb-key",
        "GREYNOISE_API_KEY": "your-greynoise-key",
        "SHODAN_KEY": "your-shodan-key"
      }
    }
  }
}

⚠️ Важно: Всегда используйте абсолютные пути. После изменения конфигурации полностью завершите работу Claude Desktop (Cmd+Q / Alt+F4) — простой перезагрузки недостаточно.

Конфигурация Claude Code

# Базовая настройка
claude mcp add cve-mcp -- python -m cve_mcp.server

# С переменными окружения (повторите -e для каждого ключа)
claude mcp add cve-mcp -e NVD_API_KEY=your_key -e VULNCHECK_TOKEN=your_token -- python -m cve_mcp.server
# Или просто запустите из каталога проекта — python-dotenv автоматически загружает .env при старте

# Проверьте подключение
claude mcp list

🚀 Быстрый старт

Шаг 1: Установка (2 минуты)

git clone https://github.com/mukul975/cve-mcp-server.git
cd cve-mcp-server
python -m venv venv && source venv/bin/activate
pip install -e .

Шаг 2: Тестирование бесплатными инструментами

Файл .env не нужен. Добавьте сервер в Claude Desktop или Claude Code и попробуйте:

«Что такое CVE-2021-44228? Активно ли он используется?»

Claude использует lookup_cve (NVD), get_epss_score (EPSS) и check_kev (CISA KEV) — все бесплатно, ключи не требуются.

«Проверь эти Python-пакеты на наличие уязвимостей: requests 2.28.0, flask 2.2.0, django 3.2.0»

Шаг 3: Добавьте первый ключ для 10× производительности

echo 'NVD_API_KEY=your-key-here' > .env

Запросите бесплатный ключ NVD на nvd.nist.gov — мгновенно по электронной почте, увеличивает лимит запросов с 5 до 50 за 30 секунд.

Шаг 4: Полная мощность

Как только вы добавите ключи Уровня 1 и Уровня 2:

«Рассчитай оценку риска для CVE-2024-3400 и скажи, нужно ли нам исправлять его немедленно.»

💬 Примеры использования

Сценарий 1: «Нужно ли нам немедленно исправлять Log4Shell?»

Вы: Проанализируй, требует ли CVE-2021-44228 (Log4Shell) немедленного исправления. Дай мне оценку риска и свою рекомендацию.

Claude координирует несколько инструментов за кулисами:

→ lookup_cve("CVE-2021-44228")
  CVSS 3.1: 10.0 (CRITICAL) | AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H

→ get_epss_score("CVE-2021-44228")
  EPSS: 0.97531 (97.5%) | Percentile: 99.99%

→ check_kev("CVE-2021-44228")
  ✅ В CISA KEV — Добавлено 2021-12-10 | Известное использование вransomware: Да

→ check_poc_exists("CVE-2021-44228")
  ✅ ОРУЖИЕНО — Найдено 300+ публичных репозиториев PoC

→ calculate_risk_score("CVE-2021-44228")
  Оценка риска: 97/100 (CRITICAL) | Срочность: ИСПРАВИТЬ НЕМЕДЛЕННО

Ответ Claude: «CVE-2021-44228 получает оценку 97/100 (CRITICAL). Удаленное выполнение кода в Apache Log4j, CVSS 10.0, 97.5% вероятность по EPSS, подтвержденная активная эксплуатация в CISA KEV, включая кампанииransomware, 300+ публичных эксплойтов. Исправляйте немедленно.»

Сценарий 2: «Проверь мой requirements.txt»

Вы: Проверь эти зависимости: requests==2.28.0, flask==2.2.0, django==3.2.0, pillow==9.0.0, cryptography==37.0.0

→ scan_dependencies(ecosystem="PyPI", packages={...})
  Найдено 12 уязвимостей в 4 пакетах

Ответ Claude: «Найдено 12 уязвимостей в ваших пакетах. Немедленные действия: Django 3.2.0 (3 критических CVE, включая SQL-инъекции), Pillow 9.0.0 (переполнение кучи), cryptography 37.0.0 (цепочка OpenSSL). Обновите до: django>=4.2.16, pillow>=10.3.0, cryptography>=42.0.0.»

Сценарий 3: «Расследуй подозрительный IP»

Вы: Расследуй подозрительный IP 185.220.101.34 — вредоносный ли он?

→ check_ip_reputation("185.220.101.34")
  AbuseIPDB Доверие: 100% | Отчеты: 4,832 | Провайдер: Tor Exit Node

→ check_ip_noise("185.220.101.34")
  GreyNoise: MALICIOUS | Теги: [Tor Exit Node, Web Scanner]
  Целевые CVE: CVE-2024-3400, CVE-2023-46805

→ shodan_host_lookup("185.220.101.34")
  Открытые порты: 22, 80, 443, 9001 | ОС: Linux

Ответ Claude: «185.220.101.34 — известный Tor exit node, оцененный AbuseIPDB как 100% вредоносный с 4,832 отчетами о злоупотреблениях. GreyNoise подтверждает активное сканирование для CVE-2024-3400 (Palo Alto) и CVE-2023-46805 (Ivanti). Рекомендация: Заблокировать на файрволе.»

Сценарий 4: «Сгенерируй отчет по безопасности для руководства»

Вы: Сгенерируй отчет по безопасности для руководства по: CVE-2024-3400, CVE-2023-44487, CVE-2023-4966, CVE-2024-21887

→ compare_cves([...])
  Собирает: NVD, EPSS, KEV, наличие PoC, сопоставление с MITRE ATT&CK
  Генерирует: Ранжированную таблицу рисков, график исправлений, резюме для руководства

📊 Оценка риска

Инструмент calculate_risk_score выдает сводную оценку риска от 0 до 100, взвешивая четыре независимых сигнала.

Формула

Оценка риска = (CVSS × 0.20) + (EPSS × 0.35) + (KEV × 0.30) + (PoC × 0.15)

Множители усиления

• KEV + активный PoC → ×1.15
• CVSS ≥ 9.0 + EPSS > 0.7 → ×1.10
• Опубликовано менее 7 дней назад → ×1.05

Оценка ограничена значением 100.

Оценка рисков — v1 (2026-06)

Числовая система оценки имеет scoring_version 1.0 (отображается в triage_cve, calculate_risk_score и health_check). Линейная взвешенная сумма выше является вариантом по умолчанию для v1 для числовой оценки, с одним жестким правилом:

• Жесткое правило CISA KEV: CVE из KEV считается подтвержденным для эксплуатации в реальном мире — это самый сильный сигнал эксплуатации. Его метка никогда не может быть ниже CRITICAL, а его оценка жестко фиксируется на уровне ≥ 76, независимо от CVSS/EPSS. (CVE из KEV с низким CVSS и низким EPSS по-прежнему вернет CRITICAL / 76.)
• CVSS рассматривается как сигнал критичности, а не вероятности эксплуатации (согласно Allodi & Massacci 2014); EPSS и KEV несут сигнал эксплуатации.
• Экспериментальное квантованное решение SSVC v2 (модель CISA Deployer → Act / Attend / Track* / Track) доступно через triage_cve(depth="deep") как качественная, объяснимая альтернатива числовой оценке 0–100.

Почему именно такие веса?

EPSS получает самый высокий вес (35%), потому что это лучший предиктор реальной эксплуатации — намного лучше, чем один только CVSS. CVSS 10.0 с EPSS 0.01 теоретически опасен, но практически маловероятен. KEV на 30% — это подтвержденные факты: эксплуатация, а не прогноз. CVSS на 20% отражает контекст критичности для новых CVE, у которых недостаточно данных EPSS. PoC на 15% отражает тот факт, что публичные эксплойты значительно ускоряют реальные атаки.

🚀 Что нового в v0.2.0

• Оркестратор triage_cve — один вызов инструмента, который параллельно опрашивает NVD + EPSS + CISA KEV (+ публичный поиск PoC при depth != "quick"), вычисляет сводную оценку риска и возвращает чистый отчет. Параметр depth принимает значения quick / standard (по умолчанию) / deep; deep дополнительно выдает квантованное решение SSVC v2.
• Новые внешние источники — VulnCheck NVD++ (прозрачный запасной вариант NVD, используемый автоматически внутри triage_cve, когда NIST NVD недоступен/ограничен), CIRCL hashlookup и range API HIBP Pwned Passwords.
• Жесткое правило оценки KEV + scoring_version — CVE из KEV всегда имеют статус CRITICAL (оценка ≥ 76); версия системы оценки сообщается в triage_cve и health_check.
• HTTP-транспорт — установите MCP_TRANSPORT=http, чтобы обслуживать потоковый HTTP на HOST:PORT (по умолчанию 0.0.0.0:8000, без состояния) вместо stdio. Включается Dockerfile.
• Ресурсы и промпты — ресурсы kev://catalog, epss://scores/{cve_id} и manifest://tool-hash (SHA-256 по поверхности зарегистрированных инструментов); промпты patch_decision, compare_and_prioritize и dependency_triage.
• Конфигурация безопасности — сервер никогда не регистрирует обработчик сэмплинга / никогда не отправляет sampling/createMessage (вектор атаки Unit 42 на MCP-сэмплинг); новые исходящие пути фильтруются по белому списку схем/хостов.

🌐 Источники данных

🧪 Запуск тестов

# Запуск полного набора тестов
pytest tests/ -v

# Запуск конкретных файлов с тестами
pytest tests/test_validators.py tests/test_risk_scorer.py -v

# Запуск с покрытием
pytest tests/ -v --cov=src/cve_mcp --cov-report=term-missing

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector python -m cve_mcp.server

Открывается по адресу http://localhost:6274 — интерактивно тестируйте каждый инструмент, просматривайте входные схемы и форматы ответов.

Что покрывают тесты

• Модульные тесты: вычисление риска, разбор CVSS-вектора, валидация входных данных.
• Интеграционные тесты: регистрация инструментов, валидация параметров, обработка ошибок при отсутствующих ключах.
• Тесты кэша: запись в кэш SQLite, истечение времени жизни (TTL), попадание/промах кэша.
• Тесты безопасности: блокировка частных IP, защита от XML-бомб (defusedxml), санитизация ввода.

🏛️ Подробная архитектура

Структура файлов

src/cve_mcp/
├── server.py              # Сервер FastMCP — все 27 определений @mcp.tool()
├── config.py              # Конфигурация окружения и базовые URL API
├── models.py              # Модели Pydantic (CVERecord, KEVEntry, EPSSScore, ...)
├── audit.py               # Ротационный аудит-лог (50 МБ, 5 резервных копий)
├── api/
│   ├── nvd_client.py      # REST API NVD v2.0
│   ├── osv_client.py      # API уязвимостей пакетов OSV.dev
│   ├── epss_client.py     # API FIRST EPSS
│   ├── kev_client.py      # Каталог CISA KEV
│   ├── ip_intel.py        # AbuseIPDB + GreyNoise
│   ├── domain_intel.py    # crt.sh + пассивный DNS CIRCL
│   ├── shodan_client.py   # Информация о хостах Shodan
│   ├── hash_intel.py      # MalwareBazaar + VirusTotal
│   ├── url_safety.py      # URLScan.io
│   ├── malware_intel.py   # Поиск IOC в ThreatFox
│   ├── ransomware_intel.py# Поиск Bitcoin-адресов Ransomwhere
│   ├── exploit_intel.py   # Поиск PoC/эксплойтов в GitHub
│   ├── vendor_advisory.py # Уведомления MSRC + Red Hat + Ubuntu
│   ├── attack_mapping.py  # Маппинг MITRE ATT&CK STIX
│   ├── cve_timeline.py    # Построитель таймлайна событий CVE
│   ├── dependency_scan.py # Сканирование зависимостей на основе OSV
│   ├── poc_checker.py     # Поиск PoC в GitHub + Exploit-DB + Nuclei
│   ├── report_generator.py# Генератор отчётов об уязвимостях + матрица сравнения CVE
│   └── rate_limiter.py    # Лимитер запросов на основе ведерного алгоритма для NVD
├── cache/
│   └── sqlite_cache.py    # Асинхронный кэш SQLite с индивидуальным TTL для каждого ключа
└── utils/
    ├── validators.py       # Нормализация CVE ID, валидация IP/хешей
    └── risk_scorer.py      # Вычисление комплексного показателя риска

Стратегия кэширования

Аудит-лог

Каждый вызов инструмента логируется в ~/.cve-mcp/audit.log:

{
  "timestamp": "2026-04-14T10:23:45.123Z",
  "tool": "lookup_cve",
  "parameters": {"cve_id": "CVE-2024-3400"},
  "duration_ms": 342,
  "cache_hit": false,
  "status": "ok"
}

Ключи API и полезная нагрузка ответов никогда не записываются в аудит-логи.

🔐 Безопасность и конфиденциальность

Какие данные покидают ваш компьютер

• Только исходящий HTTPS — входящие порты не открываются, телеметрии нет.
• Идентификаторы CVE, IP-адреса, хеши, домены и имена пакетов отправляются в соответствующие API для поиска.
• Ответы API кэшируются локально в SQLite — кэшированные данные остаются на вашем компьютере.

Блокировка частных IP-адресов

Все инструменты сетевой разведки блокируют частные и зарезервированные диапазоны IP перед любым внешним запросом: - 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 (RFC 1918) - 127.0.0.0/8 (loopback), 169.254.0.0/16 (link-local) - ::1, fc00::/7 (частные IPv6)

Защита ключей API

• Ключи загружаются только из переменных окружения — никогда не захардкожены.
• Файл .env добавлен в .gitignore.
• Ключи никогда не логируются, не кэшируются и не включаются в записи аудита.

Безопасность XML

Для разбора XML используется defusedxml, чтобы предотвратить атаки с помощью XML-бомб (миллиард улыбок, внедрение XXE).

🔧 Устранение неполадок

Сервер не запускается

# Убедитесь, что виртуальная среда активирована, и пакет установлен
pip install -e .
python --version  # должна быть 3.10+

В Claude Desktop не отображается значок молота (🔨) - Проверьте синтаксические ошибки JSON (не должно быть запятых в конце) в вашей конфигурации. - Используйте абсолютные пути — относительные пути не работают молча. - Полностью выйдите из Claude Desktop (Cmd+Q / Alt+F4) и перезапустите его.

Лимиты NVD превышены

# Добавьте ваш бесплатный ключ NVD API в .env
NVD_API_KEY=ваш-ключ-здесь
# https://nvd.nist.gov/developers/request-an-api-key

Сервер автоматически ставит избыточные запросы в очередь, но с ключом вы получаете в 10 раз большую пропускную способность.

GreyNoise 401 Unauthorized (Неавторизовано)

# Проверьте, что ваш ключ работает:
curl -H "key: ВАШ_КЛЮЧ" https://api.greynoise.io/v3/ip/8.8.8.8
# Сервер использует /v3/ip/{ip} — НЕ устаревший эндпоинт /v3/community

Проблемы с кодировкой в Windows

$env:PYTHONUTF8 = "1"
$env:PYTHONIOENCODING = "utf-8"

🗺️ Дорожная карта и известные ограничения

Что НЕ делает сервер

• Нет активного сканирования — только разведка/поиск, не исследует вашу инфраструктуру.
• Нет операций записи — только чтение из внешних API (кроме отправок в URLScan).
• Нет подсчёта CVSS v4.0 — встроенный калькулятор работает только с v3.1; оценки v4.0 от NVD отображаются, но не пересчитываются.

Известные ограничения API

• NVD возвращает максимум 2 000 результатов за запрос.
• Оценки EPSS для совсем новых CVE (моложе 24 часов) могут еще не существовать.
• CISA KEV обновляется только в рабочие дни США.
• GreyNoise (уровень community): 50 запросов в неделю.
• VirusTotal (бесплатный тариф): 4 запроса в минуту.
• CIRCL PDNS требует ручной регистрации и одобрения.
• Ransomwhere вводит 90-дневный карантин для новых адресов.

Запланированные улучшения

• Локальный калькулятор CVSS v4.0.
• Webhook/оповещения о добавлении в KEV и изменении оценок EPSS для отслеживаемого списка CVE.
• Экспорт в формате STIX 2.1 для интеграции с SIEM.
• Docker-контейнер с нулевой установкой.
• Потоковая HTTP-транспортировка (MCP SSE).
• Дополнительные источники: Censys, SecurityTrails, VulnCheck.

🤝 Участие в разработке

Приглашаем к участию.

Добавление нового инструмента

1. Добавьте функцию инструмента в server.py с декоратором @mcp.tool()
2. Добавьте валидацию входных данных в utils/validators.py
3. Реализуйте клиент API в api/
4. Добавьте тесты в tests/
5. Обновите этот README

@mcp.tool()
async def my_new_tool(param: str, ctx: Context = None) -> str:
    """
    One-line description for Claude to know when to use this tool.

    Args:
        param: Description of the parameter
    """
    app = _get_app(ctx)
    # validate → cache check → API call → cache write → audit → return

Требования к тестированию

• Все новые инструменты должны иметь как минимум один автономный тест с имитированными ответами
• Изменения оценки рисков должны включать тестовые случаи с проверкой формулы
• Сетевые инструменты должны включать тест, проверяющий блокировку частных IP-адресов
• Все тесты должны проходить: pytest tests/ -v

📄 Лицензия

Лицензия MIT — подробности смотрите в LICENSE.

Copyright (c) 2025-2026 Mahipal Jangra (mukul975)

Создано с 🔐 Mahipal Jangra · Берлин, Германия
Превращаем данные о безопасности в диалог.