Claude Notification Server

Notifications MCP Server

MCP 服务，通过 task_status 工具让 Claude Desktop 或其他 MCP 客户端触发 macOS 声音和视觉通知。

当前状态

这是一个专注于 macOS 的实用工具。它本身不会自动检测 Claude 是否已完成：MCP 客户端或模型必须在需要通知时调用 task_status 工具。

目前可用功能

• 注册 task_status MCP 工具。
• 使用 afplay 播放 macOS 系统声音。
• 使用 terminal-notifier、AppleScript、PyObjC 或 pync 作为回退方式发送视觉通知。
• 支持分别设置开始和完成声音。
• 支持通过环境变量禁用视觉通知。
• 包含针对模块化通知和声音管理器的测试。

重要限制

• 目前仅实现了 macOS 平台。
• 尚未实现 Linux 和 Windows 支持。
• 只有在调用 MCP 工具时才会发送通知。
• 打包后的控制台脚本为 claude-notifications。
• Python 包为 notifications；不存在 notifications_mcp_server 模块入口点。
• 自定义声音配置使用环境变量，而非旧版 README 中展示的 JSON 配置块。

安装

pip install notifications-mcp-server

可选的视觉通知依赖项：

pip install "notifications-mcp-server[visual]"
pip install "notifications-mcp-server[pync]"

用于支持 terminal-notifier 回退方式：

brew install terminal-notifier

Claude Desktop 配置

使用由软件包安装的控制台脚本：

{
  "mcpServers": {
    "notifications": {
      "command": "claude-notifications"
    }
  }
}

更改配置后，请重启 Claude Desktop。

配置

环境变量：

export CLAUDE_START_SOUND="/System/Library/Sounds/Glass.aiff"
export CLAUDE_COMPLETE_SOUND="/System/Library/Sounds/Hero.aiff"
export CLAUDE_VISUAL_NOTIFICATIONS="true"
export CLAUDE_NOTIFICATION_ICON="/path/to/icon.png"

如果未设置自定义声音，服务将使用 macOS 系统声音。

MCP 工具

task_status

输入：

{
  "message": "Task completed"
}

包含 start 或 processing 的消息会被视为开始通知。其他消息会被视为完成通知。

验证演示

在 macOS 上运行本地诊断脚本，测试可用的通知方式：

python3 test_notification.py

尝试发送声音和视觉通知后，MCP 工具会返回简洁的状态对象：

{
  "status": "success",
  "message": "Task completed",
  "sound": "/System/Library/Sounds/Hero.aiff",
  "visual": true
}

如需更安静的冒烟测试，可跳过视觉通知提示：

CLAUDE_VISUAL_NOTIFICATIONS=false claude-notifications

开发

git clone https://github.com/charles-adedotun/notifications-mcp-server.git
cd notifications-mcp-server
pip install -e ".[dev]"
pytest

许可证

MIT