MCP Notify Server

📢 MCP Notify Server

English | 中文

Un servidor MCP que envía notificaciones de escritorio con efectos de sonido cuando se completan las tareas del agente.

🥩 Características

• Envía notificaciones del sistema de escritorio después de que el agente complete las tareas
• Reproduce sonidos de alerta para captar la atención del usuario, con archivo de sonido incluido.
• Soporte multiplataforma (Windows, macOS, Linux)
• Basado en el protocolo estándar MCP, se integra con varios clientes LLM

⏬ Instalación

Instalar usando el gestor de paquetes 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

Después de la instalación, llame al módulo directamente para verificar si la instalación fue exitosa:

python -m mcp_server_notify

Este módulo acepta la opción --debug o --file , podemos usarlo así:

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

⚠️❕ Requisitos especiales

** Usamos la API de Apprise para la entrega de nuestras notificaciones de escritorio, por lo que necesitamos instalar algunos requisitos especiales en nuestro escritorio **

Windows

# windows:// minimum requirements
pip install pywin32

macOS

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

📚 Uso

Usar con Claude Desktop:

Busque el archivo de configuración claude_desktop_config.json

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

Si está instalado globalmente, también puede usar el comando de python:

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

⚡️ Usar con Cursor:

Busque el archivo de configuración ~/.cursor/mcp.json o your_project/.cursor/mcp.json

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

Después de la configuración, simplemente agregue un prompt como finally, send me a notification when task finished. al final de su entrada de tarea a la IA para activar las notificaciones.

En Cursor, puede agregar este prompt como regla en Cursor Settings -> Rules para no tener que escribirlo manualmente cada vez.

⚡️ Usar con VSCode + Copilot:

1. Instale el administrador de servicios uv/uvx: pip install uv

2. Agregue el servicio a la configuración de 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. Asegúrese de estar usando la versión más reciente de VSCode — ejecuta automáticamente los servicios MCP

4. Abra VSCode → active Copilot → cambie al modo agente.

5. Escriba # → verá la opción #send_notification.

6. Pídale al agente: ejecute #send_notification (manejará la notificación automáticamente).

7. Ahora Copilot en modo agente puede enviar notificaciones de escritorio.

🐳 Ejecutar con Docker

Actualmente no disponible debido a problemas de compatibilidad del entorno. Si los contenedores Docker necesitan activar notificaciones del host independientemente de si el sistema operativo del host es Windows, macOS o Linux, la solución se vuelve mucho más compleja, y el uso directo de notificaciones nativas generalmente no es viable.

Problemas principales:

1. Sistemas de notificación específicos del sistema operativo Cada sistema operativo (Windows, macOS, Linux) tiene su mecanismo de notificación único.

2. Aislamiento de Docker El aislamiento de los contenedores Docker limita su capacidad para acceder directamente a los recursos del sistema operativo del host.

3. Gestión de dependencias Es necesario manejar diferentes bibliotecas y dependencias de notificación para cada sistema operativo.

🧾 Licencia

MIT

💻 Contribuciones

¡Las issues y las pull requests son bienvenidas!