hyperping

Hyperping MCP 服务

面向 Hyperping 的官方 Model Context Protocol 服务。它通过 HTTP 向 AI Agent 提供正常运行时间监控、事件历史、值班计划和报告。

这是一个远程服务。无需安装或自行托管：使用 API 密钥将客户端指向该端点即可。此仓库包含注册清单、客户端配置和工具参考。

完整文档：hyperping.com/docs/mcp

端点

URL	https://api.hyperping.io/v1/mcp
传输方式	Streamable HTTP，JSON-RPC 2.0
身份验证	Bearer 令牌
作用范围	每个密钥对应一个项目
工具	26 个（22 个只读，4 个写入）

快速开始

1. 在 Hyperping 中，前往 Project Settings, API Keys，创建一个 read_only 或 read_write 密钥。
2. 将服务添加到 MCP 客户端（见下文）。
3. 重启客户端，然后询问“现在有什么服务不可用？”或“上个月 API 监控的正常运行时间是多少？”之类的问题。

Claude Desktop、Claude Code、Cursor、Windsurf

{
  "mcpServers": {
    "hyperping": {
      "type": "http",
      "url": "https://api.hyperping.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_..."
      }
    }
  }
}

stdio 客户端

仅支持 stdio 的客户端可以通过 mcp-remote 桥接：

{
  "mcpServers": {
    "hyperping": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.hyperping.io/v1/mcp",
        "--header",
        "Authorization: Bearer sk_..."
      ]
    }
  }
}

工具

监控项

工具	作用范围	描述
list_monitors	只读	分页列出监控项，可按 up、down、paused、ssl_expiring 筛选。
get_monitor	只读	按 UUID 获取单个监控项。
search_monitors_by_name	只读	对名称和 URL 进行不区分大小写的子字符串搜索。
create_monitor	写入	创建 HTTP、ICMP、端口或 DNS 监控项。
update_monitor	写入	更新监控项。未指定的字段将保留。
pause_monitor	写入	停止监控项的检查和告警。
resume_monitor	写入	恢复已暂停的监控项。

有意不提供 delete_monitor。请使用控制面板或 REST API。

状态和中断

工具	作用范围	描述
get_status_summary	只读	正常、不可用和已暂停的数量，以及当前不可用的项目和持续时间。
list_outages	只读	分页列出中断，可按状态、类型或搜索词筛选。
get_outage	只读	获取单个中断，包括确认记录、描述和根本原因。
get_outage_timeline	只读	检测、跨区域验证、告警发送、确认和解决。
get_monitor_outages	只读	获取单个监控项的中断记录。

报告

工具	作用范围	描述
get_monitor_uptime	只读	按小时、天、周或月统计指定时间段内的正常运行时间百分比。
get_monitor_response_time	只读	查看指定时间段内的延迟趋势。
get_monitor_mttr	只读	平均解决时间，单位为秒。
get_monitor_mtta	只读	平均确认时间，单位为秒。

诊断

工具	作用范围	描述
get_monitor_anomalies	只读	检测到的频繁切换、延迟峰值和其他异常。
get_monitor_http_logs	只读	最近的 HTTP 探测日志，可按级别筛选。
list_recent_alerts	只读	指定日期范围内的正常和不可用通知。

值班

工具	作用范围	描述
list_on_call_schedules	只读	列出所有计划，包括轮换配置和当前值班人员。
get_on_call_schedule	只读	获取单个计划，包括完整的轮换详情和关联策略。
list_escalation_policies	只读	列出项目中的所有升级策略。
get_escalation_policy	只读	获取单个策略，包括步骤顺序、计划和联系渠道。
list_team_members	只读	列出项目用户，以解析计划和策略中的 ID。

要回答“谁负责监控项 X 的值班？”，请依次调用 get_monitor、get_escalation_policy、get_on_call_schedule、list_team_members。

集成

工具	范围	描述
list_integrations	读取	Slack、Telegram、Discord、PagerDuty、OpsGenie、Teams、webhook 等。
get_integration	读取	单个集成及其特定渠道的配置。

速率限制

限制按项目执行，两个时间窗口均会生效。

方法	每分钟	每小时
initialize	5	20
tools/list	30	200
tools/call	60	600

打开一次会话并重复使用，不要为每个请求都调用 initialize。超过限制时会返回 JSON-RPC 错误，并附带 retry_after_seconds 提示。

机器可读规范

如需涵盖工具、查询模式和响应格式的详尽且便于 Agent 使用的规范，请将客户端指向 hyperping.com/mcp/llms.txt。

支持

请在此处提交问题，或通过 hyperping.com/contact/sales 联系团队。

许可证

本仓库内容采用 MIT 许可证。托管服务的使用受 Hyperping 条款 和隐私政策约束。