Notificación de sonido MCP

Notificación de sonido MCP (JPN seguido de ENG)

Este proyecto es un servidor MCP que reproduce sonidos de notificación cuando los asistentes de codificación de IA como Windsurf y Cursor necesitan su atención. Puede hacer que se reproduzca un sonido de notificación cuando finalice la codificación o cuando se requiera la aprobación del usuario.

Notas y descargo de responsabilidad

*Al agregar configuraciones, asegúrese de agregar la configuración a las reglas (memoria para Windsurf) como un conjunto.
Actualmente sólo es compatible con MacOS.
Dado que la LLAMADA MCP se deja a discreción del LLM, existe la posibilidad de que se escuchen sonidos en momentos inesperados o que el dispositivo no funcione como se espera.
Tanto en Cursor como en Windsurf, a menudo no aparece un mensaje de confirmación antes de ejecutar un comando.
Windsurf tiene un problema en el que el sonido de notificación se reproduce varias veces al cerrar la aplicación. (Tenga en cuenta que los créditos se consumirán).

configuración

Prerrequisitos

Node.js (v18 o superior)
Hilo

instalar

# リポジトリをクローン
git clone <repository-url>
cd sound-notification-mcp

# 依存関係のインストール
yarn install

# ビルド
yarn build

Ahora estás listo para empezar.

Configuración para Windsurf y Cursor

Cursor

Se proporciona un ejemplo en /.cursor/mcp.json. (Si lo escribe en /.cursor/mcp.json, deberá escribirlo para cada proyecto. Si desea habilitarlo globalmente, configúrelo desde el ícono de configuración).

Windsurf

Escriba la configuración en mcp_config.json . Está bien usar exactamente el mismo contenido que /.cursor/mcp.json.

Personalización

Cambiar el sonido de las notificaciones

Cambie lo siguiente en src/index.ts :

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOSのデフォルトサウンド

Los sonidos del sistema disponibles en macOS se encuentran en /System/Library/Sounds/ :

Botella.aiff
Rana.aiff
Funk.aiff
Vidrio.aiff
Héroe.aiff
Morse.aiff
Ping.aiff
Pop.aiff
Ronroneo.aiff
Sosumi.aiff
Submarino.aiff
Tink.aiff

solución de problemas

Si no hay sonido

Asegúrese de que el volumen del sistema esté configurado correctamente.
Verifique que el archivo de audio especificado exista.
Verifique la salida del terminal para ver si hay mensajes de error.

Si el servidor MCP no se inicia

Asegúrese de tener Node.js y Yarn instalados correctamente.
Asegúrese de que las dependencias estén instaladas correctamente:
yarn install
Comprobar errores de compilación:
yarn build

licencia

Instituto Tecnológico de Massachusetts (MIT)

Versión en inglés

Este proyecto es un servidor MCP que reproduce sonidos de notificación cuando los asistentes de codificación de IA como Windsurf o Cursor requieren la atención del usuario. Puede reproducir sonidos de notificación cuando se completa la codificación o cuando se necesita la aprobación del usuario.

Notas y descargo de responsabilidad

* Al agregar configuraciones, agregue siempre las entradas correspondientes a las reglas.
Actualmente solo es compatible con MAC ya que el creador usa una Mac y no puede verificarlo en Windows.
Dado que las LLAMADAS MCP dependen del criterio de LLM, es posible que los sonidos se reproduzcan en momentos inesperados o no funcionen como se espera.
En el caso del cursor, es posible que a veces los sonidos no se reproduzcan antes de la aprobación de la ejecución del comando.
Con Windsurf, existe un fenómeno en el que los sonidos de notificación pueden reproducirse varias veces.

Configuración

Prerrequisitos

Node.js (v18 o superior)
Hilo

Instalación

# Clone the repository
git clone <repository-url>
cd sound-notification-mcp

# Install dependencies
yarn install

# Build
yarn build

Ahora estás listo para empezar.

Configuración para Windsurf y Cursor

Cursor

Se proporciona una configuración de muestra en /.cursor/mcp.json (escribir en /.cursor/mcp.json requiere configuración para cada proyecto. Si desea habilitarlo globalmente, configúrelo desde el ícono de configuración).

Windsurf

Agregue la configuración a mcp_config.json . El contenido puede ser exactamente el mismo que /.cursor/mcp.json .

Para la práctica del Windsurf también es muy recomendable:

Agregue las instrucciones de notificación a su archivo global_rules.md
Añade la configuración de notificaciones a tus recuerdos

Esto garantiza que el asistente de inteligencia artificial utilice constantemente notificaciones de sonido cuando sea necesario.

Personalización

Cambiar el sonido de las notificaciones

Modifique la siguiente sección en el archivo src/index.ts :

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // macOS default sound

Los sonidos del sistema disponibles en macOS se pueden encontrar en el directorio /System/Library/Sounds/ :

Botella.aiff
Rana.aiff
Funk.aiff
Vidrio.aiff
Héroe.aiff
Morse.aiff
Ping.aiff
Pop.aiff
Ronroneo.aiff
Sosumi.aiff
Submarino.aiff
Tink.aiff

Solución de problemas

Si no se reproduce ningún sonido

Compruebe que el volumen del sistema esté configurado correctamente.
Verifique que el archivo de sonido especificado exista.
Verifique la salida del terminal para ver si hay mensajes de error.

Si el servidor MCP no se inicia

Verifique que Node.js y Yarn estén instalados correctamente.
Compruebe que las dependencias estén correctamente instaladas:
yarn install
Comprobar errores de compilación:
yarn build

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Sound Notification MCP

Integrations