BunkerWeb MCP Server
Официальный MCP-сервер BunkerWeb: 44 инструмента для сервисов, экземпляров, банов IP, конфигураций и плагинов WAF.
- 10 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты удаляют сервисы и плагины, останавливают экземпляры и банят IP-адреса в рабочем файрволе.
- У сервера нет ролей на клиента: права агента равны правам токена BunkerWeb API.
Установка
- Работает в
Ручная установка
docker run --rm -p 127.0.0.1:8080:8080 --env-file .env bunkerity/bunkerweb-mcp:latestКоманда из README для готового образа. Перед запуском скопируйте `.env.example` в `.env` и задайте адрес и токен API BunkerWeb.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты удаляют сервисы и плагины, останавливают экземпляры и банят IP-адреса в рабочем файрволе.
- У сервера нет ролей на клиента: права агента равны правам токена BunkerWeb API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер передает агенту API управления BunkerWeb, открытого веб-файрвола. Агент заводит, меняет и удаляет защищаемые сервисы, перезагружает и останавливает экземпляры, банит и разбанивает IP, правит глобальную и пользовательскую конфигурацию, загружает плагины и запускает задания планировщика. После записи в сервис сервер перечитывает данные и выдает квитанцию: совпали ли настройки в базе, и всегда помечает, что работа в живую не подтверждена. Для чтения доступны ресурсы `config://global`, `bans://active`, `instances://status` и `logs://jobs`. Сервер раздает 13 встроенных Agent Skills BunkerWeb как ресурсы `skill://bunkerweb/`.
Для кого. Администраторам BunkerWeb и DevOps-инженерам, которые защищают сайты файрволом и хотят править сервисы, баны и конфигурацию запросами к агенту.
Подходит, если
- Адрес атакующего надо забанить сразу, и агент делает это командой, не открывая интерфейс.
- Перенос сайтов с Apache или Caddy на BunkerWeb идет по встроенным скиллам миграции.
- Перед выкладкой проверяют состояние API, версию, MULTISITE и число экземпляров.
- Новый сервис заводят с настройками из шаблона и сразу читают результат записи.
Не подходит, если
- BunkerWeb API недоступен с хоста сервера: без него инструментам нечем отвечать.
- Для всех клиентов нужна разная роль: ролей на клиента в сервере нет.
- Рабочий файрвол без резервной копии конфигурации: инструменты удаляют сервисы и плагины.
Пример запроса к агенту
Покажи экземпляры BunkerWeb и активные баны, затем забань адрес 203.0.113.15 и перезагрузи экземпляры.MCP
- Транспорт
- http, stdio
- Авторизация
- ключ необязателен
Переменные окружения
BUNKERWEB_BASE_URLобязательная- Адрес API управления BunkerWeb. По умолчанию `http://localhost:8888`; из контейнера `localhost` указывает на сам контейнер.
BUNKERWEB_API_TOKENсекрет- Статический токен API для заголовка Bearer.
BUNKERWEB_BASIC_USERNAME- Имя пользователя для Basic-аутентификации, если токена нет.
BUNKERWEB_BASIC_PASSWORDсекрет- Пароль для Basic-аутентификации.
MCP_READ_ONLY- Значение `true` оставляет только инструменты чтения на всех транспортах.
MCP_ALLOWED_HOSTS- Список разрешенных значений Host через запятую; для локального клиента включает `127.0.0.1:8080`.
Ограничения
Нужен доступный API BunkerWeb и его учетные данные. Роли для разных клиентов в сервере нет, поэтому права агента равны правам токена, а доступ ограничивают режимом `MCP_READ_ONLY=true`. HTTP-адрес `/mcp/` без токена не защищен, и его держат в доверенной сети или за прокси с проверкой входа. Демонстрационный `docker-compose.yml` открывает порт 8080 без проверки токена клиента и годится только для рабочей машины разработчика. Квитанция записи не доказывает, что экземпляры уже применили настройки.
Как отключить. Остановите контейнер, например `docker stop` для запущенного образа, и удалите запись `bunkerweb` из `.mcp.json` или из конфигурации клиента. Токен API BunkerWeb выпустите заново.
Частые вопросы
Как подключить BunkerWeb MCP Server к Claude Code?
Запустите образ командой `docker run --rm -p 127.0.0.1:8080:8080 --env-file .env bunkerity/bunkerweb-mcp:latest` и добавьте в `.mcp.json` запись с типом `http` и адресом `http://127.0.0.1:8080/mcp/`. Слэш в конце адреса обязателен.
Как оставить агенту только чтение?
Задайте `MCP_READ_ONLY=true`. Инструменты записи пропадут на всех транспортах, включая `authenticate`, который выдает учетные данные.
Можно ли запустить сервер без HTTP?
Да, как stdio-процесс. Создайте виртуальное окружение с Python 3.11 или новее, установите пакет из репозитория и укажите в конфигурации клиента путь к `.venv/bin/bunkerweb-mcp` с переменными `BUNKERWEB_BASE_URL` и `BUNKERWEB_API_TOKEN`.
Что делает инструмент diagnose?
Показывает адрес API, доступность, успешность входа, версию, значение MULTISITE и число экземпляров. Если передать имя сервиса, добавит его состояние, признак черновика и счетчики владельцев настроек.
Откуда берутся встроенные скиллы?
Из репозитория `bunkerity/bunkerweb-skills`, версия закреплена в файле `SKILLS_REF`. Их 13, начинать надо с `skill://bunkerweb/bunkerweb/SKILL.md`. Параметр `MCP_ENABLE_SKILLS=false` отключает их.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Wazuh: агент разбирает оповещения и уязвимости, проверяет состояние SIEM и вызывает инструменты реагирования
Открытый фреймворк ловушек: поддельные SSH, HTTP, базы данных и MCP-инструменты на YAML, ответы можно поручить LLM, а действия атакующего пишутся в журнал
MCP-сервер для наступательной безопасности: агент запускает более 150 инструментов пентеста и разведки и ведет автоматическую проверку целей
Официальный MCP дает агенту операции с хранилищем Bitwarden и, при отдельных правах, администрацию организации.
Burp Suite MCP Server
Burp Suite MCP Server Extension
Официальное расширение PortSwigger, которое открывает Burp Suite AI-клиентам по MCP для работы с веб-трафиком при тестировании
Мост между MCP-клиентом и терминалом Kali Linux: агент запускает nmap, sqlmap, hydra и другие инструменты для авторизованного пентеста и CTF
Коротко о README
Быстрый старт подключает контейнер к существующему API BunkerWeb или поднимает демонстрационный стенд целиком. Затем идут клиенты по HTTP и stdio, таблица переменных окружения, список инструментов и ресурсов, раздел безопасности и мониторинг через Prometheus и Grafana.