Drumbeats MCP
Opere monitores de cron/uptime, incidentes e verificações HTTP/SSL/DNS do Drumbeats a partir de qualquer cliente de IA.
Documentação
Drumbeats MCP
O servidor oficial do Model Context Protocol para Drumbeats — execute seu monitoramento a partir de qualquer cliente de IA. Crie monitores, faça triagem de incidentes e execute verificações de HTTP / SSL / DNS em linguagem natural a partir do Claude, Cursor, VS Code ou qualquer ferramenta compatível com MCP.
O que é o Drumbeats?
O Drumbeats é um monitoramento de heartbeat e uptime para jobs e serviços em segundo plano — cron jobs, filas, tarefas agendadas e endpoints HTTP. Se um job parar de fazer check-in ou um site cair, o Drumbeats alerta você. Crie uma conta gratuita em drumbeats.io.
Instalação
Adicione o servidor ao seu cliente de IA e defina uma variável de ambiente — a chave de API da sua conta Drumbeats:
{
"mcpServers": {
"drumbeats": {
"command": "npx",
"args": ["-y", "@drumbeats/mcp"],
"env": { "DRUMBEATS_API_KEY": "dk_your_key" }
}
}
}
- Obtenha uma chave — em drumbeats.io → Conta → Chaves de API. Uma
chave com escopo de conta (
dk_…) funciona em todos os projetos que você possui ou dos quais participa. - Adicione a configuração — cole o bloco acima na configuração MCP do seu cliente e reinicie-o.
- Pergunte — "Liste meus monitores."
Claude Desktop: prefere uma instalação com um clique — baixe o pacote .mcpb mais recente
da página de Releases,
clique duas vezes nele e cole sua chave quando solicitado.
Requer Node.js 22 ao executar via npx.
Ferramentas
Dezesseis ferramentas em uma camada compartilhada. Os diagnósticos de HTTP / SSL / DNS funcionam sem conta e sem chave de API — aponte qualquer cliente para o servidor e comece a verificar.
Projetos e monitores
| Ferramenta | O que faz |
|---|---|
list_projects | Lista os projetos que sua chave pode acessar (com canais de notificação e grupos). |
create_project | Cria um novo projeto (chave com escopo de conta com manage_projects). |
update_project | Atualiza o nome ou a descrição de um projeto (patch parcial). |
create_monitor | Cria um monitor — cron, heartbeat ou uptime HTTP. |
list_monitors | Lista os monitores de um projeto com tipo, status e agendamento. |
get_monitor | Busca um monitor por id, com sua configuração completa. |
update_monitor | Atualiza um monitor existente (patch parcial). |
pause_monitor | Pausa um monitor (interrompe verificações e alertas). |
resume_monitor | Retoma um monitor pausado. |
Observar e fazer triagem
| Ferramenta | O que faz |
|---|---|
get_monitor_history | Pings, verificações e tempos de resposta recentes de um monitor. |
get_uptime_summary | Resumo de uptime / SLA em todo o projeto, entre monitores. |
list_incidents | Lista incidentes (indisponibilidade e execuções perdidas), filtráveis por status ou monitor. |
manage_incident | Obtém, reconhece ou resolve um incidente. |
Diagnósticos — sem necessidade de conta
| Ferramenta | O que faz |
|---|---|
check_http | Verifica a acessibilidade de uma URL, código de status e tempo de resposta. |
check_ssl | Inspeciona um certificado TLS — validade, expiração e emissor. |
check_dns | Resolve um hostname e relata seus registros DNS. |
Exemplos de prompts
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
Experimente sem configuração
As ferramentas check_http, check_ssl e check_dns não precisam de conta Drumbeats ou chave de
API. Adicione o servidor, deixe DRUMBEATS_API_KEY sem definir e pergunte "Meu site está no ar?" antes
de se cadastrar. Quando estiver pronto para monitoramento contínuo e alertas,
crie uma conta gratuita.
Configuração
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
DRUMBEATS_API_KEY | Para as ferramentas de monitoramento | — | Chave com escopo de conta (dk_…). Não é necessária para as ferramentas de diagnóstico. |
DRUMBEATS_API_BASE_URL | Não | https://api.drumbeats.io | A URL REST apex. A API do Drumbeats é dividida entre serviços por prefixo de caminho (/id, /beats, /alerts); o cliente anexa o prefixo por serviço a essa apex em cada requisição. |
DRUMBEATS_ID_BASE_URL | Não | ${apex}/id | Substituição para self-host: URL base completa para o serviço id. |
DRUMBEATS_BEATS_BASE_URL | Não | ${apex}/beats | Substituição para self-host: URL base completa para o serviço beats. |
DRUMBEATS_ALERTS_BASE_URL | Não | ${apex}/alerts | Substituição para self-host: URL base completa para o serviço alerts. |
Desenvolvimento
Requer a versão do Node em .nvmrc.
npm ci # install dependencies
npm run build # compile TypeScript to dist/
npm run lint # Biome lint + format check
npm test # run the test suite
Consulte CONTRIBUTING.md para o fluxo de trabalho de contribuição e SECURITY.md para a política de segurança. Este é um produto de segurança — por favor, relate vulnerabilidades de forma privada.
Links
- Produto: drumbeats.io · cadastre-se
- Issues: github.com/drumbeats-io/mcp/issues
Licença
Apache-2.0 © Lucky S Software. Consulte NOTICE.
Um produto da Lucky S Software.