maintenant MCP
MCP-сервер мониторинга maintenant: агент читает логи контейнеров, историю проверок и алерты, но не трогает контейнеры
- 548 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент читает логи контейнеров, где бывают токены и персональные данные
- Сервер получает сокет Docker, пусть и только для чтения, а удаленный режим открывает порт наружу
Установка
- Работает в
Ручная установка
claude mcp add maintenant -- docker run -i --rm -v maintenant-data:/data -v /var/run/docker.sock:/var/run/docker.sock:ro ghcr.io/kolapsis/maintenant:latest --mcp-stdioЛокальный режим по stdio; том и сокет нужны серверу для чтения данных и логов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает логи контейнеров, где бывают токены и персональные данные
- Сервер получает сокет Docker, пусть и только для чтения, а удаленный режим открывает порт наружу
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
maintenant — самостоятельный мониторинг Docker, Kubernetes и доступности сервисов в одном бинарнике на Go. Он сам находит контейнеры, следит за состоянием, рестартами, ресурсами и логами, проверяет TLS-сертификаты и задания cron и шлет оповещения. Встроенный MCP-сервер с 51 инструментом отдает агенту то, что видит мониторинг: логи контейнера, историю проверок конечной точки, нагрузку на процессор и память, очередь алертов. В реестре MCP сервер описан как мониторинг Docker для агентов: логи, история и алерты, а подтвердить алерт можно, контейнеров агент не трогает. Через сервер также открывают инцидент. Локально сервер запускается по stdio внутри контейнера с флагом `--mcp-stdio`, ему нужны том с базой и сокет Docker только для чтения. Удаленно он доступен по адресу вашего экземпляра `/mcp` при включенном `MAINTENANT_MCP` и учетных данных OAuth2.
Для кого. Администраторам небольших стеков на Docker или Kubernetes, которым нужно, чтобы агент разбирал падение сервиса по логам и истории, пока они спят.
Подходит, если
- Пришел алерт о падении контейнера, и агент собирает логи, историю проверок и соседние алерты на том же хосте
- Нужно понять, почему эндпоинт моргает: агент смотрит историю проверок по времени
- Утечку памяти ищут по графикам ресурсов контейнера, которые агент вытаскивает по запросу
- Утром агент подтверждает алерты, по которым решение уже принято
Не подходит, если
- Нужно перезапустить контейнер или поменять конфигурацию: сервер читает и подтверждает алерты, но не управляет контейнерами
- Мониторинга maintenant у вас нет: сервер работает только вместе с его экземпляром
- Логи содержат секреты и персональные данные: агент прочитает их целиком
Пример запроса к агенту
Посмотри активные алерты maintenant, найди для самого свежего логи контейнера за последние 30 минут и опиши, что сломалосьMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
MAINTENANT_MCP- Значение true включает удаленный MCP по адресу экземпляра `/mcp`
Ограничения
Сервер работает только с запущенным экземпляром maintenant. Локальный режим требует доступ к сокету Docker только для чтения и тому с базой данных, удаленный режим включают переменной `MAINTENANT_MCP=true` и настраивают учетные данные клиента OAuth2. Интерфейс и API самого приложения по умолчанию слушают без собственной аутентификации, поэтому порт 8080 лучше привязать к `127.0.0.1` или закрыть обратным прокси. Лицензия Apache-2.0, у версии Pro есть коммерческая лицензия. Версия в реестре MCP 1.11.0.
Как отключить. Уберите блок maintenant из конфигурации клиента и, если включали удаленный доступ, поставьте `MAINTENANT_MCP=false` и отзовите учетные данные OAuth2.
Частые вопросы
Как запустить maintenant?
Скопируйте `docker-compose.yml` из README, выполните `docker compose up -d` и откройте http://localhost:8080. Контейнеры подхватятся сами. Для Kubernetes есть манифесты: `kubectl apply -f deploy/kubernetes/`.
Какие инструменты MCP можно дать агенту только для чтения?
В примере с Claude Code разрешены `list_alerts`, `get_container_logs`, `get_endpoint_history` и `get_resources`. Так агент разбирает алерты и не меняет состояние мониторинга.
Может ли агент перезапускать контейнеры?
Нет, по описанию сервера он не трогает контейнеры: читает данные, подтверждает алерты и открывает инциденты.
Как агент получает алерты сам?
Небольшой приемник на Python запускается рядом с maintenant, и каждый сработавший алерт стартует сессию Claude Code, которой доступны только инструменты чтения. Диагноз сохраняется в каталог `reports`.
Есть ли установка без Docker?
Да, для Linux с systemd есть скрипт `curl -fsSL https://install.maintenant.dev | sudo bash`. Проверки конечных точек, сертификатов и heartbeat работают и без среды контейнеров.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP K8S Go — Kubernetes для агента
MCP K8S Go
MCP-сервер на Go: агент читает поды, логи и события кластера Kubernetes, меняет ресурсы и выполняет команды в подах
Docker MCP
Docker MCP server
MCP-сервер для управления Docker на естественном языке: контейнеры, образы, сети и тома, в том числе на удаленном хосте по SSH
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
MCP-сервер к Docker: агент смотрит контейнеры и логи, перезапуск закрыт флагом и списком запретов, значения переменных скрыты.
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Встроенный MCP OneUptime: агент разбирает инциденты, читает логи и трассы, подтверждает алерты и настраивает мониторы.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| maintenant (эта карточка) | нет | OAuth | 548 | |
| Docker MCP | нет | не нужна | 755 | управляет Docker на естественном языке: контейнеры, образы, сети и тома, без мониторинга и алертов |
| Kubernetes MCP Server | нет | не нужна | 2 244 | работает с ресурсами кластера, подами и Helm напрямую, а не с готовым мониторингом, алертами и историей проверок |
Коротко о README
Текст обещает мониторинг «брось контейнер и он под наблюдением» без PromQL и экспортеров. Дальше идут быстрый запуск через Compose и Kubernetes, установка на голый Linux, облачные шаблоны cloud-init, сравнение с Prometheus и Grafana и сценарий, где агент разбирает алерт через MCP.