MCP Notify Server

📢 Servidor de notificaciones MCP

inglés |中文

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

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

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

⚠️❕ Requisitos especiales

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

Ventanas

macOS

📚 Uso

Uso con Claude Desktop:

Encuentra el archivo de configuración claude_desktop_config.json

Si se instala globalmente, también puedes usar el comando de Python:

⚡️ Uso con cursor:

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

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.

⚡️ Uso con VSCode + Copilot:

1. Instalar 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úrate de estar usando la última versión de VSCode: ejecuta automáticamente los servicios MCP
4. Abra VSCode → habilite Copilot → cambie al modo agente.
5. Escribe # → verás la opción #send_notification.
6. Pregúntele al agente: ejecute #send_notification (manejará la notificación automáticamente).
7. Ahora el Copilot en modo agente puede enviar notificaciones de escritorio.

🐳 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:

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 host.
3. 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!