mcp-notify

一个极简的 MCP 服务器，当你的 AI 代理完成任务或需要你注意时，它会在你的电脑上播放通知音效并显示系统横幅。

适用于任何 MCP 客户端：Claude Desktop、Claude Code、Cursor、VS Code、opencode、Cline 等。只需 3 行配置，无需 API 密钥，无需网络调用——它只会调用你本地的音频和通知功能。

安装

在客户端的 MCP 配置中添加（Claude Desktop 的 claude_desktop_config.json、Cursor / VS Code 的 mcp.json、或 opencode 配置）：

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"]
    }
  }
}

（opencode 用户：同样的形式，放在 mcp 键下，使用 "type": "local" 和 "command": ["npx", "-y", "@mrfqcentic/mcp-notify"]。）

需要 Node.js >= 20。

Related MCP server: Notifications MCP Server

让代理调用它

在你的 AGENTS.md / CLAUDE.md / 系统提示中加一行：

When a task is done or the user should be alerted, call the `notify` tool with a short title and a 1–2 sentence description of the result.

工具

notify

播放音效并显示横幅。代理总是提供 title（最多 50 个字符）和 message（最多 200 个字符）。

list_sounds

列出可用的音效以及当前选定的默认音效。

选择你的音效

解析顺序：

1. NOTIFY_SOUND 环境变量——绝对路径，明确且确定

2. sounds/ 文件夹中名称以 default 开头的文件（你的自定义音效）

3. sounds/ 文件夹中第一个音频文件（按字母顺序——这里自带 notify-me.mp3 作为默认音效）

4. assets/ 中生成的提示音

5. 系统音效（macOS 的 Glass.aiff，Linux 的 bell.oga）

提示：将你喜欢的音效重命名或复制到 sounds/default.mp3（或设置 NOTIFY_SOUND）来固定使用。

自带的 sounds/notify-me.mp3 是在商业许可下使用 ElevenLabs 生成的。

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"],
      "env": { "NOTIFY_SOUND": "/absolute/path/to/your-sound.mp3" }
    }
  }
}

提示：带音轨的 MP4 文件也能用（macOS 的 afplay 会读取音频流）。

平台

任何 CI 环境变量值都会让音效和横幅播放变为空操作（在 CI 工作流中自动设置），这样测试套件就可以在没有音频的机器上运行。

开发

npm install
npm run typecheck
npm test          # builds, then runs the e2e suite (sound + banner fire locally)

许可证

MIT——参见 LICENSE。