MCP-Pushover Bridge

Permite que assistentes de IA enviem notificações push através do serviço Pushover.

GitHub
2
Experimente este MCPPatrocinado

Documentação

MCP-Pushover Bridge

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA enviem notificações push via Pushover. Perfeito para receber alertas móveis instantâneos quando o Claude conclui tarefas, encontra erros ou quando você quer enviar mensagens para si mesmo através do seu assistente de IA.

Recursos

  • 📱 Envie notificações push através da API do Pushover
  • 🔄 Lógica de repetição configurável com backoff exponencial
  • 🎛️ Suporte para todos os parâmetros de mensagem do Pushover (título, prioridade, som)
  • ⚙️ Configuração baseada em variáveis de ambiente
  • 🔷 Suporte completo a TypeScript
  • 🤖 Construído para Claude Desktop e clientes compatíveis com MCP

Instalação

Início Rápido (Recomendado)

npx mcp-pushover

Instalação Global

npm install -g mcp-pushover
mcp-pushover

A partir do Código Fonte

git clone https://github.com/pyang2045/mcp-pushover.git
cd mcp-pushover
npm install
npm run build
npm start

Configuração do Pushover

Antes de usar este servidor MCP, você precisa configurar o Pushover:

1. Criar Conta no Pushover

  1. Cadastre-se em pushover.net
  2. Anote sua Chave de Usuário no painel

2. Baixar o Aplicativo Pushover

  1. Instale o aplicativo Pushover no seu dispositivo móvel:
  2. Faça login com suas credenciais da conta Pushover

3. Criar Aplicativo

  1. Acesse pushover.net/apps/build
  2. Crie um novo aplicativo (por exemplo, "MCP Bridge")
  3. Anote seu Token/Chave de API

4. Teste Sua Configuração

Você pode testar suas credenciais usando curl:

curl -s \
  --form-string "token=YOUR_API_TOKEN" \
  --form-string "user=YOUR_USER_KEY" \
  --form-string "message=Test from MCP-Pushover" \
  https://api.pushover.net/1/messages.json

Configuração

Variáveis de Ambiente

Crie um arquivo .env ou defina estas variáveis de ambiente:

# Required (unless provided as tool parameters)
PUSHOVER_DEFAULT_TOKEN=your_pushover_app_token
PUSHOVER_DEFAULT_USER=your_pushover_user_key

# Optional
NODE_ENV=production
LOG_LEVEL=info
RETRY_MAX_ATTEMPTS=3
RETRY_INITIAL_DELAY=1000

Integração com Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pushover": {
      "command": "npx",
      "args": ["mcp-pushover"],
      "env": {
        "PUSHOVER_DEFAULT_TOKEN": "your_app_api_token",
        "PUSHOVER_DEFAULT_USER": "your_user_key"
      }
    }
  }
}

Após atualizar a configuração, reinicie o Claude Desktop para carregar o servidor MCP.

Ferramentas Disponíveis

pushover_send_message

Envie uma notificação via Pushover para o seu dispositivo móvel.

Parâmetros:

  • message (obrigatório): O conteúdo da mensagem a ser enviada
  • user_key (opcional): Chave de usuário ou grupo do Pushover (padrão: variável de ambiente)
  • api_token (opcional): Token de API do aplicativo Pushover (padrão: variável de ambiente)
  • title (opcional): Título da mensagem
  • priority (opcional): Prioridade da mensagem:
    • -2: Sem notificação/alerta
    • -1: Notificação silenciosa
    • 0: Prioridade normal (padrão)
    • 1: Prioridade alta
    • 2: Prioridade de emergência (requer confirmação)
  • sound (opcional): Som de notificação (pushover, bike, bugle, cashregister, classical, cosmic, falling, gamelan, incoming, intermission, magic, mechanical, pianobar, siren, spacealarm, tugboat, alien, climb, persistent, echo, updown, vibrate, none)

Exemplo:

{
  "message": "Task completed successfully!",
  "title": "Claude Notification",
  "priority": 1,
  "sound": "magic"
}

Casos de Uso

Mensagens Pessoais

Peça ao Claude para enviar lembretes ou mensagens para você:

  • "Envie-me uma notificação para ligar para a mãe às 17h"
  • "Lembre-me de verificar os logs do servidor"
  • "Envie uma mensagem dizendo que o backup está completo"

Alertas de Conclusão de Tarefas

Seja notificado quando o Claude terminar o trabalho:

  • "Avise-me quando terminar de analisar esses dados"
  • "Envie-me uma notificação quando o relatório estiver pronto"
  • "Alerta-me se encontrar algum erro no código"

Integração com Fluxo de Trabalho

Integre com suas rotinas diárias:

  • Briefings matinais e resumos diários
  • Notificações de conclusão de build e implantação
  • Monitoramento de erros e alertas do sistema
  • Lembretes de reuniões e notificações de calendário

Notificações de Emergência

Alertas de alta prioridade que exigem atenção imediata:

  • Falhas do sistema ou erros críticos
  • Alertas de segurança ou atividade incomum
  • Lembretes sensíveis ao tempo
  • Conclusões de tarefas urgentes

Basta pedir ao Claude: "Envie-me uma notificação push que diga 'Implantação concluída com sucesso'" e você a receberá instantaneamente no seu dispositivo móvel!

Segurança

  • Tokens de API nunca são registrados
  • Suporta variáveis de ambiente para gerenciamento de credenciais
  • Todas as chamadas à API do Pushover usam HTTPS

Licença

MIT