Skip to main content
Glama
bdu-fstec-mcp
by velvetway

bdu-fstec-mcp

CI License: MIT Python BDU records

EN: MCP server that gives Claude (or any MCP client) full-text search over the Russian FSTEC vulnerability database (БДУ ФСТЭК, ~100k records): filters by CVSS / severity / vendor / exploit, CVE → BDU mapping. Works outside Russia via a GitHub-hosted mirror.

MCP-сервер, дающий Claude (и любому MCP-клиенту) доступ к БДУ ФСТЭК — российской базе данных угроз безопасности информации. Работает без геоблокировки: снимок хранится в публичном зеркале как готовая SQLite-база и раздаётся через raw.githubusercontent.com.

Зачем

  • bdu.fstec.ru геоблокирует всё, что не Россия: Claude Cloud, GitHub Actions ubuntu-latest, AWS, GCP — туда не попадут.

  • В российской ИБ-compliance (152-ФЗ, 187-ФЗ, ГОСТ Р 57580) ключевой идентификатор уязвимости — BDU:YYYY-NNNNN, не CVE.

  • В awesome-mcp-servers до сих пор нет MCP для БДУ.

Related MCP server: NVD MCP Server

Возможности

Четыре инструмента поверх 99 397 записей (снимок 07.11.2026, источник обновлён 06.11.2026):

  • search_bdu_vulnerabilities — поиск с ранжированием по FTS5 и фильтрами:

    • полнотекстовый запрос с корректной токенизацией кириллицы;

    • min_cvss, min_severity (низкий/средний/высокий/критический);

    • year (год обнаружения);

    • vendor (подстрока имени вендора);

    • has_exploit (только уязвимости с известным эксплойтом).

  • get_bdu_vulnerability — полная запись по идентификатору БДУ.

  • find_bdu_by_cve — обратный маппинг CVE → БДУ.

  • get_bdu_stats — статистика снимка и проверка актуальности.

Производительность

Операция

Время (~99k записей)

Холодный старт (скачать ~60 МБ SQLite + распаковать)

5–10 с, один раз

Последующие старты

<50 мс

search_bdu_vulnerabilities c FTS5

1–30 мс

Фильтр-only (year/severity/cvss)

<5 мс (composite-индексы)

find_bdu_by_cve

1–5 мс

get_bdu_vulnerability

<5 мс

FTS5 — unicode61 remove_diacritics 2 с BM25-ранжированием, snippet-подсветкой через «…». Запросы на русском автоматически превращаются в префиксный поиск с обрезкой последних двух букв для простой морфологии (инъекция → инъекц*), так что склонения и падежи находятся.

Установка

pip install bdu-fstec-mcp

Или локально:

git clone https://github.com/velvetway/bdu-fstec-mcp
cd bdu-fstec-mcp
pip install -e .

Запуск в Claude Code

В ~/.claude/settings.json:

{
  "mcpServers": {
    "bdu-fstec": { "command": "bdu-fstec-mcp" }
  }
}

Запуск в Claude Desktop

В claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "bdu-fstec": { "command": "bdu-fstec-mcp" }
  }
}

Если bdu-fstec-mcp не находится в PATH, укажите полный путь (which bdu-fstec-mcp) или запускайте через uvx bdu-fstec-mcp.

CLI

bdu-fstec-mcp            # запустить stdio-сервер (по умолчанию)
bdu-fstec-mcp run        # то же самое
bdu-fstec-mcp stats      # показать статистику локального снимка
bdu-fstec-mcp refresh    # принудительно перекачать свежий снимок

Переменные окружения

Переменная

По умолчанию

Описание

BDU_FSTEC_DB_URL

адрес в зеркале

URL к bdu.sqlite.gz.

BDU_FSTEC_STATS_URL

адрес в зеркале

URL к stats.json.

BDU_FSTEC_CACHE_DIR

$XDG_CACHE_HOME/bdu-fstec-mcp

Каталог локального кэша.

BDU_FSTEC_STALENESS_DAYS

30

После скольких дней предупреждать о старом снимке.

BDU_FSTEC_REQUEST_TIMEOUT

120

Таймаут HTTP-запросов (с).

Пример диалога

Я: Что есть у ФСТЭК по CVE-2024-1086?

Claude (вызывает find_bdu_by_cve("CVE-2024-1086")):

Найдена 1 запись БДУ — BDU:2024-01187, use-after-free в nft_verdict_init() ядра Linux, CVSS 7.8. Подтверждена производителем, эксплойт существует. Затронуты Astra Linux Special Edition 1.7, РЕД ОС 7.3, Альт 8 СП и ещё 10 дистрибутивов.

Я: Критические уязвимости Astra Linux за 2025 год, где есть эксплойт.

Claude (вызывает search_bdu_vulnerabilities(query="Astra Linux", min_severity="критический", year=2025, has_exploit=true)):

Найдено 4 результата…

Архитектура

src/bdu_fstec_mcp/
    __init__.py       пакетные константы
    _config.py        конфигурация через env
    _cli.py           CLI-обёртка (run/refresh/stats)
    cache.py          скачивание и staleness-проверка снимка
    store.py          SQLite+FTS5 запросы и DTO-гидратация
    models.py         неизменяемые dataclass-модели
    formatters.py     pretty-print для LLM
    server.py         MCP stdio-сервер и диспетчер тулов

Данные живут в отдельном репозитории bdu-fstec-mirror. MCP их только читает.

Разработка

pip install -e '.[dev]'
pytest          # 48 тестов, ~4 с

Покрыты: FTS5-экранирование, фильтры, маппинг CVE→БДУ, скачивание и fallback кэша, staleness-проверки, форматтеры.

Правовая сторона

  • Данные БДУ — публичная информация, размещённая ФСТЭК России на https://bdu.fstec.ru.

  • Проект не аффилирован с ФСТЭК России.

  • Код — MIT. Данные остаются собственностью ФСТЭК России.

  • При ссылке на результаты указывайте источник.

Связанные проекты

  • velvetway/minreestr-mcp — MCP для поиска российского ПО в каталоге Минцифры / каталогпо.рф.

  • velvetway/bdu-fstec-mirror — зеркало БДУ, источник данных для этого MCP.

Available Tools

4 tools
find_bdu_by_cveMap CVE → БДУA
Read-onlyIdempotent

Обратный маппинг международного CVE-идентификатора в российские записи БДУ. Полезно для cross-reference международных advisory ↔ локальных compliance-документов (187-ФЗ, ГОСТ Р 57580, паспорта КИИ). Одному CVE может соответствовать несколько записей БДУ (разные пакеты, ОС, версии). Read-only. Регистр CVE нечувствителен. Если соответствия нет — возвращает сообщение, что запись отсутствует.

Inputs: cve_id (required).

get_bdu_statsБДУ snapshot statisticsA
Read-onlyIdempotent

Метаданные текущего локального снимка БДУ: общее число записей, диапазон идентификаторов BDU:2014-00001 → BDU:YYYY-NNNNN, дата снимка в зеркале, последнее обновление источника. Автоматически проверяет, не устарел ли локальный кэш относительно зеркала (при наличии сетевого доступа) и советует запустить bdu-fstec-mcp refresh, если снимок старше порога (по умолчанию 30 дней). Нет побочных эффектов.

Inputs: no named parameters.

get_bdu_vulnerabilityGet one БДУ record by identifierA
Read-onlyIdempotent

Возвращает полную запись БДУ по идентификатору BDU:YYYY-NNNNN (например, BDU:2024-01187). Включает заголовок, описание, CVSS (оба вектора и балл), уровень опасности ФСТЭК, все связанные CVE, CWE, список уязвимого ПО с вендорами и версиями, дату обнаружения / публикации / последнего обновления, рекомендованное решение, статус эксплойта, статус исправления, источники и URL карточки на bdu.fstec.ru. Read-only. Если идентификатор не найден — сообщение об отсутствии; допускает ввод без префикса BDU: (добавляется автоматически).

Inputs: bdu_id (required).

search_bdu_vulnerabilitiesSearch БДУ ФСТЭК vulnerabilitiesA
Read-onlyIdempotent

Поиск уязвимостей в БДУ ФСТЭК (Банк данных угроз безопасности информации России) по полнотекстовому запросу с FTS5-ранжированием (BM25) и опциональным фильтрам. Индекс содержит ~86 000 записей: заголовок, описание, уязвимое ПО, вендор, CVE-идентификаторы. Все результаты read-only (локальная SQLite-копия), без побочных эффектов и сетевых запросов. Пустой query + фильтры → сортировка по CVSS DESC. Возвращает до 100 результатов с идентификатором БДУ, оценкой CVSS, списком ПО, ссылкой на bdu.fstec.ru и сниппетом с подсветкой матча. Применение: поиск аналога CVE в российской БД, подбор уязвимостей по вендору (Astra Linux, ЛК, Positive Technologies и т.д.), фильтрация для моделей угроз 187-ФЗ / ГОСТ Р 57580. Ошибки: недоступность зеркала при первом запуске — сообщение с рекомендацией bdu-fstec-mcp refresh.

Inputs: query, limit, min_cvss, min_severity, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct purpose: CVE lookup, metadata retrieval, single record by BDU ID, and full-text search. No overlap in functionality or input parameters.

    Naming Consistency3/5

    Tool names mix verbs (find, get, search) and vary in specificity (one uses 'by_cve' suffix). While readable, the pattern is not uniform; singular/plural inconsistency ('vulnerability' vs 'vulnerabilities').

    Tool Count5/5

    Four tools for a specialized vulnerability database is well-scoped: covers essential queries (CVE, ID, search, stats) without unnecessary bloat.

    Completeness4/5

    Primary lookup methods are covered (by CVE, ID, full-text search, stats). Minor gap: no dedicated 'list all' tool, but search with empty query fills this partially. Read-only surface is comprehensive.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for searching Russia's official software catalog (каталогпо.рф) containing 26,000+ domestic products. Enables finding Russian alternatives to foreign software, checking FSTEC/FSB certifications, and discovering vendors for import substitution directly from Claude or any MCP client.
      3
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the NIST National Vulnerability Database — lets AI assistants search CVEs by keyword, severity, CPE, CWE, KEV status, and date range via natural language.
      2
      1
      GPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      This MCP server connects Claude Desktop to OpenCTI for AI-augmented threat intelligence analysis, enabling natural language queries and instant, contextualized answers from your threat intelligence database.
      29
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that connects Claude to Dependency-Track for natural language vulnerability triage, analysis, and management.
      14
      MIT