mcp-uptime-kuma — MCP-сервер для Uptime Kuma 2

Установка

Работает в

• Claude Code
• Cursor
• Codex
• Claude Desktop
• SourceCraft
• Koda
• Coddy

Ручная установка

{"mcpServers":{"uptime-kuma":{"command":"npx","args":["-y","@davidfuchs/mcp-uptime-kuma@latest"],"env":{"UPTIME_KUMA_URL":"http://your-uptime-kuma-instance:3001","UPTIME_KUMA_USERNAME":"your_username","UPTIME_KUMA_PASSWORD":"your_password"}}}}

Что делает

Сервер подключает агента к вашему экземпляру Uptime Kuma версии 2 через Socket.IO и отдает состояние мониторов в реальном времени. По умолчанию он возвращает только нужные поля, чтобы ответы не раздували контекст модели. Чтение закрывают getMonitorSummary и listMonitors с фильтрами по ключевым словам, типу, тегам, статусу, режиму обслуживания и родительской группе, а также getMonitor, listHeartbeats и getHeartbeats для истории проверок. Для записи есть createMonitor, updateMonitor, deleteMonitor, pauseMonitor и resumeMonitor. Поля, специфичные для типа монитора (их около 85), агент передает одним объектом typeFields и уточняет через getMonitorTypeFields. Отдельные наборы инструментов работают с каналами уведомлений, тегами, окнами обслуживания и статус-страницами. Транспорт на выбор: stdio через npx или streamable HTTP из Docker-образа.

Для кого. Администраторам и девопсам, которые следят за сервисами в собственном Uptime Kuma 2 и хотят спрашивать об упавших мониторах прямо в чате с агентом.

Пример запроса к агенту

Покажи все мониторы в статусе DOWN и скажи, что общего у них по тегам и группам.

MCP

Транспорт

stdio, http

Авторизация

ключ необязателен

Ограничения

Работает только с Uptime Kuma 2. Для входа понадобятся адрес экземпляра и учетные данные: логин с паролем, токен JWT или анонимный доступ, если вход в Uptime Kuma отключен. HTTP-вариант из Docker без защиты открывает полное управление экземпляром любому, кто достучится до порта, поэтому его нельзя выставлять за пределы localhost без ключа и прокси. Версия в package.json помечена как 0.0.0-dev, номер релиза подставляет сборка, поэтому ставьте пакет с суффиксом @latest. Сервер не заменяет сам Uptime Kuma: мониторы, расписание проверок и уведомления остаются на стороне вашего экземпляра.

Как отключить. Уберите блок uptime-kuma из конфигурации MCP-клиента и перезапустите клиент. Контейнер остановите командой docker stop mcp-uptime-kuma и удалите. Данные в самом Uptime Kuma сервер не хранит.

Коротко о README

В репозитории описаны быстрый старт через npx и Docker, список инструментов по группам, три способа входа и защита HTTP-точки. Отдельный раздел объясняет, как работать за аутентифицирующим прокси.