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:
- Comprobar errores de compilación:
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:
- Comprobar errores de compilación:
Licencia
Instituto Tecnológico de Massachusetts (MIT)