silentwatch-mcp

Обнаруживайте сбои cron, о которых молчит ваш мониторинг. MCP-сервер, который предоставляет данные о состоянии запланированных заданий — запуски, просроченные задания и «тихие сбои», которые завершаются с кодом 0, но не дают полезного результата — любому агенту Claude или клиенту с поддержкой MCP. Работает «из коробки» с планировщиками OpenClaw, системным cron и таймерами systemd.

Что он делает

Каждая команда, запускающая запланированные задания, сталкивалась хотя бы с одним из этих случаев:

• Тихий сбой — задание выполнилось, вернуло код выхода 0, но не произвело полезного вывода (cron для веб-поиска вернул пустоту, бэкап записал файл размером 0 байт, дайджест-рассылка отправилась с <no rows> в теле письма). Традиционный мониторинг видит «зеленую галочку», но данные все равно повреждены.

• Просрочка без оповещения — задание не запускалось 3 дня; никто не заметил, потому что никто не следил.

• Дрейф последнего успешного запуска — задание запускается каждый час, но за последние 12 попыток успешно выполнилось лишь однажды; все считают, что оно в порядке, так как последний запуск был «зеленым».

• Разрыв в журнале аудита — вам нужно знать, когда конкретное задание завершилось в последний раз для проверки соответствия требованиям, а единственный «лог» — это вывод journalctl, который был ротирован на прошлой неделе.

silentwatch-mcp предоставляет эту видимость в виде инструментов MCP, которые ваш ИИ-агент может запрашивать напрямую. Никаких метрических конвейеров, отдельных дашбордов или подписок SaaS.

> claude: which of my cron jobs have silent failures in the last 24 hours?
[MCP tool: find_silent_failures]
3 jobs flagged:
  • web-search-refresh — ran 12× successfully but output empty in 8 (66% silent fail rate)
  • daily-summary — ran 1× successfully (24× expected); output normal
  • audit-snapshot — last success 5 days ago, all subsequent runs returned exit 0 with empty body

Почему silentwatch-mcp

Три вещи, которые не делают существующие инструменты (Cronitor, Healthchecks.io, Datadog, Prometheus):

1. Обнаружение тихих сбоев, а не только кодов выхода. Традиционный мониторинг cron предполагает, что exit 0 = успех. Мы проверяем вывод на основе настраиваемых правил: пустой вывод, аномалия длины по сравнению с исторической медианой, ключевые слова ошибки в stdout, несмотря на код 0, аномалия длительности. Задание, которое «успешно выполнилось», но не вернуло ничего полезного — это именно тот тип сбоя, который может скрываться неделями. Мы его находим.

2. MCP-native, без слоя интеграции. Claude Desktop, Cline, Continue, агенты OpenClaw — любой клиент с поддержкой MCP запрашивает данные напрямую. Никаких плагинов Grafana, API-оберток или ручного разбора JSON.

3. Мульти-источник «из коробки». Логи OpenClaw в формате JSONL, системный crontab (/etc/crontab + /etc/cron.d/* + crontab -l для пользователя) и таймеры systemd (systemctl list-timers + journalctl) — все четыре бэкенда поставляются в v0.3, поэтому вы можете запустить silentwatch-mcp с любым планировщиком, который у вас есть. Никакой привязки к поставщику.

Создан для SMB-хостеров, запускающих VPS за $40, где Datadog — это излишество, а «бесплатный open-source MCP» — подходящая ценовая категория, хотя обнаружение тихих сбоев столь же ценно и на корпоративной инфраструктуре.

Инструментарий

Сервер регистрирует следующие инструменты MCP (полная спецификация в SPEC.md):

Ресурсы:

• cron://jobs — список всех заданий (манифест)

• cron://job/{id} — манифест отдельного задания + недавние запуски

• cron://run/{id} — экземпляр отдельного запуска с полным выводом

Промпты:

• diagnose-overdue — шаблон промпта для диагностики просроченного задания

• summarize-cron-health — ежедневный дайджест активности cron + аномалии

Быстрый старт

v0.3 beta — все 4 бэкенда включены + реальное обнаружение просрочек через парсинг расписания cron (croniter). Бэкенды Mock, OpenClaw JSONL, crontab и systemd готовы к промышленному использованию. 74 теста пройдены. v1.0 — это полировка: релиз в PyPI + GitHub Actions CI + отправка в реестр MCP.

Установка

pip install silentwatch-mcp  # not yet on PyPI; install from source for now:
pip install -e .

Настройка для Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "silentwatch": {
      "command": "python",
      "args": ["-m", "silentwatch_mcp"],
      "env": {
        "SILENTWATCH_BACKEND": "mock"
      }
    }
  }
}

Бэкенды (все четыре поставляются начиная с v0.3):

• SILENTWATCH_BACKEND=mock — возвращает примеры данных (по умолчанию для разработки)

• SILENTWATCH_BACKEND=openclaw-jsonl — парсит нативные файлы логов OpenClaw в формате JSONL (установите SILENTWATCH_OPENCLAW_LOGS в директорию, по умолчанию ~/.openclaw/cron-runs/); самые богатые данные — полная история запусков + обнаружение тихих сбоев

• SILENTWATCH_BACKEND=crontab — парсит /etc/crontab + /etc/cron.d/* + пользовательские crontab (crontab -l); время последнего запуска берется из /var/log/syslog или /var/log/cron (установите SILENTWATCH_SYSLOG для переопределения)

• SILENTWATCH_BACKEND=systemd — парсит systemctl list-timers --all --output=json + journalctl -u <unit> для истории запусков; извлекает OnCalendar= в поле расписания

Все бэкенды, кроме mock, корректно возвращают пустые результаты на платформах/хостах, где отсутствуют соответствующие инструменты, поэтому конфигурацию можно безопасно оставлять во всех окружениях.

Перезапустите Claude Desktop

Сервер регистрируется как silentwatch. Проверка:

Покажи мне все мои задания cron и статус их последнего запуска.

Дорожная карта

Нужно адаптировать под ваш стек?

silentwatch-mcp поставляется с 4 бэкендами (mock, OpenClaw JSONL, crontab, systemd). Если ваш планировщик — это что-то другое (AWS EventBridge, GCP Cloud Scheduler, Hangfire, Sidekiq, Temporal, Apache Airflow, Prefect, Dagster или кастомный исполнитель заданий), и вы хотите получить такую же видимость обнаружения тихих сбоев через MCP, это задача для Custom MCP Build.

Для заказа:

1. Напишите на admin@pixelette.tech с темой Custom MCP Build inquiry

2. Включите: описание вашего стека планировщиков в 1 абзаце + какой уровень вы рассматриваете

3. Ответ в течение 2 рабочих дней с предложением 30-минутного звонка для обсуждения

Этот сервер также является частью AI Production Discipline Framework — методологии, лежащей в основе проводимых мной аудитов ИИ в продакшене.

Аудиты ИИ в продакшене

Если вы используете ИИ в продакшене и хотите, чтобы сторонний специалист оценил готовность, нашел существующие паттерны сбоев и составил план корректирующих действий — это то, для поддержки чего создан данный MCP. Услуги аудита:

Тот же email: admin@pixelette.tech с темой AI audit inquiry.

Вклад в проект

PR приветствуются. Структура намеренно плоская, чтобы упростить добавление кастомных бэкендов — см. src/silentwatch_mcp/backends/ для примеров.

Чтобы добавить новый бэкенд:

1. Создайте подкласс CronBackend в backends/<ваш_бэкенд>.py

2. Реализуйте list_jobs, get_job_runs, tail_logs

3. Зарегистрируйте в backends/__init__.py

4. Добавьте тесты в tests/test_backend_<ваш_бэкенд>.py

Отчеты об ошибках и запросы функций: открывайте issue на GitHub.

Лицензия

MIT — см. LICENSE.

Похожие проекты

• AI Production Discipline Framework — шаблон Notion, $29

• SPEC.md — полный дизайн сервера

• Model Context Protocol — обзор протокола

Создано Temur Khan — независимым специалистом по ИИ-системам в продакшене. Контакт: admin@pixelette.tech