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

CI npm License: Apache-2.0 drumbeats-io/mcp MCP server smithery badge

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" }
    }
  }
}
  1. 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.
  2. Adicione a configuração — cole o bloco acima na configuração MCP do seu cliente e reinicie-o.
  3. 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

FerramentaO que faz
list_projectsLista os projetos que sua chave pode acessar (com canais de notificação e grupos).
create_projectCria um novo projeto (chave com escopo de conta com manage_projects).
update_projectAtualiza o nome ou a descrição de um projeto (patch parcial).
create_monitorCria um monitor — cron, heartbeat ou uptime HTTP.
list_monitorsLista os monitores de um projeto com tipo, status e agendamento.
get_monitorBusca um monitor por id, com sua configuração completa.
update_monitorAtualiza um monitor existente (patch parcial).
pause_monitorPausa um monitor (interrompe verificações e alertas).
resume_monitorRetoma um monitor pausado.

Observar e fazer triagem

FerramentaO que faz
get_monitor_historyPings, verificações e tempos de resposta recentes de um monitor.
get_uptime_summaryResumo de uptime / SLA em todo o projeto, entre monitores.
list_incidentsLista incidentes (indisponibilidade e execuções perdidas), filtráveis por status ou monitor.
manage_incidentObtém, reconhece ou resolve um incidente.

Diagnósticos — sem necessidade de conta

FerramentaO que faz
check_httpVerifica a acessibilidade de uma URL, código de status e tempo de resposta.
check_sslInspeciona um certificado TLS — validade, expiração e emissor.
check_dnsResolve 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ávelObrigatóriaPadrãoDescrição
DRUMBEATS_API_KEYPara as ferramentas de monitoramento—Chave com escopo de conta (dk_…). Não é necessária para as ferramentas de diagnóstico.
DRUMBEATS_API_BASE_URLNãohttps://api.drumbeats.ioA 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_URLNão${apex}/idSubstituição para self-host: URL base completa para o serviço id.
DRUMBEATS_BEATS_BASE_URLNão${apex}/beatsSubstituição para self-host: URL base completa para o serviço beats.
DRUMBEATS_ALERTS_BASE_URLNão${apex}/alertsSubstituiçã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

Licença

Apache-2.0 © Lucky S Software. Consulte NOTICE.


Um produto da Lucky S Software.