system-status

Hermes-стиль ops-агент:мониторинг Ubuntu / Docker / публичного IP,оповещения в Feishu.

Возможности

• 🐳 Мониторинг Docker:состояние контейнеров, количество перезапусков, CPU/память, проверки здоровья

• 🖥️ Мониторинг системы:CPU, память, диск, нагрузка

• 🌐 Обнаружение смены публичного IP:проверка из нескольких источников, оповещение об изменениях

• 💬 Оповещения в Feishu:карточки с форматированным текстом + @упоминание указанных лиц

• 📊 Исторические данные в SQLite:сохранение каждой выборки в базу, по умолчанию хранится 7 дней

• 🖼️ Веб-панель:дашборд в реальном времени + графики трендов + поток оповещений

  • Откройте http://localhost:8080/web/

• 🌐 HTTP / MCP интерфейс:для вызова из Hermes / клиентов

  • GET /health

  • GET /api/docker/containers

  • POST /api/docker/restart

  • GET /api/system

  • GET /api/ip

  • GET /api/dashboard

  • GET /api/history/system?minutes=60

  • GET /api/history/ip

  • GET /api/alerts/recent

  • GET /mcp/tools

Related MCP server: 6amdev-server-mcp

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

1. Создайте бота в Feishu

Групповой чат → Настройки → Групповые боты → Добавить → Пользовательский бот → получите Webhook и Secret

2. Настройте переменные окружения

cp .env.example .env
# 编辑 .env,填入飞书 webhook 和 secret

3. Запуск

docker compose up -d

4. Проверка

curl http://localhost:8080/health
curl http://localhost:8080/api/docker/containers
curl http://localhost:8080/api/system
curl http://localhost:8080/api/ip

Описание конфигурации

.env:

Подключение к Hermes

Hermes может напрямую вызывать эти конечные точки через HTTP MCP. Добавьте в конфигурацию Hermes:

mcp_servers:
  - name: system-status
    type: http
    base_url: http://localhost:8080
    tools:
      - name: list_containers
        method: GET
        path: /api/docker/containers
      - name: system_health
        method: GET
        path: /api/system
      - name: check_public_ip
        method: GET
        path: /api/ip
      - name: restart_container
        method: POST
        path: /api/docker/restart
        body_schema:
          type: object
          properties:
            name: { type: string }

Затем вы можете сказать Hermes:

"Перечисли все остановленные контейнеры" "Перезапусти mysql-01" "Какой сейчас публичный IP?" "Насколько здорова система?"

Структура проекта

system-status/
├── src/
│   ├── index.ts            # 入口
│   ├── config.ts           # 配置加载
│   ├── mcp/server.ts       # HTTP / MCP 接口
│   ├── monitor/
│   │   ├── docker.ts       # Docker 监控
│   │   ├── system.ts       # 系统监控
│   │   ├── ip.ts           # 公网 IP 检测
│   │   └── loop.ts         # 监控主循环
│   └── alert/
│       ├── feishu.ts       # 飞书 Webhook + 签名
│       └── templates.ts    # 告警模板
├── config/rules.yaml       # 告警规则
├── Dockerfile
├── docker-compose.yml
└── .env.example

Охлаждение оповещений

Однотипные оповещения по умолчанию не повторяются в течение 5 минут (во избежание шторма оповещений). Можно настроить COOLDOWN_MS в src/monitor/loop.ts.

Замечания по безопасности

• ⚠️ docker.sock равнозначен правам root, обязательно монтируйте только для чтения :ro

• ⚠️ Контейнер запущен с privileged: true, в production оцените риски

• ⚠️ Не коммитьте Webhook Feishu в Git