MCP Uptime Kuma Open


mcp正常运行时间kuma打开

这是我们Uptime Kuma MCP服务器的开放版本。 它对个人和小公司开放 可以在内部自由使用它进行操作。有关更多信息，请参阅我们的许可证。 此版本在BSL许可证下发布。我们确实提供了一个托管解决方案，其中包含更多 封闭源代码版本中内置的功能。如果你想要更高级的版本， 请通过hello（at）gryfai.com与我们联系

存储库仍然处于活动状态，我们将不断添加。 我们痛苦地意识到我们缺乏测试，但我们已经与几个客户进行了测试。 一切都好！编写测试是我们议程上的下一件事。

开放版本

此版本公开了一组有限但有用的工具来进行交互 通过您最喜欢的LLM工具查看Kuma的正常运行时间。

此服务器提供以下功能：

• 检索所有和个人的监视器状态
• 获取监视器节拍
• 检索所有通知和个人通知
• 检索所有和个人状态页面
• 心跳恢复
• 检索所有和单个标签
• 检索数据库大小
• 状态页面维护检索。

所有这些在开放版本中都是只读的。

我们将在BSL下发布此开放版本，并在未来将许可证更改为Apache 2.0。 既为您提供出色的工具，又确保我们投入的时间和精力 维护这个存储库没有被滥用。 当然，你可以自己开发一个与之竞争的开源服务。我们鼓励竞争和开源。 我们只是在规范代码库，这样我们的代码库就不会被用于竞争对手的SaaS或其他项目中以获得金钱收益。

想要更多吗？

GryfAi有一个更强大的版本，可以通过我们的解决方案托管。 它包括以下功能

• 添加、编辑和删除监视器
• 添加、编辑和删除通知
• 添加、编辑和删除标签
• 维护功能
• Docker功能
• API-密钥管理
• 代理管理

请通过以下方式联系我们：hello（at）gryfai.com

先决条件

此项目使用 uv 作为其构建系统。请确保您有 uv 或 pip 安装。您可以安装 uv 与：

pip install uv

安装和使用（最终用户）。

在本地安装，设置环境变量，然后让MCP客户端启动STDIO服务器。除非进行调试，否则通常不需要手动运行它。

1. 创建并激活虚拟环境（Python 3.10+）。

- 通过运行以下命令检查Python版本 python3 --version。如果你没有Python 3.10或更高版本，可以从 Python官方网站. - 要创建虚拟环境，请从项目目录的根目录运行以下命令： python3 -m venv .venv - 要激活虚拟环境，请根据您的操作系统运行以下命令之一： - Linux/macOS： source .venv/bin/activate - 窗户： .venv\Scripts\activate - 当虚拟环境被激活时，你的shell提示符通常会改变以显示虚拟环境的名称（例如。， (.venv) user@host:...$).

1. 将软件包安装到该venv中： pip install . （或 uv pip install .).

- 此命令需要从项目目录的根目录运行。

1. 为Uptime Kuma实例配置环境变量：

- UPTIME_KUMA_URL （默认值： http://localhost:3001) - UPTIME_KUMA_USERNAME - UPTIME_KUMA_PASSWORD - 您可以在shell中设置这些环境变量，也可以创建 .env 将它们添加到项目目录的根目录中。例如：

     UPTIME_KUMA_URL=http://localhost:3001
     UPTIME_KUMA_USERNAME=my-username
     UPTIME_KUMA_PASSWORD=my-password

- 注： 如果您正在使用 .env 文件，服务器将自动从中加载环境变量。

1. 将MCP客户端指向该命令 python -m mcp_uptime_kuma_open.server （示例如下）。

- 如果您的MCP客户端在同一虚拟环境中运行，则可以使用以下命令 python -m mcp_uptime_kuma_open.server. - 如果您的MCP客户端在虚拟环境之外运行，则需要提供虚拟环境中Python可执行文件的完整路径。您可以通过运行以下命令找到完整路径 which python （在Linux/macOS上）或 where python （在Windows上）激活虚拟环境时。例如： .venv/bin/python -m mcp_uptime_kuma_open.server. - 使用时 mcp add 命令，确保虚拟环境已激活，或提供Python可执行文件的完整路径。

客户端注释（全部使用STDIO；密钥与当前客户端文档匹配）：

双子座命令行界面

• 建议添加服务器的方法是运行以下命令：

gemini mcp add uptime-kuma python -m mcp_uptime_kuma_open.server

• 重新启动或重新加载CLI，使其拾取新服务器。
• 或者，您可以在Gemini CLI MCP配置中添加服务器条目(mcpServers 在 ~/.gemini/settings.json):

{
  "mcpServers": {
    "uptime-kuma": {
      "command": "python",
      "args": ["-m", "mcp_uptime_kuma_open.server"]
    }
  }
}

Codex CLI

• 建议添加服务器的方法是运行以下命令：

codex mcp add uptime-kuma python -m mcp_uptime_kuma_open.server

• 重新启动或重新加载CLI，使其拾取新服务器。
• 或者，您可以在Codex配置中添加STDIO服务器条目(~/.codex/config.toml):

[mcp_servers.uptime-kuma]
command = "python"
args = ["-m", "mcp_uptime_kuma_open.server"]

• 保存并重新启动Codex CLI以加载服务器。

Claude CLI

• 将MCP服务器添加到Claude CLI配置中(~/.claude.json).建议使用 claude mcp add 命令。
• 如果手动编辑文件，请将以下内容添加到 mcpServers 对象：

{
  "mcpServers": {
    "uptime-kuma": {
      "command": "python -m mcp_uptime_kuma_open.server"
    }
  }
}

• 跑 claude 正常；它将自动启动STDIO服务器。

克劳德桌面

• 添加MCP服务器的推荐方法是将其作为扩展安装(.mcpb 文件）或直接编辑配置文件。
• 配置文件位于：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

• 如果手动编辑文件，请将以下内容添加到 mcpServers 对象：

{
  "mcpServers": {
    "uptime-kuma": {
      "command": "
/mcp-uptime-kuma-open/.venv/bin/python",
      "args": ["-m", "mcp_uptime_kuma_open.server"]
    }
  }
}

• 添加服务器后，您必须重新启动Claude Desktop应用程序。

我们还提供了一个商业HTTP/SSE版本，可以提供更好的性能。请在提供的许可证下使用开放的STDIO版本，如果您更喜欢托管HTTP/SSE选项，请与我们联系。

我们知道，如果你直接在venv中运行，一些客户有时会表现得更好。