Skip to main content
Glama

Sound Notification MCP

by ks0318-p

Sound Notification MCP (JPN followed By ENG)

이 프로젝트는 Windsurf 및 Cursor와 같은 AI 코딩 어시스턴트가 사용자의 주의가 필요한 경우 알림음을 울리는 MCP 서버입니다. 코딩이 끝나거나 사용자의 승인이 필요할 때 알림 소리를 들을 수 있습니다.

주의사항 & 면책

  • ※설정을 추가할 때는 반드시 세트로 rules(windsurf에는 메모리)에 기재를 추가해 주세요.
  • 현재 MacOS에만 대응하고 있습니다.
  • MCP의 CALL은 LLM의 판단에 맡기게 되므로, 예상외의 타이밍에서 소리가 들리거나 예상대로 동작하지 않을 가능성이 있습니다.
  • Cursor/Windsurf 공통으로 명령 실행 전의 승인은 울리지 않는 경우가 많습니다.
  • Windsurf는 종료 시 알림음을 여러 번 울리는 현상이 있습니다. (크레디트 소비하므로 주의해 주십시오.)

설정

전제 조건

  • Node.js (v18 이상)
  • Yarn

설치

# リポジトリをクローン git clone <repository-url> cd sound-notification-mcp # 依存関係のインストール yarn install # ビルド yarn build

이것으로 준비 완료입니다.

Windsurf 및 Cursor에서 설정

커서

샘플을 /.cursor/mcp.json에 설명했습니다. (/.cursor/mcp.json에 쓰면 프로젝트마다 기재가 필요합니다. Global에서 활성화하고 싶으면 설정 아이콘에서 설정해 주세요.)

Windsurf

mcp_config.json 에 설정을 설명합니다. /.cursor/mcp.json과 완전히 같은 내용으로 문제가 없습니다.

맞춤형

알림 소리 변경

src/index.ts 파일의 다음 부분을 변경합니다.

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

macOS에서 사용 가능한 시스템 사운드는 /System/Library/Sounds/ 디렉토리에 있습니다.

  • Bottle.aiff
  • Frog.aiff
  • Funk.aiff
  • Glass.aiff
  • Hero.aiff
  • Morse.aiff
  • Ping.aiff
  • Pop.aiff
  • Purr.aiff
  • Sosumi.aiff
  • Submarine.aiff
  • Tink.aiff

문제해결

소리가 울리지 않으면

  1. 시스템 볼륨이 제대로 설정되어 있는지 확인합니다.
  2. 지정한 오디오 파일이 있는지 확인합니다.
  3. 터미널 출력에서 오류 메시지를 확인합니다.

MCP 서버가 시작되지 않는 경우

  1. Node.js와 Yarn이 올바르게 설치되었는지 확인하십시오.
  2. 종속성이 올바르게 설치되었는지 확인합니다.
    yarn install
  3. 빌드 오류가 있는지 확인하십시오.
    yarn build

라이센스

MIT


English Version

This project is an MCP server that plays notification sounds when AI coding assistants like Windsurf or Cursor require user attention. It can play notification sounds when coding is complete or when user approval is needed.

Notes & Disclaimer

  • ※ When adding settings, please always add corresponding entries to the rules.
  • Currently only supports MAC as the creator uses a Mac and cannot verify on Windows.
  • Since MCP CALLS depend on LLM judgment, sounds may play at unexpected times or not work as expected.
  • For Cursor, sounds may sometimes not play before command execution approval.
  • With Windsurf, there is a phenomenon where notification sounds may play multiple times.

Setup

Prerequisites

  • Node.js (v18 or higher)
  • Yarn

Installation

# Clone the repository git clone <repository-url> cd sound-notification-mcp # Install dependencies yarn install # Build yarn build

Now you're ready to go.

Configuration for Windsurf and Cursor

커서

A sample configuration is provided in /.cursor/mcp.json (Writing to /.cursor/mcp.json requires configuration for each project. If you want to enable it globally, please configure it from the settings icon.)

Windsurf

Add configuration to mcp_config.json . The content can be exactly the same as /.cursor/mcp.json .

For Windsurf, it is also strongly recommended to:

  1. Add the notification instructions to your global_rules.md file
  2. Add the notification settings to your memories

This ensures that the AI assistant consistently uses sound notifications when needed.

Customization

Changing the Notification Sound

Modify the following section in the src/index.ts file:

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

System sounds available on macOS can be found in the /System/Library/Sounds/ directory:

  • Bottle.aiff
  • Frog.aiff
  • Funk.aiff
  • Glass.aiff
  • Hero.aiff
  • Morse.aiff
  • Ping.aiff
  • Pop.aiff
  • Purr.aiff
  • Sosumi.aiff
  • Submarine.aiff
  • Tink.aiff

Troubleshooting

If No Sound Plays

  1. Check that the system volume is properly set.
  2. Verify that the specified sound file exists.
  3. Check the terminal output for error messages.

If the MCP Server Fails to Start

  1. Verify that Node.js and Yarn are correctly installed.
  2. Check that dependencies are properly installed:
    yarn install
  3. Check for build errors:
    yarn build

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that plays notification sounds when AI coding assistants like Windsurf or Cursor require user attention, such as when coding is complete or when user approval is needed.

  1. 주의사항 & 면책
    1. 설정
      1. 전제 조건
      2. 설치
      3. Windsurf 및 Cursor에서 설정
    2. 맞춤형
      1. 알림 소리 변경
    3. 문제해결
      1. 소리가 울리지 않으면
      2. MCP 서버가 시작되지 않는 경우
    4. 라이센스
      1. English Version
        1. Notes & Disclaimer
        2. Setup
        3. Customization
        4. Troubleshooting
        5. License

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol implementation that plays sound effects (completion, error, notification) for Cursor AI and other MCP-compatible environments, providing audio feedback for a more interactive coding experience.
        Last updated -
        1
        Python
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
        Last updated -
        11
        61
        TypeScript
        • Linux
        • Apple
      • -
        security
        F
        license
        -
        quality
        An MCP server that gives AI assistants like Cursor, Claude and Windsurf the ability to remember user information across conversations using vector search technology.
        Last updated -
      • A
        security
        A
        license
        A
        quality
        An advanced MCP server that provides interactive feedback mechanisms with support for various feedback types, multi-language capabilities, and team collaboration features for AI tools like Cursor, Cline, and Windsurf.
        Last updated -
        4
        1
        Python
        MIT License
        • Apple
        • Linux

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/ks0318-p/sound-notification-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server