服务器监控管理工具

MCP server for Uptime Kuma v2,提供对监控器、通知、标签、状态页面和维护的全面CRUD操作。

  • by neverprepared
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 neverprepared/kuma_uptime_mcp

使用说明

mcp正常运行时间kuma

MCP服务器 正常运行时间Kuma v2在监视器、通知、标签、状态页面和维护上具有完整的CRUD。

安装

uvx mcp-uptime-kuma

或者从PyPI安装:

pip install mcp-uptime-kuma

配置

设置以下环境变量:

变量 必填 描述
UPTIME_KUMA_URL 是 正常运行时间Kuma实例URL(例如。, http://localhost:3001)
UPTIME_KUMA_USERNAME 是* 管理员用户名
UPTIME_KUMA_PASSWORD 是* 管理员密码
UPTIME_KUMA_TOKEN 否 JWT令牌(用户名/密码的替代品)
UPTIME_KUMA_MFA_TOKEN 无 2FA代码(仅适用于启用2FA的初始登录)

*除非满足以下条件,否则必须 UPTIME_KUMA_TOKEN 提供。

Claude代码集成

claude mcp add-json uptime-kuma '{
  "command": "uvx",
  "args": ["mcp-uptime-kuma"],
  "env": {
    "UPTIME_KUMA_URL": "http://localhost:3001",
    "UPTIME_KUMA_USERNAME": "admin",
    "UPTIME_KUMA_PASSWORD": "your-password"
  }
}'

工具

监视器(7个工具)

  • list_monitors --列出所有带有可选过滤器的监视器
  • get_monitor --获取详细的监视器配置和状态
  • create_monitor --创建一个新的监视器(http、tcp、ping、dns、docker、push等)
  • edit_monitor --更新监视器配置
  • delete_monitor --删除监视器
  • pause_monitor --暂停显示器
  • resume_monitor --恢复暂停的监视器

通知(6个工具)

  • list_notifications --列出所有通知提供程序
  • get_notification --获取通知提供程序详细信息
  • create_notification --创建通知提供程序(电报、松弛、不协调、电子邮件、webhook等)
  • edit_notification --更新通知提供程序
  • delete_notification --删除通知提供程序
  • test_notification --测试通知配置

标签(7工具)

  • list_tags --列出所有标签
  • get_tag --获取标签详细信息
  • create_tag --创建标签
  • edit_tag --更新标签
  • delete_tag --删除标签
  • add_monitor_tag --向监视器添加标签
  • remove_monitor_tag --从显示器上删除标签

状态页面(5个工具)

  • list_status_pages --列出所有状态页面
  • get_status_page --获取状态页面详细信息
  • create_status_page --创建状态页面
  • save_status_page --更新状态页面
  • delete_status_page --删除状态页

维护(7个工具)

  • list_maintenances --列出所有维护窗口
  • get_maintenance --获取维护详细信息
  • create_maintenance --创建维护窗口
  • edit_maintenance --更新维护窗口
  • delete_maintenance --删除维护窗口
  • pause_maintenance --暂停维护窗口
  • resume_maintenance --恢复维护窗口

系统(6个工具)

  • get_server_info --获取Uptime Kuma服务器版本和设置
  • get_monitor_beats --获取监护仪的心跳历史记录
  • get_monitor_avg_ping --获取显示器的平均ping值
  • get_monitor_uptime --获取监视器的正常运行时间百分比
  • get_monitor_cert_info --获取TLS/SSL证书信息
  • get_database_size --获取数据库大小

许可证

麻省理工学院