mcpField
M
MCP Notify Server

MCP Notify Server

本地服务
github.com/mkusaka开发工具021 周前更新
代码仓库

关于 MCP Notify Server

MCP Notify Server 是面向 Cursor 和 Windsurf 用户的 macOS MCP 服务，会在代码生成完成或需要用户批准时播放系统提示音。

主要功能

  1. 01使用 macOS 系统提示音
  2. 02代码生成完成时通知
  3. 03需要批准时通知
  4. 04轻量实现

适用场景

  1. 01及时发现代码生成已完成
  2. 02响应待处理的批准请求

MCP 相关

它向 MCP 客户端提供通知功能，让 Cursor 或 Windsurf 在需要用户关注时请求播放提示音。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "notify-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mkusaka/mcp-notify-server"
      ]
    }
  }
}
启动命令npx -y @mkusaka/mcp-notify-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@mkusaka/mcp-notify-server

工具

1

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

MCP Notify Server

一个 MCP 服务，可在 Cursor/Windsurf 完成代码生成或需要用户批准时播放通知音效。

功能

  • 使用 macOS 系统通知音效
  • 在代码生成完成时发送通知
  • 在需要用户批准时发送通知
  • 简单轻量

要求

  • macOS
  • Node.js 18 或更高版本

安装

npx -y @mkusaka/mcp-notify-server

或全局安装：

npm install -g @mkusaka/mcp-notify-server

配置

将以下内容添加到 Cursor 配置文件（~/.cursor/config.json）中：

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

规则配置

将以下内容添加到 Cursor 规则文件中：

Always Notify by sound using "notify" every time you need user attention
 - when you need user's approval for running the tool
 - when you finish the task
 - DO NOT MAKE MORE THAN ONE SOUND NOTIFICATION.

开发

设置
git clone https://github.com/mkusaka/mcp-notify-server.git
cd mcp-notify-server
npm install
npm run build
检查

你可以使用 mcp-inspector 以交互方式测试 MCP 服务：

npm run inspect

这样即可在交互环境中测试服务的工具和功能。

可用脚本
  • npm run build - 构建项目
  • npm run start - 启动服务
  • npm run dev - 以监听模式启动开发环境
  • npm run inspect - 启动交互式检查模式

注意事项

  • 目前仅支持 macOS
  • 声音通知取决于大模型的判断，可能导致：
    • 通知时间不准确
    • 偶尔漏掉通知
    • 行为可能有所不同

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

ISC

作者

@mkusaka

参考资料

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。