返回 MCP 目录
public公开dns本地运行

uptime-kuma-mcp-server

一个通过MCP协议管理Uptime Kuma监控的服务端工具,支持批量添加、查询和删除监控项。

article

README

🚀 Uptime Kuma MCP 服务器

Uptime Kuma MCP 服务器用于管理 Uptime Kuma 监控的 MCP 协议,能有效提升监控管理效率,为用户提供便捷的监控管理体验。

🚀 快速开始

Uptime Kuma MCP 服务器可帮助你高效管理 Uptime Kuma 的监控任务。下面将为你介绍安装和使用的相关信息。

📦 安装指南

你可以通过以下命令进行安装:

uvx uptime-kuma-mcp-server

同时,需要在配置文件中添加如下配置:

"mcpServers": {
  "uptime-kuma-mcp-server": {
    "command": "uvx",
    "args": ["uptime-kuma-mcp-server"],
    "env": {
      "KUMA_URL": "https://yourdomain.xyz",
      "KUMA_USERNAME": "username",
      "KUMA_PASSWORD": "passwd"
    }
  },
}

📚 详细文档

可用工具

本服务器提供了以下几个实用工具:

  • add_monitors - 批量添加多个监控到 Uptime Kuma,完成后返回 Uptime Kuma 页面 URL
    • urls (list[str], 必填): 监控 URL 列表(必须去重并包含完整协议,例如https://bing.com)
  • get_monitors - 获取所有监控列表,返回精简字段以防止上下文溢出
  • delete_monitors - 批量删除多个监控
    • ids (list[int], 必填): 要删除的监控 ID 列表

💻 使用示例

基础用法

以下是运行 SSE 的示例代码:

# run_sse.py

from uptime_kuma_mcp_server import run_sse

run_sse()

# 在0.0.0.0:8000运行Uvicorn
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端