MCP Notify Server

📢 MCP Notify Server

English | 中文

Um servidor MCP que envia notificações de desktop com efeito sonoro quando as tarefas do agente são concluídas.

🥩 Recursos

• Envia notificações de desktop do sistema após a conclusão de tarefas do agente
• Reproduz sons de alerta para chamar a atenção do usuário, com arquivo de som incluído.
• Suporte multiplataforma (Windows, macOS, Linux)
• Baseado no protocolo MCP padrão, integra-se com vários clientes de LLM

⏬ Instalação

Instalar usando o gerenciador de pacotes uv

git clone https://github.com/Cactusinhand/mcp_server_notify.git
cd mcp_server_notify

uv venv
source .venv/Scripts/activate

uv pip install mcp-server-notify
# or
pip install mcp-server-notify

Após a instalação, chame o módulo diretamente para verificar se a instalação foi bem-sucedida:

python -m mcp_server_notify

Este módulo aceita a opção --debug ou --file , podemos usá-lo assim:

python -m mcp_server_notify --debug
python -m mcp_server_notify --debug --log-file=path/to/logfile.log

⚠️❕ Requisitos especiais

** Usamos a API Apprise para a entrega das nossas notificações de desktop, então precisamos instalar alguns requisitos especiais no nosso desktop **

Windows

# windows:// minimum requirements
pip install pywin32

macOS

# Make sure terminal-notifier is installed into your system
brew install terminal-notifier

📚 Uso

Usando com o Claude Desktop:

Encontre o arquivo de configuração claude_desktop_config.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify project",
              "run",
              "mcp-server-notify",
            ]
        }
    }
}

Se instalado globalmente, você também pode usar o comando python:

{
    "mcpServers": {
        "NotificationServer": {
            "command": "python",
            "args": [
              "-m",
              "mcp_server_notify",
            ]
        }
    }
}

⚡️ Usando com o Cursor:

Encontre o arquivo de configuração ~/.cursor/mcp.json ou your_project/.cursor/mcp.json

{
    "mcpServers": {
        "NotificationServer": {
            "command": "uv",
            "args": [
              "--directory",
              "path/to/your/mcp_server_notify project",
              "run",
              "mcp-server-notify",
            ]
        }
    }
}

Após a configuração, basta adicionar um prompt como finally, send me a notification when task finished. no final da sua entrada de tarefa para a IA para acionar as notificações.

No Cursor, você pode adicionar este prompt como uma regra em Cursor Settings -> Rules para não precisar digitá-lo manualmente toda vez.

⚡️ Usando com VSCode + Copilot:

1. Instale o gerenciador de serviços uv/uvx: pip install uv

2. Adicione o serviço às configurações do VSCode:

   Windows %APPDATA%\Code\User\settings.json
   macOS $HOME/Library/Application\ Support/Code/User/settings.json
   Linux $HOME/.config/Code/User/settings.json

   "mcp": {
       "servers": {
           "notifier": {
               "command": "uvx",
               "args": [
                   "mcp-server-notify"
               ],
               "env": {}
           }
       }
   }
   

3. Certifique-se de estar usando a versão mais recente do VSCode — ele executa serviços MCP automaticamente

4. Abra o VSCode → ative o Copilot → mude para o modo agente.

5. Digite # → você verá a opção #send_notification.

6. Peça ao agente: execute #send_notification (ele lidará com a notificação automaticamente).

7. Agora o Copilot no modo agente pode enviar notificações de desktop.

🐳 Executando com Docker

Atualmente indisponível devido a problemas de compatibilidade de ambiente. Se os contêineres Docker precisarem acionar notificações do host, independentemente de o sistema operacional do host ser Windows, macOS ou Linux, a solução se torna muito mais complexa, e o uso direto de notificações nativas geralmente não é viável.

Principais problemas:

1. Sistemas de notificação específicos do SO Cada sistema operacional (Windows, macOS, Linux) tem seu mecanismo de notificação exclusivo.

2. Isolamento do Docker O isolamento dos contêineres Docker limita sua capacidade de acessar diretamente os recursos do sistema operacional do host.

3. Gerenciamento de dependências É necessário lidar com diferentes bibliotecas e dependências de notificação para cada sistema operacional.

🧾 Licença

MIT

💻 Contribuições

Issues e pull requests são bem-vindos!