内容
# 鼓点MCP
[](https://github.com/drumbeats-io/mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@drumbeats/mcp)
[](./LICENSE)
**鼓点** 的官方 [模型上下文协议](https://modelcontextprotocol.io) 服务器 — 从任何AI客户端运行您的监控。创建监视器，处理事件，并使用自然语言从Claude，Cursor，VS Code或任何支持MCP的工具运行HTTP / SSL / DNS检查。
## 什么是鼓点？
鼓点是用于后台作业和服务的 心跳 和 正常运行时间 监控 — cron作业，队列，计划任务和HTTP端点。如果作业停止检查或站点关闭，鼓点会提醒您。在 **[鼓点官网](https://drumbeats.io)** 创建一个免费帐户。
## 安装
将服务器添加到您的AI客户端，并设置一个环境变量 — 您的鼓点帐户API密钥：
```jsonc
{
"mcpServers": {
"drumbeats": {
"command": "npx",
"args": ["-y", "@drumbeats/mcp"],
"env": { "DRUMBEATS_API_KEY": "dk_your_key" }
}
}
}
```
1. **获取密钥** — 在 [鼓点官网](https://drumbeats.io) → **帐户 → API密钥**。帐户范围的密钥（`dk_…`）适用于您拥有的或所属的每个项目。
2. **添加配置** — 将上面的代码块粘贴到客户端的MCP配置中并重启。
3. **询问** — *"列出我的监视器。"*
**Claude Desktop：** 优先使用一键安装 — 从 [发布页面](https://github.com/drumbeats-io/mcp/releases/latest) 下载最新的`.mcpb`包，双击它，并在提示时粘贴您的密钥。
通过`npx`运行时，需要Node.js 22。
## 工具
十四种工具共享一个层。HTTP / SSL / DNS诊断无需帐户和API密钥 — 任意客户端指向服务器并开始检查。
**监视器和项目**
| 工具 | 功能 |
| --- | --- |
| `list_projects` | 列出您的密钥可以访问的项目（带有通知渠道和组）。 |
| `create_monitor` | 创建监视器 — cron，heartbeat或HTTP正常运行时间。 |
| `list_monitors` | 列出项目的监视器，类型，状态和计划。 |
| `get_monitor` | 获取一个监视器及其完整配置。 |
| `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记录。 |
## 示例提示
```text
列出我所有的监视器及其当前状态。
为我的夜间备份创建一个cron监视器，每天在02:00 UTC运行。
这个月的我的正常运行时间是多少？
显示开放事件并确认最近的一个。
https://example.com现在是否正常？ # 无需帐户
example.com的SSL证书是否即将过期？ # 无需帐户
```
## 零设置试用
`check_http`，`check_ssl`和`check_dns`工具不需要鼓点帐户或API密钥。添加服务器，取消设置`DRUMBEATS_API_KEY`，并在注册之前询问 *"我的站点是否正常？"*。当您准备好进行连续监控和警报时，[创建一个免费帐户](https://drumbeats.io)。
## 配置
| 变量 | 必需 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `DRUMBEATS_API_KEY` | 用于监控工具 | — | 帐户范围的密钥（`dk_…`）。诊断工具不需要。 |
| `DRUMBEATS_API_BASE_URL` | 否 | `https://api.drumbeats.io` | 覆盖API基本URL（例如用于测试）。 |
## 开发
需要 [.nvmrc](./.nvmrc) 中的Node版本。
```bash
npm ci # 安装依赖
npm run build # 将TypeScript编译到dist/
npm run lint # Biome lint + 格式检查
npm test # 运行测试套件
```
参见 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解贡献工作流程，[SECURITY.md](./SECURITY.md) 了解安全策略。这是一个安全产品 — 请私下报告漏洞。
## 链接
- **产品：** [鼓点官网](https://drumbeats.io) · [注册](https://drumbeats.io)
- **问题：** [github.com/drumbeats-io/mcp/issues](https://github.com/drumbeats-io/mcp/issues)
## 许可证
[Apache-2.0](./LICENSE) © Lucky S Software. 参见 [NOTICE](./NOTICE).
---
**Lucky S Software** 的产品。
