Macos Notification Mcp

🔔 macOS 通知 MCP

一个模型上下文协议（MCP）服务，可让 AI 助手触发 macOS 通知、播放声音并将文本转换为语音。

✨ 功能

• 🔊 声音通知：播放 Submarine、Ping 或 Tink 等系统声音
• 💬 横幅通知：显示可自定义标题、消息和副标题的视觉通知
• 🗣️ 语音通知：将文本转换为语音，并可调整音色、语速和音量
• 🎙️ 音色管理：列出并选择可用的系统音色
• 🧪 测试工具：用于验证所有通知方式的诊断工具

🚀 使用 uvx 快速开始（推荐）

使用此工具最快捷的方式是通过 uvx 运行软件包，无需永久安装：

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the MCP server directly (no installation needed)
uvx macos-notification-mcp

⚙️ 配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "macos-notification-mcp": {
      "command": "uvx",
      "args": ["macos-notification-mcp"]
    }
  }
}

然后重启 Claude Desktop。

📦 其他安装方式

标准安装：

pip install macos-notification-mcp

从源代码安装：

git clone https://github.com/devizor/macos-notification-mcp
cd macos-notification-mcp
pip install .

🛠️ 可用的通知工具

🔊 声音通知

sound_notification(sound_name="Submarine")

可用声音：Basso、Blow、Bottle、Frog、Funk、Glass、Hero、Morse、Ping、Pop、Purr、Sosumi、Submarine、Tink

💬 横幅通知

banner_notification(
    title="Task Complete",
    message="Your analysis is ready",
    subtitle=None,  # Optional
    sound=False,    # Optional: Play sound with notification
    sound_name=None # Optional: Specify system sound
)

🗣️ 语音通知

speak_notification(
    text="The process has completed",
    voice=None,     # Optional: System voice to use
    rate=150,       # Optional: Words per minute (default: 150)
    volume=1.0      # Optional: Volume level 0.0-1.0
)

🎙️ 音色管理

list_available_voices()  # Lists all available text-to-speech voices

🧪 测试

test_notification_system()  # Tests all notification methods

🔒 实现细节

• ⏱️ 速率限制：通知逐个处理，最小间隔为 0.5 秒
• 🔄 排队：多个通知请求会按顺序处理
• 🪟 操作系统集成：使用原生 macOS 命令（afplay、osascript、say）
• 🔌 FastMCP：基于 FastMCP 框架构建，用于 AI 通信

⚠️ 故障排除

• 🔐 权限：确保在“系统设置”→“通知”中允许通知
• ⏳ 时序：一次只处理一条通知
• 🌐 环境：如果直接使用命令（而非 uvx），可能需要使用完整路径

📄 许可证

MIT 许可证