AI 에이전트가 작업을 완료했을 때 알림음을 재생할 수 있게 해주는 Model Context Protocol (MCP) 서버입니다. 이 TypeScript 기반 MCP 서버는 npx를 통해 별도의 설정 없이 즉시 사용할 수 있는 번들 사운드가 포함된 간단하고 설정 가능한 알림 시스템을 제공합니다!

play_notification

• 작업 완료를 나타내는 알림음 재생
• 알림과 함께 표시할 선택적 message 파라미터 지원
• 크로스 플랫폼 사운드 재생 지원 (Windows 및 macOS)
  번들 사운드로 작동- 수동 다운로드가 필요 없습니다!

패키지에 포함된 5가지 고품질 알림 사운드:

cosmic

• 우주 테마의 알림 🌌
  fairy
• 마법 같고 기발한 톤 🧚‍♀️
  gentle
• 부드럽고 기분 좋은 기본 사운드 (기본값) 🔔
  pleasant
• 균형 잡힌 전문적인 톤 📞
  retro
• 향수를 불러일으키는 빈티지 스타일의 알림 🕹️
  random
• 5가지 사운드 중 하나를 무작위로 재생 🎲

npx로 바로 실행하세요 - 사운드가 포함되어 있습니다!

{
"mcpServers": {
"notifications": {
...

{
"mcpServers": {
"notifications": {
...

{
"mcpServers": {
"notifications": {
...

{
"mcpServers": {
"notifications": {
...

알림음은 환경 변수(environment variables)를 사용하여 설정할 수 있습니다:

사용자 지정 경로 (MCP_NOTIFICATION_SOUND_PATH) - 최우선 순위
번들 사운드 (MCP_NOTIFICATION_SOUND) - 포함된 5가지 사운드 중 선택
기본값 - 아무것도 지정되지 않은 경우 gentle 차임벨

설정이 완료되면, MCP 클라이언트에서 play_notification 도구를 호출할 수 있습니다:

await client.request({
method: "tools/call",
params: {
...

# 저장소 클론 (Clone the repository)
git clone https://github.com/pinkpixel-dev/notification-mcp.git
cd notification-mcp
...

{
"mcpServers": {
"notifications": {
...

대화형 디버깅 (interactive debugging)을 위해 MCP Inspector를 사용하세요:

npm run inspector

Inspector는 브라우저에서 MCP 서버를 테스트할 수 있는 웹 인터페이스를 제공합니다.

별도의 설치가 필요하지 않습니다 - 사운드가 자동으로 번들링됩니다:

npx @pinkpixel/notification-mcp

npm install -g @pinkpixel/notification-mcp
notification-mcp

npm install @pinkpixel/notification-mcp
npx notification-mcp

모든 사운드 파일은 sounds/ 디렉토리에 위치하며, 패키지를 설치할 때 자동으로 포함됩니다:

• Cosmic:
  sounds/cosmic_chime.mp3

• 🌌 우주 테마 (Space-themed) - Fairy:
  sounds/fairy_chime.mp3

• 🧚‍♀️ 마법 같은 (Magical) - Gentle:
  sounds/gentle_chime.mp3

• 🔔 기본값 (soft) - Pleasant:
  sounds/pleasant_chime.mp3

• 📞 전문적인 (Professional) - Retro:
  sounds/retro_chime.mp3

• 🕹️ 빈티지 (Vintage) - 무작위 (Random): MCP_NOTIFICATION_SOUND=random 설정

• 🎲 깜짝 선물!

기여(contributions)를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조해 주세요.

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

웹사이트: pinkpixel.dev
GitHub: github.com/pinkpixel-dev
Discord: @sizzlebop

Made with ❤️ by Pink Pixel ✨