healthchecks-io-mcp

@digitalronin/healthchecks-io-mcp

非官方，与 Healthchecks.io 无关联。 这是第三方 MCP 服务，并非 Healthchecks.io 的官方产品。

这是什么

Healthchecks.io 是一种“死信开关”式的 监控服务：你的定时任务（cron 作业、备份、批处理脚本，以及任何应按计划运行的任务） 运行时会向它发送 ping；如果 ping 未能按时到达，Healthchecks.io 就会发出警报——这意味着任务在没有提示的情况下失败了，或根本没有运行。

此软件包是一个 MCP 服务——一个小型本地程序，让 AI 助手（例如 Claude）能够代表你与 Healthchecks.io 的 Management API 通信。设置完成后，你可以用自然语言向 AI 助手提出如下请求：“列出我的 Healthchecks.io 检查项”、“显示我的备份任务的 ping 历史记录”或 “暂停对我的预发布环境的监控”，它就会为你调用相应的 Healthchecks.io API 端点。

设置

1. 获取 Healthchecks.io API 密钥

1. 登录 healthchecks.io（或你的 可自托管实例，见下文）。
2. 转到项目的 Settings 页面，然后打开 API Access 标签页。
3. 你会看到两个密钥：只读密钥和读写密钥。
   • 只读密钥可以查询检查项，但不能创建、更改、暂停或删除任何内容。
   • 读写密钥除了能执行只读密钥的所有操作外，还可以创建、更新、暂停、恢复以及永久删除检查项。

2. 将此服务添加到 MCP 客户端配置中

你无需手动安装任何内容——首次使用时，npx 会自动下载并运行它。将此代码块添加到 MCP 客户端的配置中（对于 Claude Code，这是一个 .mcp.json 文件；其他客户端也有各自的配置文件或界面）：

{
  "mcpServers": {
    "healthchecks-io": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "your-key-here"
      }
    }
  }
}

将 "your-key-here" 替换为第 1 步获取的 API 密钥。保存后，重启 MCP 客户端（或重新加载其 MCP 连接）；大多数客户端只有在重启后才会加载新增或更改的服务。

3. 试用

连接后，只需向 AI 助手提出类似这样的请求：

• “列出我的所有 Healthchecks.io 检查项”
• “显示我的 nightly-backup 检查项的 ping 历史记录”
• “我的 staging-cron 检查项目前是否运行失败？”

如果它返回了你账户中的真实数据，就说明设置正确。

可选：多个项目

Healthchecks.io API 密钥的作用范围限定在单个项目，因此单个服务条目只能连接到一个项目。若要使用多个项目，请使用不同的名称多次注册此服务，并为每个条目配置各自的密钥：

{
  "mcpServers": {
    "healthchecks-io-personal": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "personal-project-key-here"
      }
    },
    "healthchecks-io-work": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "work-project-key-here"
      }
    }
  }
}

每个条目都会运行独立进程，并持有一个密钥；MCP 客户端会按服务名称为工具命名空间，因此你可以分辨工具调用针对的是哪个项目。

可选：自托管的 Healthchecks.io

Healthchecks.io 是开源软件，有些人会自行运行实例，而不是使用 healthchecks.io 上托管的 SaaS 服务。如果你属于这种情况，请添加第二个环境变量，指向你实例的 API 根地址：

"env": {
  "HEALTHCHECKS_API_KEY": "your-key-here",
  "HEALTHCHECKS_BASE_URL": "https://monitoring.example.com/api/v3"
}

URL 必须是完整的 API 根地址，包括 /api/v3 路径 段，且末尾不能有斜杠——例如 https://monitoring.example.com/api/v3，而不是 https://monitoring.example.com 或 https://monitoring.example.com/api/v3/。如果填写错误，所有工具调用都会返回“未找到”错误，因为服务会将 /checks/ 等路径直接追加到你设置的地址后。如果未设置 HEALTHCHECKS_BASE_URL，则默认使用真实的 https://healthchecks.io/api/v3。

如果你的自托管实例未使用 HTTPS，服务会打印一条警告（但仍会运行）——每次调用时，API 密钥都会作为请求头发送，因此使用 http:// URL 意味着该密钥会以明文形式通过网络传输到你的实例。

可以做什么

此服务会公开 11 个 AI 助手可以调用的“工具”。它们分为两组：

读取工具 — 安全、仅用于查询，绝不会更改任何内容：

工具	功能
list_checks	列出你账户中的所有监控项。
get_check	获取某个监控项的完整详情。
list_check_pings	显示某个监控项最近的 ping 历史记录（何时收到 ping、成功/失败等）。需要读写密钥 — 请参阅下方说明。
list_check_flips	显示监控项状态发生变化的时间（例如从正常变为故障，或恢复正常）。
list_integrations	列出你配置的通知集成（Slack、电子邮件等）。需要读写密钥 — 请参阅下方说明。
list_badges	获取 Healthchecks.io 为你的每个标签生成的徽章图片 URL（适用于状态页面/仪表板）。

更改工具 — 这些工具会更改你账户中的内容，且全部需要读写 API 密钥：

工具	功能
create_check	创建新的监控项（例如“创建一个名为 nightly-backup 的监控项，要求每 24 小时收到一次 ping”）。也可以指定匹配现有字段（例如监控项名称），并更新该监控项，而不是创建重复项 — 这适用于作业可能多次注册自身的情况。
update_check	更改现有监控项的设置。只会更改你指定的字段 — 未提及的内容会保持原样。
pause_check	暂时停止监控某个监控项，但不将其删除。需要明确确认 — 请参阅下文。
resume_check	恢复对已暂停监控项的监控。
delete_check	永久删除监控项 — 此操作无法撤销。需要明确确认 — 请参阅下文。

技术参考

下表列出了每个工具对应的 Healthchecks.io API 端点：

工具	是否需要读写密钥？	Healthchecks.io API 端点
list_checks	否	GET /api/v3/checks/
get_check	否	GET /api/v3/checks/{uuid}
list_check_pings	是	GET /api/v3/checks/{uuid}/pings/
list_check_flips	否	GET /api/v3/checks/{uuid}/flips/
list_integrations	是	GET /api/v3/channels/
list_badges	否	GET /api/v3/badges/
create_check	是	POST /api/v3/checks/
update_check	是	POST /api/v3/checks/{uuid}
pause_check	是	POST /api/v3/checks/{uuid}/pause
resume_check	是	POST /api/v3/checks/{uuid}/resume
delete_check	是	DELETE /api/v3/checks/{uuid}