REMnux MCP Server
remnux-mcp-server
Анализ вредоносных файлов в REMnux через агента: подбор инструментов, автоматические цепочки, извлечение IOC и отчеты
- 141 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Агент выполняет команды в среде REMnux, где лежат вредоносные образцы.
- Без `--sandbox --ingest-root` загрузка читает любые файлы пользователя, а скачивание пишет в любую доступную папку.
- Содержимое образца и имя файла способны навязать агенту ложный вывод или команду.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/remnux-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет команды в среде REMnux, где лежат вредоносные образцы.
- Без `--sandbox --ingest-root` загрузка читает любые файлы пользователя, а скачивание пишет в любую доступную папку.
- Содержимое образца и имя файла способны навязать агенту ложный вывод или команду.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер дает агенту инструменты REMnux, дистрибутива Linux для анализа вредоносного ПО. `suggest_tools` определяет тип файла и советует инструменты, `analyze_file` сам запускает нужную цепочку на одной из трех глубин (`quick`, `standard`, `deep`) и возвращает структурированный вывод с IOC, а `run_tool` выполняет произвольную команду в среде REMnux. Сервер приучает агента к осторожным выводам. Формулировки нейтральные («заметно» вместо «подозрительно»), статические находки отделены от наблюдавшегося поведения, а `check_behavior_prerequisites` и `verify_string_usage` проверяют, подтверждает ли код заявленное поведение. Есть шаблон отчета и памятка по OSINT-триажу индикаторов.
Для кого. Аналитикам вредоносного ПО и специалистам по реагированию на инциденты, которые разбирают образцы в REMnux вместе с агентом.
Подходит, если
- Нужен быстрый первичный разбор подозрительного PE-файла: тип, упаковщик, возможности по `capa`.
- Из документа Office выгружают встроенные макросы и XML и ищут индикаторы.
- Два образца сравнивают: загрузчик и полезную нагрузку, по импортам, секциям и энтропии.
- После разбора готовят отчет по шаблону и порядок обогащения IOC.
Не подходит, если
- REMnux не развернут: нет контейнера или виртуальной машины с дистрибутивом.
- Образцы лежат на основной рабочей станции без изоляции: границей безопасности служит контейнер или VM.
- Нужен окончательный вердикт без проверки аналитиком: вывод инструментов остается материалом для решения человека.
Пример запроса к агенту
Загрузи `sample.exe` в REMnux, запусти быстрый разбор и покажи возможности и IOC, отделив статические находки от наблюдавшегося поведения.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
MCP_TOKENсекрет- Токен для HTTP-режима; сервер не стартует на нелокальном адресе без него.
Ограничения
Границей безопасности служит контейнер или VM, а не защита сервера: блокируются только нулевые байты и катастрофические команды вроде `mkfs` и `rm -rf /`. Без `--sandbox --ingest-root` инструмент `upload_from_host` читает любой файл вашего пользователя, а `download_file` пишет в любую доступную папку. HTTP на нелокальном адресе требует токена и обратного прокси для HTTPS. Нужны Node.js 20 или новее и Docker либо SSH-доступ. На arm64 в REMnux нет части инструментов.
Как отключить. Удалите запись remnux из конфигурации MCP-клиента и остановите контейнер командой `docker rm -f remnux`. Образцы и вывод анализа удалите из папок `samples` и `output`.
Частые вопросы
Как подключить сервер, если агент и REMnux на одной машине?
Запустите сервер без `--mode`: локальный режим включен по умолчанию, а стандартные папки `/home/remnux/files/samples` и `/home/remnux/files/output` подходят сразу.
Что делает `analyze_file` с большим выводом?
Если суммарный вывод превышает около 32 КБ, инструмент переходит в сводный режим: ключевые находки по каждому инструменту, все IOC и пути к полным файлам вывода.
Как защитить HTTP-доступ?
Сервер откажется стартовать на нелокальном адресе без `--http-token` или переменной `MCP_TOKEN`. Токен создают командой `openssl rand -hex 32`, а HTTPS обеспечивает обратный прокси.
Сколько инструментов запускает `analyze_file`?
Зависит от глубины: `quick` запускает около 20 инструментов, `standard` около 80, `deep` около 100. Цифры охватывают все типы файлов, для конкретного файла идет только подходящая часть.
Как сервер работает с архивами образцов?
`extract_archive` сам пробует пароли `infected`, `malware` и `virus`, а `download_file` по умолчанию отдает результат в архиве с паролем `infected`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыИнструмент анализа вредоносных файлов с MCP-сервером: агент вызывает разбор файлов, документов и архивов, поиск индикаторов и проверку подписей
Сканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
RE-MCP открывает агенту IDA Pro и Ghidra в безголовом режиме: функции, декомпилятор, перекрестные ссылки, типы и патчинг.
MCP-сервер для реверс-инжиниринга и анализа вредоносных файлов: декомпиляция, YARA, форензика, отчеты с доказательствами
MCP-сервер, который дает агенту разбор уязвимостей: данные NVD, EPSS, каталог CISA KEV, связки с MITRE ATT&CK и оценка риска CVE в одном запросе
MCP-сервер и агентный набор для реверс-инжиниринга: Ghidra, Frida, x64dbg и Rizin для анализа бинарей, CTF и исследования вредоносного ПО
Коротко о README
Описаны три схемы: агент и сервер на рабочей машине с REMnux в Docker или по SSH, все на самом REMnux, и сервер внутри REMnux с доступом по HTTP. Для работы с образцами есть загрузка с хоста до 200 МБ и скачивание результатов в архиве с паролем `infected`.