Red Team TL;DR

English | 中文简体

Что такое Red Team TL;DR?

red-tldr — это легковесный инструмент для поиска команд в сфере red team. Он помогает опытным специалистам быстро находить нужные команды, техники и ключевые моменты — подобно команде man, но созданной для наступательной безопасности.

Начиная с версии v0.5.0, red-tldr поставляется со встроенным сервером MCP, что позволяет ИИ-ассистентам, таким как Claude Desktop и Cursor, напрямую обращаться к вашей базе знаний red team.

Зачем нужен Red Team TL;DR?

В повседневной работе red team приходится запоминать сотни команд — и обычно вы помните только первые несколько символов. Поиск в документации или поисковых системах медленный и зашумленный. red-tldr даёт мгновенные, автономные, детерминированные ответы из базы данных, которую вы сами контролируете.

Возможности

• Полнотекстовый поиск — поиск BM25 на основе Bleve с взвешенными оценками (имя×5, теги×3, данные×1) и нечёткое соответствие
• Несколько форматов вывода — text (цветной терминал), json, markdown
• MCP-сервер — Встроенный сервер протокола контекста модели для интеграции с ИИ-ассистентами (stdio + Streamable HTTP)
• Привязка к MITRE ATT&CK — Записи могут быть отмечены тактиками и техниками
• Расширенная модель данных — категория, платформы, mitre_attack, метаданные (автор/источник/достоверность), связанные записи
• Обратная совместимость — Работает с существующими базами YAML, новые поля необязательны
• Офлайн-режим — Нет облачных зависимостей, ключей API, полностью детерминировано
• Безопасность — Исправлена уязвимость Zip-slip, проверка путей для всех операций с архивами

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

Установка

macOS

$ brew install red-tldr

Arch Linux

# AUR: https://aur.archlinux.org/packages/red-tldr
$ sudo pacman -S red-tldr

Из исходного кода

$ git clone https://github.com/Rvn0xsy/red-tldr
$ cd red-tldr
$ go build

Бинарный файл

Скачайте из Releases.

$ tar -zxvf red-tldr_latest_linux_amd64.tar.gz
$ ./red-tldr

Рекомендуется добавить red-tldr в PATH.

Использование

Поиск

# Поиск по ключевому слову
$ red-tldr mimikatz

# Нечёткий поиск — введите несколько символов
$ red-tldr mi

Если найдено несколько результатов, выберите по номеру:

Форматы вывода

# Вывод в JSON
$ red-tldr mimikatz -f json

# Вывод в Markdown
$ red-tldr mimikatz -f markdown

Обновление

# Перестроить локальный индекс (JSON + Bleve)
$ red-tldr update

# Загрузить последнюю версию базы данных с GitHub
$ red-tldr upgrade

MCP-сервер

red-tldr включает встроенный MCP-сервер, который предоставляет вашу базу знаний red team ИИ-ассистентам.

Инструменты

Режим stdio (Claude Desktop / Cursor)

$ red-tldr serve

Добавьте в конфигурацию Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "red-tldr": {
      "command": "red-tldr",
      "args": ["serve"]
    }
  }
}

Режим Streamable HTTP

$ red-tldr serve --http --addr localhost:8080 --endpoint /mcp

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

Путь к конфигурации по умолчанию: ~/.red-tldr/config.toml

[red-tldr]
  index-update = false
  github-update = false
  path = ""
  color = true

Модель данных

Каждая запись — это YAML-файл в репозитории red-tldr-db. Расширенный формат (v0.5.0+) поддерживает дополнительные поля, сохраняя обратную совместимость:

name: mimikatz-sekurlsa
tags:
  - mimikatz
  - credentials
  - lsass
data: |
  # Mimikatz Sekurlsa

privilege::debug sekurlsa::logonpasswords

category: credential-access
platforms:
- windows
mitre_attack:
tactics:
  - credential-access
techniques:
  - T1003.001
metadata:
author: Rvn0xsy
confidence: high
related:
- mimikatz-dpapi

Все новые поля (category, platforms, mitre_attack, metadata, related) необязательны — существующие YAML-файлы работают без изменений.

Вклад в проект

Мы приветствуем вклад сообщества!

• Сообщайте об ошибках через Issues.
• Отправляйте исправления ошибок в виде Pull Requests в ветку dev.
• Для новых функций сначала создайте issue, чтобы обсудить подход, прежде чем отправлять PR.
• Улучшения документации всегда приветствуются.
• Контакт: [email protected]

Звёзды с течением времени