UptimeRobot MCP

面向 AI Agent 的 UptimeRobot

此仓库是 UptimeRobot 中 AI Agent 集成的唯一事实来源。它发布以下内容：

• **llms.txt** 和 **AGENTS.md** — 为大模型和编码 Agent 提供发现与入门信息。
• **.claude-plugin/**、**.cursor-plugin/**** 和 ****.codex-plugin/** — 可安装的插件清单，适用于 Claude Code、Cursor 和 Codex。
• **skills/** — 独立的技能文件，涵盖每个 UptimeRobot MCP 工具，以及入门和运行手册工作流。
• **rules/** — Cursor 和 Claude Code 共用的规则。
• **mcp.json** — Cursor 格式的 MCP 服务配置（不带点的文件名）。
• **.mcp.json** — Claude Code MCP 服务配置（文件名前缀为点，以便 Claude Code 在插件加载时自动注册服务）。
• **codex.mcp.json** — Codex 格式的 MCP 服务配置（使用 mcp_servers 蛇形命名键，由 Codex 清单显式引用）。
• **.agents/plugins/marketplace.json** — 仓库范围的 Codex 市场，用于本地安装和测试；打开仓库时，Codex 会自动发现此文件。
• **assets/logo.png** — 市场徽标，在 Cursor 和 Codex 清单中声明为 icon（Claude Code 的插件清单没有图标字段；提交时，目录列表会提供其图标）。

mcp.json、.mcp.json 和 codex.mcp.json 文件都会注册同一个 mcp-remote 启动器，它会代理到 https://mcp.uptimerobot.com/mcp 并运行 OAuth 浏览器流程。这三个文件名仅因 Claude Code、Cursor 和 Codex 各自使用不同约定而存在（且 Codex 要求使用蛇形命名的 mcp_servers，而非 mcpServers）。

相同内容也镜像到了 uptimerobot.com/ 下，供爬虫发现（uptimerobot.com/llms.txt、uptimerobot.com/AGENTS.md 等）。

安装

Claude Code

从市场安装（发布后）

UptimeRobot 正在提交至 Anthropic 的社区插件市场。获批后，添加一次该市场，然后安装：

/plugin marketplace add anthropics/claude-plugins-community
/plugin install uptimerobot@claude-community

或者运行 /plugin，打开 Discover 选项卡，找到 UptimeRobot 并安装。（必须先添加社区市场——它不是内置市场。无需进行任何设置时，/plugin 中只会显示 Anthropic 精选的官方市场。）

插件加载后，会通过 .mcp.json 自动注册 MCP 服务。首次连接时，浏览器会打开，你可以登录 UptimeRobot 并授权访问（OAuth）——无需粘贴 API 密钥。令牌会缓存在本地，因此只需执行一次。

本地克隆（手动安装插件）

若要直接从本地检出完整运行插件（技能、规则、命令和自动注册的 MCP 服务），无需市场，请克隆仓库并使用 --plugin-dir 标志加载：

git clone https://github.com/uptimerobot/ai.git
claude --plugin-dir ./ai

--plugin-dir <path> 会从目录（包含 .claude-plugin/plugin.json 的目录）加载插件，且仅对当前会话生效。该标志可以重复使用，也接受 .zip 文件。如果你从其他位置启动 Claude Code，请使用绝对路径：

claude --plugin-dir /absolute/path/to/ai

首次连接时，浏览器会打开以运行 OAuth 流程。运行 /plugin，确认插件已加载，并且 uptimerobot MCP Server 显示 ✓ connected。

仅安装 MCP 服务（脚本方式）

如果你只需要 MCP 工具，不需要插件的其余部分（点文件、CI 引导），请参阅 [skills/setup/SKILL.md](skills/setup/SKILL.md)。简要步骤：

claude mcp add uptimerobot -- npx -y mcp-remote@latest https://mcp.uptimerobot.com/mcp

然后退出并重新启动 Claude Code，并在浏览器流程出现时完成 OAuth。运行 /plugin，确认 uptimerobot MCP Server 显示 ✓ connected。

Cursor

从 Marketplace 安装（发布后）

浏览 Cursor Marketplace，找到 UptimeRobot，然后点击 Add to Cursor。MCP 服务首次连接时，通过 OAuth 浏览器流程授权——无需 API 密钥。

本地安装（用于开发和提交前测试）

按照 Cursor 的插件文档操作：

# Clone or symlink this repo into Cursor's local plugin folder
git clone https://github.com/uptimerobot/ai.git ~/.cursor/plugins/local/uptimerobot-ai

启动 Cursor，然后从命令面板运行 Developer: Reload Window。

确认插件已被发现：

• Settings → Rules, Skills, Subagents — 应列出 uptimerobot.mdc 规则和每个 skills/*/SKILL.md 条目。
• Settings → Tools & MCPs — MCP 服务连接后，应显示包含 32 个工具的 uptimerobot。首次连接时，请完成 OAuth 浏览器流程。

Codex

本地安装（用于开发和提交前测试）

克隆此仓库并在 Codex 中打开。仓库范围的市场目录 .agents/plugins/marketplace.json 会自动被发现，因此无需额外设置，UptimeRobot (local) 就会显示在 Codex 插件目录中。安装插件，然后在首次 MCP 连接时完成 OAuth 浏览器流程。

如果希望 Codex 明确跟踪源代码：

codex plugin marketplace add ./

确认插件已加载：应可使用 24 个技能；连接后，应显示包含 32 个工具的 uptimerobot MCP 服务。

其他 Agent / 直接使用 MCP

该服务已在 官方 MCP Registry 中列出，名称为 com.uptimerobot/uptimerobot，因此任何支持注册表的客户端都可以发现并安装它，无需单独提交插件。元数据位于 server.json：

curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.uptimerobot/uptimerobot"

不支持注册表的客户端可以通过同一个 mcp-remote 启动器连接（首次使用时需进行 OAuth 验证）：

{
  "mcpServers": {
    "uptimerobot": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.uptimerobot.com/mcp"]
    }
  }
}

无头模式 / CI（无需浏览器）

如果无法运行 OAuth 浏览器流程，请改用来自控制台（Integrations & API）的 Main API key，通过普通 HTTP 连接：

{
  "mcpServers": {
    "uptimerobot": {
      "type": "http",
      "url": "https://mcp.uptimerobot.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

插件提供的功能

通过 MCP 提供 32 个工具，按资源分组 — 完整列表和负载见 [AGENTS.md](AGENTS.md) 和 [skills/](skills/)：

监控器

工具	用途
create-monitor	创建 HTTP、KEYWORD、PING、PORT、HEARTBEAT、DNS、API 或 UDP 监控器
update-monitor	更改名称、URL、间隔、警报联系人、标签和 HTTP 设置
update-monitor-status	暂停或恢复监控器
list-monitors	支持分页的列表，可按搜索条件和状态筛选
get-monitor-details	获取单个监控器的完整配置和当前状态
get-monitor-stats	汇总正常、故障和暂停的监控器数量，以及正常运行时间百分比
get-response-times	按时间序列提供响应时间数据和时间段

监控器组（受计划限制：monitor-groups）

工具	用途
create-monitor-group	创建监控器组并将监控器分配到其中
update-monitor-group	重命名现有监控器组
get-monitor-group	按 ID 获取单个监控器组
list-monitor-groups	支持分页的监控器组列表

状态页（PSP）

工具	用途
create-psp	根据监控器、监控器组或标签创建公开状态页
update-psp	更改名称、域名、排序顺序、可见性或发布状态
get-psp	按 ID 获取单个状态页
list-psps	支持分页的状态页列表

PSP 公告

工具	用途
create-psp-announcement	在状态页发布公告（信息／维护／问题）
update-psp-announcement	编辑标题、内容、日期、类型或发布状态
pin-psp-announcement	将公告置顶
unpin-psp-announcement	取消公告置顶
get-psp-announcement	按 ID 获取单条公告
list-psp-announcements	分页列出状态页公告

维护时段（需要相应套餐：maintenance-window）

工具	用途
create-maintenance-window	安排一次性或定期维护时段，以抑制警报
update-maintenance-window	更改计划、持续时间、监控项，或暂停／恢复维护时段
get-maintenance-window	按 ID 获取单个维护时段
list-maintenance-windows	分页列出维护时段

事件

工具	用途
list-incidents	列出各监控项的事件，并可按时间范围和监控项筛选
get-incident-details	获取单个事件的检查器位置、日志和 traceroute

事件评论（需要相应套餐：incident-comments）

工具	用途
create-incident-comment	为事件添加评论
update-incident-comment	编辑现有评论
list-incident-comments	分页列出事件评论

集成与标签

工具	用途
list-integrations	可用的警报联系人集成
list-tags	分页列出账户中的标签

无需账户

quick-monitor-setup 技能只需提供某人的电子邮件地址，即可创建免费的 HTTPS 监控项，无需账户、API 密钥或 OAuth：Agent 会调用未经身份验证的工作量证明 API，所有者则通过点击激活邮件中的链接进行确认。指南：https://uptimerobot.com/quick-monitor-setup/.

套餐要求

UptimeRobot 套餐包括 Free、Solo、Team、Enterprise。监控类型的可用性、最短间隔和监控项数量限制取决于当前套餐 — MCP 服务会强制执行这些限制；如果调用会超出限制，则返回错误代码 -28002（subscription_limit_exceeded）。请参阅 [skills/errors/SKILL.md](skills/errors/SKILL.md)。

故障排除

Claude / Cursor 中未显示工具

MCP 握手有时会在客户端于会话启动时获取工具列表之后才完成，因此即使服务已连接，工具也可能不会显示。解决方法：完全退出客户端（关闭终端，而不只是运行 /exit），然后重新启动。重新启动前，运行 claude mcp list，确认 uptimerobot 显示 ✓ Connected。

身份验证问题

症状	解决方法
OAuth 浏览器未打开	复制 mcp-remote 在终端中输出的授权 URL，然后手动打开
工具返回 -31001 user_not_found	使用 rm -rf ~/.mcp-auth 清除缓存令牌，然后完全退出并重新启动，以重新运行 OAuth 流程
写入工具返回 -31002 access_denied	使用具有写入权限的账户重新进行身份验证（rm -rf ~/.mcp-auth）

API 错误代码

代码	含义	处理方法
-28001	已达到监控项上限	删除未使用的监控项，或升级套餐
-28002	订阅上限	当前间隔对于你的套餐过于激进，或套餐不包含此监控类型 — 放宽间隔或升级
-29001	参数无效	错误消息会指出有问题的字段；修正后重试
-31001	身份验证失败	请参阅上文的身份验证问题
HTTP 429	请求速率受限	等待一段时间后，以指数级延迟重试

完整的错误参考和恢复方法请参阅 skills/errors/SKILL.md。

贡献

此仓库由程序生成／整理。请在 https://github.com/uptimerobot/ai/issues 提交问题。对于 MCP 服务错误，请使用 https://uptimerobot.com/contact。

隐私与条款

• 隐私政策
• 服务条款

许可证

MIT。请参阅 LICENSE。