Desktop Notification

Envie notificações de desktop multiplataforma a partir de assistentes de IA.

Documentação

Desktop Notification MCP Server

Um servidor Model Context Protocol (MCP) que fornece capacidades de notificação de desktop multiplataforma. Construído sobre o excelente crate notify-rust, este servidor permite que assistentes de IA como o Claude enviem notificações de desktop em seu nome, permitindo melhor interação e feedback durante conversas.

Recursos

  • Suporte multiplataforma: Funciona em Linux (XDG), macOS e Windows
  • Múltiplos tipos de notificação: Básicas, urgentes, com ícones, timeouts personalizados e totalmente personalizáveis
  • Conformidade com MCP: Implementa o Model Context Protocol para integração perfeita
  • Configuração flexível: Suporta vários parâmetros de notificação e recursos específicos da plataforma

Ferramentas Disponíveis

Notificações Básicas

  • send_notification - Envia uma notificação simples com título e mensagem
  • send_urgent_notification - Envia uma notificação de alta prioridade
  • send_notification_with_icon - Envia uma notificação com ícone personalizado
  • send_notification_with_timeout - Envia uma notificação com timeout personalizado

Notificações Avançadas

  • send_rich_notification - Envia uma notificação totalmente personalizável com todas as opções disponíveis

Compatibilidade de Plataforma

RecursoLinux (XDG)macOSWindows
Notificações básicas
ÍconesLimitado
Níveis de urgênciaLimitado
Categorias
Nomes de aplicativos
Timeouts personalizados

Instalação

Baixar Binário

Baixe o binário mais recente para sua plataforma na página de releases:

Configuração com o Claude Desktop

Para usar este servidor MCP com o Claude Desktop, você precisa adicioná-lo ao seu arquivo de configuração do Claude. Isso permitirá que o Claude envie notificações de desktop durante suas conversas.

Passo 1: Localize o Arquivo de Configuração do Claude

A localização do arquivo de configuração depende do seu sistema operacional:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Nota: Se o arquivo não existir, crie-o com um objeto JSON vazio: {}

Passo 2: Adicione a Configuração do Servidor MCP

Edite o arquivo de configuração e adicione o servidor de notificação de desktop à seção mcpServers. Substitua /path/to/ pelo caminho real onde você baixou o binário.

Configuração do macOS

{
  "mcpServers": {
    "desktop-notify": {
      "command": "/Users/yourusername/Downloads/mcp-server-desktop-notify",
      "args": []
    }
  }
}

Configuração do Linux

{
  "mcpServers": {
    "desktop-notify": {
      "command": "/home/yourusername/bin/mcp-server-desktop-notify",
      "args": []
    }
  }
}

Configuração do Windows

{
  "mcpServers": {
    "desktop-notify": {
      "command": "C:\\Users\\YourUsername\\Downloads\\mcp-server-desktop-notify.exe",
      "args": []
    }
  }
}

Passo 3: Exemplo de Configuração Completa

Aqui está um exemplo completo de arquivo de configuração com vários servidores MCP:

{
  "mcpServers": {
    "desktop-notify": {
      "command": "/usr/local/bin/mcp-server-desktop-notify",
      "args": []
    },
  }
}

Passo 4: Verifique a Configuração

  1. Verifique a sintaxe do arquivo: Garanta que seu JSON seja válido (sem vírgulas finais, aspas corretas)
  2. Verifique o caminho do binário: Certifique-se de que o caminho para o binário está correto e que o arquivo existe
  3. Verifique as permissões: Garanta que o binário seja executável (somente Linux/macOS)

Passo 5: Reinicie o Claude Desktop

Após salvar o arquivo de configuração, saia completamente e reinicie o Claude Desktop para que as alterações tenham efeito.

Passo 6: Verifique a Integração

Quando o Claude Desktop reiniciar, você deve ver as ferramentas de notificação de desktop disponíveis. Você pode verificar isso por:

  1. Iniciando uma nova conversa com o Claude
  2. Perguntando ao Claude: "Quais ferramentas de notificação você tem disponíveis?"
  3. O Claude deve listar as ferramentas de notificação de desktop se estiver configurado corretamente

Dicas de Configuração

  • Use caminhos absolutos: Sempre use caminhos completos para o binário para evitar problemas
  • Escape barras invertidas: No Windows, use barras invertidas duplas (\\) em strings JSON
  • Teste o binário: Execute o binário diretamente primeiro para garantir que funcione no seu sistema
  • Verifique os logs do Claude: Se ocorrerem problemas, verifique os logs do Claude Desktop para mensagens de erro