Sound Notification

🚀 聲音通知 MCP （JPN 優先於 ENG）

本項目搭建了一個MCP服務器，當AI編碼助手（如Windsurf或Cursor）需要用戶關注時，該服務器會播放提示音。無論是代碼編寫完成，還是需要用戶批准，都能通過聲音及時提醒用戶。

🚀 快速開始

本項目是一個MCP服務器，用於在AI編碼助手如Windsurf或Cursor需要用戶注意時播放提示聲音。當代碼編寫完成或需要用戶批准時，即可通過該服務器播放提示聲音。

⚠️ 注意事項&免責聲明

⚠️ 重要提示

• 添加設置時，請務必同時將相關條目添加到規則中。
• 當前僅支持 MacOS（由於創建者使用Mac且無法驗證Windows環境）。
• 由於MCP調用由LLM判斷決定，可能會在意外時間觸發聲音或出現非預期行為。
• 對於Cursor，在命令執行前有時不會播放提示音。
• 使用Windsurf時，可能會出現提示音多次播放的現象（請留意電量消耗）。

📦 安裝指南

前提條件

• Node.js (v18以上版本)
• Yarn包管理器

安裝步驟

# 克隆倉庫
git clone <repository-url>
cd sound-notification-mcp

# 安裝依賴項
yarn install

# 構建項目
yarn build

至此，安裝完成。

在Windsurf或Cursor中的配置

Cursor

在/.cursor/mcp.json文件中提供了示例配置。 （將配置寫入/.cursor/mcp.json意味著每次啟動時會自動應用這些設置。）

Windsurf

確保將以下內容添加到你的全局規則文件global_rules.md和記憶庫中：

### 聲音通知 MCP 設置
- 在需要提示時使用聲音通知。
- 提示聲音路徑：`/System/Library/Sounds/Glass.aiff`

這將確保AI助手在必要時始終使用聲音通知。

💻 使用示例

基礎用法

若需更改提示聲音，可修改以下部分的代碼：

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 許可證。