Drumbeats Mcp

Drumbeats MCP

面向 Drumbeats 的官方 Model Context Protocol 服务——可从任何 AI 客户端运行监控。 通过 Claude、Cursor、VS Code 或任何支持 MCP 的工具，使用自然语言创建监控器、分诊事件，并运行 HTTP / SSL / DNS 检查。

什么是 Drumbeats？

Drumbeats 为后台作业和服务提供心跳与正常运行时间监控——包括 cron 作业、队列、计划任务和 HTTP 端点。如果作业停止发送心跳，或网站发生故障，Drumbeats 会向你发送提醒。前往 drumbeats.io 创建免费账户。

安装

将服务添加到你的 AI 客户端，并设置一个环境变量——你的 Drumbeats 账户 API 密钥：

{
  "mcpServers": {
    "drumbeats": {
      "command": "npx",
      "args": ["-y", "@drumbeats/mcp"],
      "env": { "DRUMBEATS_API_KEY": "dk_your_key" }
    }
  }
}

1. 获取密钥 — 前往 drumbeats.io → Account → API keys。账户级密钥（dk_…）可用于你拥有或加入的所有项目。
2. 添加配置 — 将上面的代码块粘贴到客户端的 MCP 配置中，然后重启客户端。
3. 提问 — “列出我的监控器。”

Claude Desktop： 建议使用一键安装方式——从 Releases 页面下载最新的 .mcpb 包，双击打开，并在提示时粘贴你的密钥。

通过 npx 运行时需要 Node.js 22。

工具

共 16 个工具，共享同一层。HTTP / SSL / DNS 诊断无需账户或 API 密钥——让任何客户端连接到服务即可开始检查。

项目与监控器

工具	功能
list_projects	列出密钥可访问的项目（包含通知渠道和分组）。
create_project	创建新项目（需要带有 manage_projects 权限的账户级密钥）。
update_project	更新项目名称或描述（部分更新）。
create_monitor	创建监控器——cron、心跳或 HTTP 正常运行时间监控。
list_monitors	列出项目的监控器及其类型、状态和计划。
get_monitor	按 ID 获取一个监控器及其完整配置。
update_monitor	更新现有监控器（部分更新）。
pause_monitor	暂停监控器（停止检查和提醒）。
resume_monitor	恢复已暂停的监控器。

观测与分诊

工具	功能
get_monitor_history	查看监控器最近的 ping、检查和响应时间。
get_uptime_summary	汇总整个项目中各监控器的正常运行时间 / SLA。
list_incidents	列出事件（停机和漏跑），可按状态或监控器筛选。
manage_incident	获取、确认或解决事件。

诊断——无需账户

工具	功能
check_http	检查 URL 的连通性、状态码和响应时间。
check_ssl	检查 TLS 证书——有效性、过期时间和颁发者。
check_dns	解析主机名并报告其 DNS 记录。

示例提示词

List all my monitors and their current status.
Create a cron monitor for my nightly backup that runs every day at 02:00 UTC.
What's my uptime this month?
Show me open incidents and acknowledge the most recent one.
Is https://example.com up right now?            # no account needed
Is the SSL certificate for example.com about to expire?   # no account needed

零配置试用

check_http、check_ssl 和 check_dns 工具无需 Drumbeats 账户或 API 密钥。添加服务，不设置 DRUMBEATS_API_KEY，然后询问 “我的网站正常运行吗？”，即可先行体验。准备好开始持续监控并接收提醒后， 创建免费账户。

配置

变量	必需	默认值	说明
DRUMBEATS_API_KEY	监控工具必需	—	账户级密钥（dk_…）。诊断工具不需要。
DRUMBEATS_API_BASE_URL	否	https://api.drumbeats.io	REST API 根 URL。Drumbeats API 按路径前缀（/id、/beats、/alerts）拆分为多个服务；客户端会在每次请求中将各服务对应的前缀追加到此根 URL。
DRUMBEATS_ID_BASE_URL	否	${apex}/id	自托管覆盖项：id 服务的完整基础 URL。
DRUMBEATS_BEATS_BASE_URL	否	${apex}/beats	自托管覆盖项：beats 服务的完整基础 URL。
DRUMBEATS_ALERTS_BASE_URL	否	${apex}/alerts	自托管覆盖项：alerts 服务的完整基础 URL。

开发

需要使用 .nvmrc 中指定的 Node 版本。

npm ci          # install dependencies
npm run build   # compile TypeScript to dist/
npm run lint    # Biome lint + format check
npm test        # run the test suite

有关贡献工作流，请参阅 CONTRIBUTING.md；有关安全政策，请参阅 SECURITY.md。这是一个安全产品—— 请私下报告漏洞。

链接

• 产品： drumbeats.io · 注册
• 问题： github.com/drumbeats-io/mcp/issues

许可证

Apache-2.0 © Lucky S Software。请参阅 NOTICE。

---

由 Lucky S Software 打造。