Notifications MCP Server

🚀 Claude Notification macOS 通知系統

Claude Notification 是一款 macOS 應用程序，專門用於在 Claude Desktop 中發送桌面通知。它能讓用戶及時獲取相關信息，提升使用體驗。以下將詳細介紹其安裝、配置、使用等方面的內容。

🚀 快速開始

Claude Notification 可幫助你在 macOS 系統中，於 Claude Desktop 實現桌面通知功能。通過以下步驟，你能快速完成配置並使用。

📦 安裝指南

克隆倉庫

git clone https://github.com/notifications-mcp-server
cd notifications-mCP-server

安裝 Python 依賴項

uv pip install -r requirements.txt

運行示例腳本測試功能

python3 example.py

📚 詳細文檔

配置指南

基礎配置

1. 打開 claude_desktop_config.json 文件。
2. 在 "notification" 對象中添加以下字段：
   • "enabled": true：啟用通知功能。
   • "method": "NotificationCenter"：選擇使用 macOS 的內置 NotificationCenter。

高級設置

• 自定義聲音路徑：

"custom-sound-path": "/System/Library/Sounds/Glass.aiff"

• 禁用視覺效果：

"visual-effect": "none"

個性化設置

自定義聲音

• 使用默認系統聲音：

afplay /System/Library/Sounds/Glass.aiff

• 設置自定義聲音：

echo 'export CLA-SOUND="/System/Library/Sounds/Ping.aiff"' >> ~/.zshrc
source ~/.zshrc

調整顯示設置

1. 在終端中運行以下命令：

defaults write com.example.notif display-settings -dict modal-height 200

2. 重啟應用程序以應用更改。

故障排除

視覺效果不顯示

1. 檢查配置文件：確保 "visual-effect" 設置正確。
2. 測試通知系統：

python3 test-visual.py

聲音未播放

1. 驗證聲音路徑：確認音頻文件存在且格式為 .aiff。
2. 檢查系統設置：確保系統音量未靜音。

卸載指南

1. 刪除倉庫：

rm -rf /path/to/notifications-mcp-server

2. 移除 Python 包：

uv pip uninstall notifications-mcp-server fastmcp pyobjc-core pyobjc-framework-Cocoa pync

開發指南

項目要求

• Python 版本：3.10+
• 必要庫：fastmCP, terminal-notifier, pyobjc

運行測試

python3 -m pytest tests/

貢獻指南

1. 提交代碼前運行格式檢查：

black .

2. 創建功能分支並提交更改。

附錄

支持的音頻格式

• .aiff
• .wav
• .mp3

系統兼容性

• macOS 版本：10.14+

接口文檔

請參考官方文檔獲取詳細接口信息。

通過以上步驟，您可以順利完成 Claude Notification 在 macOS 上的配置與使用。如有任何問題，請隨時查閱用戶手冊或聯繫支持團隊。