SuperAPI AI 工具集

kuma-operations

部署与运维

查看项目

更新于 10-16 01:31

技能介绍

用途:面向 Uptime Kuma v2 的监控项排查与安全变更操作,由 kuma-pp-cli 命令驱动,适合需要读取监控状态、事件上下文与心跳时间线,或在获得明确授权后调整重试次数的场景。

前置与安装:先确认 CLI 已安装,验证命令为 kuma-pp-cli --version。缺失时用 npx 安装:npx -y @mvanhorn/printing-press-library install kuma --cli-only(默认安装到 macOS/Linux 的 $HOME/.local/bin 或 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin),并确保该目录在 PATH 中。若 npx 失败,可改用 Go 直装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/monitoring/kuma/cmd/kuma-pp-cli@latest,其安装到 $GOPATH/bin。验证不通过前不要继续执行技能命令。

认证:凭据来自 UPTIME_KUMA_URL、UPTIME_KUMA_USERNAME、UPTIME_KUMA_PASSWORD;URL 必须为服务器源站(如 https://kuma.example.com),不能是仪表盘页面地址。

能力与用法:运行 kuma-pp-cli agent-context --pretty 获取全部命令、参数与认证变量的 JSON 描述,优于解析 --help。被标注 mcp:read-only 的命令可无人值守运行;set-retries 被标注 mcp:destructive。调查流程:kuma-pp-cli health;kuma-pp-cli monitors --json 获取监控 ID;kuma-pp-cli incident-context --monitor <id> --json;kuma-pp-cli heartbeats --monitor-id <id> --hours 3 --json 查看时间线。

变更与限制:set-retries 默认 dry-run,应审阅完整的监控更新提案,仅在明确授权时重复相同命令并加 --yes;不要臆造监控 ID,也不要在无关的重试变更中修改通知设置。该 CLI 是 Go Socket.IO 操作工具,不是原生 kumactl MCP 服务器;MCP 客户端需单独部署原生服务,可用 kumactl-mcp --transport streamable-http --host 127.0.0.1 --port 40108 --path /mcp 暴露端点,二者共用上述环境变量,但本包不含 kumactl 依赖或内置 MCP 传输。其他功能与限制资料未提供。