mcp-uptime-kuma — MCP-сервер для Claude Code: функции и запуск
Подключает Claude Code к мониторингу Uptime Kuma версии 2. Помогает проверять состояние сервисов, ставить проверки на паузу и настраивать окна обслуживания прямо из терминала.
claude mcp add mcp-uptime-kuma -e UPTIME_KUMA_URL=<UPTIME_KUMA_URL> -e UPTIME_KUMA_PASSWORD=<UPTIME_KUMA_PASSWORD> -e UPTIME_KUMA_2FA_TOKEN=<UPTIME_KUMA_2FA_TOKEN> -e UPTIME_KUMA_JWT_TOKEN=<UPTIME_KUMA_JWT_TOKEN> -e UPTIME_KUMA_HEADERS=<UPTIME_KUMA_HEADERS> -- npx -y @davidfuchs/mcp-uptime-kumaЧто делает mcp-uptime-kuma
Сервер связывается с инстансом Uptime Kuma через Socket.IO и отдаёт агенту только ключевые поля, чтобы не перегружать контекст модели лишними данными. Поддерживаются два транспорта: стандартный ввод-вывод stdio через npx для локальной работы и потоковый HTTP при запуске в контейнере Docker.
В набор инструментов входят команды для просмотра мониторов, чтения истории проверок (heartbeats), управления оповещениями, тегами и окнами регламентных работ. Список проверок можно фильтровать по типу сервиса, тегу, признаку активности или статусу падения.
Сервер рассчитан строго на Uptime Kuma второй версии, поэтому с первой веткой работать не будет. При запуске через HTTP порт 3000 открыт без авторизации по умолчанию, так что выставлять его за пределы локальной сети без защиты нельзя.
Какие задачи решает
- получить список упавших мониторов и историю последних проверок
- запланировать или завершить окно регламентных работ
- создать новый HTTP-монитор с нужным интервалом опроса
- временно приостановить отправку алертов для выбранного сервиса
Примеры запросов агенту
- Покажи все мониторы в Uptime Kuma со статусом DOWN.
- Поставь монитор с ID 4 на паузу, пока идёт деплой.
- Создай окно обслуживания для продакшен-сервисов на сегодня с 22:00 до 23:00.
Как установить mcp-uptime-kuma
Командой платформы
claude mcp add mcp-uptime-kuma -e UPTIME_KUMA_URL=<UPTIME_KUMA_URL> -e UPTIME_KUMA_PASSWORD=<UPTIME_KUMA_PASSWORD> -e UPTIME_KUMA_2FA_TOKEN=<UPTIME_KUMA_2FA_TOKEN> -e UPTIME_KUMA_JWT_TOKEN=<UPTIME_KUMA_JWT_TOKEN> -e UPTIME_KUMA_HEADERS=<UPTIME_KUMA_HEADERS> -- npx -y @davidfuchs/mcp-uptime-kumaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add mcp-uptime-kuma --env UPTIME_KUMA_URL=<UPTIME_KUMA_URL> --env UPTIME_KUMA_USERNAME=<UPTIME_KUMA_USERNAME> --env UPTIME_KUMA_PASSWORD=<UPTIME_KUMA_PASSWORD> --env UPTIME_KUMA_2FA_TOKEN=<UPTIME_KUMA_2FA_TOKEN> --env UPTIME_KUMA_JWT_TOKEN=<UPTIME_KUMA_JWT_TOKEN> -- npx -y @davidfuchs/mcp-uptime-kumaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp-uptime-kuma": {
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<UPTIME_KUMA_URL>",
"UPTIME_KUMA_USERNAME": "<UPTIME_KUMA_USERNAME>",
"UPTIME_KUMA_PASSWORD": "<UPTIME_KUMA_PASSWORD>",
"UPTIME_KUMA_2FA_TOKEN": "<UPTIME_KUMA_2FA_TOKEN>",
"UPTIME_KUMA_JWT_TOKEN": "<UPTIME_KUMA_JWT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"mcp-uptime-kuma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@davidfuchs/mcp-uptime-kuma"
],
"env": {
"UPTIME_KUMA_URL": "<UPTIME_KUMA_URL>",
"UPTIME_KUMA_USERNAME": "<UPTIME_KUMA_USERNAME>",
"UPTIME_KUMA_PASSWORD": "<UPTIME_KUMA_PASSWORD>",
"UPTIME_KUMA_2FA_TOKEN": "<UPTIME_KUMA_2FA_TOKEN>",
"UPTIME_KUMA_JWT_TOKEN": "<UPTIME_KUMA_JWT_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e UPTIME_KUMA_URL=<UPTIME_KUMA_URL> -e UPTIME_KUMA_USERNAME=<UPTIME_KUMA_USERNAME> -e UPTIME_KUMA_PASSWORD=<UPTIME_KUMA_PASSWORD> -e UPTIME_KUMA_2FA_TOKEN=<UPTIME_KUMA_2FA_TOKEN> -e UPTIME_KUMA_JWT_TOKEN=<UPTIME_KUMA_JWT_TOKEN> mcp-uptime-kuma npx -y @davidfuchs/mcp-uptime-kumaВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-uptime-kuma
Как установить mcp-uptime-kuma в Claude Code?
Запустите команду: `claude mcp add --env UPTIME_KUMA_URL=<UPTIME_KUMA_URL> --env UPTIME_KUMA_USERNAME=<UPTIME_KUMA_USERNAME> --env UPTIME_KUMA_PASSWORD=<UPTIME_KUMA_PASSWORD> --env UPTIME_KUMA_2FA_TOKEN=<UPTIME_KUMA_2FA_TOKEN> --env UPTIME_KUMA_JWT_TOKEN=<UPTIME_KUMA_JWT_TOKEN> --transport stdio mcp-uptime-kuma -- npx -y @davidfuchs/mcp-uptime-kuma`. Подставьте в переменные адрес вашего инстанса и учётные данные.
С какими версиями Uptime Kuma совместим сервер?
Инструмент разработан исключительно под Uptime Kuma 2. С предыдущими версиями системы мониторинга интеграция не заработает из-за отличий в API.
Какие способы авторизации поддерживаются?
Подключение настраивается через логин и пароль с поддержкой 2FA либо через JWT-токен в переменных окружения.
