Servidor de notificaciones MCP

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

Características

Enviar notificaciones de escritorio del sistema después de que se completen las tareas del agente
Reproduce sonidos de alerta para captar la atención del usuario, con un archivo de sonido dentro.
Compatibilidad multiplataforma (Windows, macOS, Linux)
Basado en el protocolo MCP estándar, se integra con varios clientes LLM

Instalación

Instalar usando el administrador 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 notificaciones de escritorio, por lo que necesitamos instalar algunos requisitos especiales en nuestra aplicación de escritorio.

Ventanas

# windows:// minimum requirements
pip install pywin32

macOS

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

Uso

Uso con Claude Desktop:

Encuentra 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 se instala globalmente, también puedes usar el comando de Python:

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

Usando con el 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 mensaje como finally, send me a notification when task finished. Al final de su tarea, ingrese a la IA para activar las notificaciones.

En Cursor, puedes agregar esta indicación como una regla en Cursor Settings -> Rules para no tener que escribirla manualmente cada vez.

Ejecutando con Docker

Actualmente no disponible debido a problemas de compatibilidad con el 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 no suele ser viable.

Cuestiones principales:

Sistemas de notificación específicos del sistema operativo Cada sistema operativo (Windows, macOS, Linux) tiene su mecanismo de notificación único.
Aislamiento de Docker El aislamiento de los contenedores Docker limita su capacidad para acceder directamente a los recursos del sistema operativo host.
Gestión de dependencias Es necesario gestionar diferentes bibliotecas de notificaciones y dependencias para cada sistema operativo.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuciones

¡Los problemas y las solicitudes de extracción son bienvenidos!

MCP Notify Server

Integrations