system-status

Hermes-style ops agent: monitors Ubuntu / Docker / public IP, and pushes alerts to Feishu.

Features

• 🐳 Docker monitoring: container status, restart counts, CPU/memory, health checks

• 🖥️ System monitoring: CPU, memory, disk, load

• 🌐 Public IP drift detection: multi-source validation, alert on change

• 💬 Feishu alerts: rich-text card + @ specific members

• 📊 SQLite history: every sample is stored, kept for 7 days by default

• 🖼️ Web panel: real-time dashboard + trend charts + alert stream

  • Just open http://localhost:8080/web/

• 🌐 HTTP / MCP endpoints: for Hermes / clients to call

  • 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

Quick Start

1. Create a Feishu bot

Group chat → Settings → Group Bot → Add → Custom Bot → get the Webhook and Secret

2. Configure environment variables

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

3. Start

docker compose up -d

4. Verify

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

Configuration

.env:

Integrate with Hermes

Hermes can call these endpoints directly through the HTTP MCP. Add this to the Hermes config:

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 }

Then you can say to Hermes:

“List all exited containers” “Restart mysql-01” “What is the current public IP?” “How is the system health?”

Project Structure

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

Alert Cooldown

By default, alerts of the same type are not pushed repeatedly within 5 minutes (to avoid alert storms). You can adjust COOLDOWN_MS in src/monitor/loop.ts.

Security Notes

• ⚠️ docker.sock is equivalent to root privileges; be sure to use :ro read-only

• ⚠️ The container has privileged: true; evaluate the risk before using in production

• ⚠e Do not commit the Feishhu Webhook to Git