Sound Notification MCP (JPN followed By ENG)

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

주의사항 & 면책

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

설정

전제 조건

• Node.js (v18 이상)
• Yarn

설치

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

Windsurf 및 Cursor에서 설정

커서

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

Windsurf

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

맞춤형

알림 소리 변경

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

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

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:

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