Исследование уязвимостей Kitsune MCP

Этот локальный MCP-сервер хранит информацию об уязвимостях, область исследования, результаты сканирования, подтверждающие доказательства, оценки Bugcrowd VRT и черновики отчетов в одной SQLite-базе данных.

Он создан для авторизованных защитных исследований. Он не сканирует цели, не выполняет эксплойты, не запускает команды оболочки, не отправляет отчеты и не публикует раскрытия.

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

Сервер использует фиксированные адаптеры. Вызывающая сторона не может указать другой источник.

CVE.org является канонической записью. NVD — это обогащение и обнаружение последних записей. KEV и EPSS — отдельные сигналы. VRT — это техническая базовая линия, а не авторизация или гарантированная оценка вознаграждения.

Related MCP server: MoonMCP

Требования

• Node.js 24 или новее

• npm 10 или новее

• Абсолютный корень импорта, если будут импортироваться файлы SARIF или доказательства

Для публичных каналов не требуется API-ключ. NVD_API_KEY является необязательным и отправляется только в NVD.

Установка и проверка

npm install
npm test
npm run check
npm run lint
npm run build

Исходный код доступен под лицензией MIT. Пакет не опубликован в npm.

Конфигурация MCP-клиента

Сначала соберите, затем укажите клиенту скомпилированную точку входа stdio:

{
  "mcpServers": {
    "kitsune-vuln-research": {
      "command": "node",
      "args": [
        "--disable-warning=ExperimentalWarning",
        "C:\\path\\to\\kitsune-vuln-research-mcp\\dist\\index.js"
      ],
      "env": {
        "VULN_IMPORT_ROOTS": "C:\\absolute\\path\\to\\scanner-output",
        "VULN_LOG_LEVEL": "warn"
      }
    }
  }
}

Лицензия

MIT. См. LICENSE.

Встроенный модуль Node SQLite все еще выдает ExperimentalWarning в Node 24. Узкий флаг командной строки убирает это предупреждение из stderr MCP, не подавляя другие классы предупреждений.

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

Состояние выполнения хранится в VULN_DATA_DIR:

vuln-research.sqlite
cases/
  <case-id>/
    evidence/
    exports/

SQLite использует внешние ключи, режим WAL, подготовленные выражения и неизменяемые квитанции о событиях. Полезные нагрузки источников и доказательства хэшируются SHA-256.

Инструменты разведки

Упорядочивание кандидатов — это приоритет исследования. Оно не заменяет CVSS, VRT, воспроизведенное воздействие или правила программы.

Инструменты исследования

Регистрация области здесь не создает разрешение. authorization_ref должен указывать на реальный брифинг программы, контракт, тикет или лабораторную авторизацию.

Обычный рабочий процесс

1. Установите VULN_IMPORT_ROOTS в директорию вывода сканера.

2. Обновите последние CVE, KEV, EPSS и VRT.

3. Зарегистрируйте реальную область программы и окно действия.

4. Создайте кейс для одной конкретной цели и разрешенного метода.

5. Запустите Semgrep, CodeQL, Trivy, Grype или другой одобренный сканер вне этого MCP.

6. Импортируйте его вывод SARIF и запишите доказательства воспроизведения.

7. Выберите терминальный путь VRT и запишите фактическое воздействие.

8. Экспортируйте локальный черновик для проверки человеком.

Сообщения сканера и пояснительный текст рассматриваются как ненадежные данные. Они не могут изменить область, выбор инструмента, SQL, пути или структуру отчета.

Безопасность импорта

• Корни импорта должны быть абсолютными и явно настроенными.

• Канонические пути должны оставаться внутри разрешенного корня.

• Импорт символических ссылок, путей устройств Windows и альтернативных потоков данных отклоняется.

• Файлы по умолчанию ограничены 25 МиБ.

• Имена хранимых доказательств генерируются сервером.

• Дублирующиеся доказательства и результаты SARIF идентифицируются по хэшам или стабильным отпечаткам.

Устаревшие каналы и офлайн-работа

Вызовите vuln_get_source_status перед использованием кэшированной разведки. NVD, KEV, EPSS и VRT устаревают через 24 часа. Состояние канонических CVE и запросов OSV устаревает через семь дней.

Если источник недоступен, последний хороший кэш остается читаемым. Установите VULN_OFFLINE=true, когда сессия не должна выполнять сетевые запросы.

Тесты

Набор по умолчанию использует записанные фикстуры. Он охватывает схемы, ограничения источников, изоляцию происхождения, сопоставление области, ограничение путей, строки внедрения в SARIF, хэширование доказательств, оценку VRT, экранирование отчетов, обнаружение MCP и сохранение после перезапуска.

evaluation.xml содержит десять стабильных, доступных только для чтения вопросов, основанных на фиксированных фикстурах 2026 года в tests/fixtures.

Соберите и загрузите эти фикстуры в новую абсолютную директорию данных перед запуском оценок:

npm run seed:evaluation -- C:\absolute\unused\evaluation-data

Загрузчик отказывается перезаписывать существующую базу данных. Укажите VULN_DATA_DIR на эту директорию при запуске сервера оценки.