notifications-mcp-server

🚀 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

📚 详细文档

配置指南

基础配置

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. 检查系统设置：确保系统音量未静音。

卸载指南

删除仓库

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/

贡献指南

1. 提交代码前运行格式检查：

black .

2. 创建功能分支并提交更改。

🔧 技术细节

附录

支持的音频格式

• .aiff
• .wav
• .mp3

系统兼容性

• macOS 版本：10.14+

接口文档

请参考官方文档获取详细接口信息。

通过以上步骤，您可以顺利完成 Claude Notification 在 macOS 上的配置与使用。如有任何问题，请随时查阅用户手册或联系支持团队。