MCP Notify Server

MCP Notify Server

site icon
2025.03.22 0
JavaScript通知服务开发工具开发效率
MCP Notify Server 是一个用于在代码生成完成或需要用户批准时播放通知声音的 MCP 服务器。它使用 macOS 系统通知声音,简单轻量,适用于开发环境中的通知需求。
View on GitHub

Overview

基本能力

产品定位

MCP Notify Server 是一个专注于开发效率的工具,通过在代码生成或需要用户批准时播放通知声音,帮助开发者及时响应任务状态变化。

核心功能

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

适用场景

  • 开发环境中代码生成完成的通知
  • 需要用户批准操作时的提醒

工具列表

  • mcp-inspector: 用于交互式测试 MCP 服务器的工具,可以测试服务器的功能和工具。

常见问题解答

  • 目前仅支持 macOS 系统。
  • 声音通知依赖于 LLM 的判断,可能会导致通知时机不准确或偶尔遗漏通知。

使用教程

使用依赖

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

安装教程

通过 npx 安装

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

交互式测试

npm run inspect

可用脚本

  • npm run build: 构建项目
  • npm run start: 启动服务器
  • npm run dev: 启动开发模式(带监视)
  • npm run inspect: 启动交互式测试模式

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。