🚀 Claude Notification macOS 通知系统
Claude Notification 是一款 macOS 应用程序，专为在 Claude Desktop 中发送桌面通知而设计。它能让用户及时获取相关信息，提升使用体验。下面将详细介绍该应用在 macOS 上的配置和使用方法。
🚀 快速开始
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
📚 详细文档
配置指南
基础配置
- 打开
claude_desktop_config.json文件。 - 在
"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
调整显示设置
- 在终端中运行以下命令：
defaults write com.example.notif display-settings -dict modal-height 200
- 重启应用程序以应用更改。
故障排除
视觉效果不显示
- 检查配置文件：确保
"visual-effect"设置正确。 - 测试通知系统：
python3 test-visual.py
声音未播放
- 验证声音路径：确认音频文件存在且格式为
.aiff。 - 检查系统设置：确保系统音量未静音。
卸载指南
删除仓库
rm -rf /path/to/notifications-mcp-server
移除 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/
贡献指南
- 提交代码前运行格式检查：
black .
- 创建功能分支并提交更改。
🔧 技术细节
附录
支持的音频格式
.aiff.wav.mp3
系统兼容性
- macOS 版本：10.14+
接口文档
请参考官方文档获取详细接口信息。
通过以上步骤，您可以顺利完成 Claude Notification 在 macOS 上的配置与使用。如有任何问题，请随时查阅用户手册或联系支持团队。