Sys Notification MCP

MCP跨平台系统通知服务器

中文

厌倦了编码时错过重要通知？试试这个MCP+规则解决方案，永远不会错过任何一个节拍。

一种模型上下文协议（MCP）服务器，为AI助手提供跨平台系统通知功能，支持macOS、Windows和Linux，并提供完整的声音支持。

🎯 特性

跨平台通知支持

• macOS：完全支持14种系统声音的本地系统通知
• 视窗：吐司通知+系统声音播放
• Linux：桌面通知+堪培拉gtk播放/壁纸系统声音

通知类型

• 授权：需要用户授权时（例如，运行终端命令）
• 完成：任务完成时（例如，代码生成完成）
• 等待：等待用户响应时
• 错误：发生错误时
• 信息：一般信息通知

声音支持

所有平台都支持相同的14种声音，并具有自动跨平台映射功能：

📋 用法

基本通知

{
  "serverName": "sys-notification-mcp",
  "toolName": "notify",
  "arguments": {
    "type": "completed",
    "message": "Code generation completed, please check the result"
  }
}

自定义通知

{
  "serverName": "sys-notification-mcp",
  "toolName": "notify",
  "arguments": {
    "type": "authorization",
    "message": "Your authorization is required to run terminal commands",
    "title": "🔐 Permission Request",
    "sound": "Glass"
  }
}

查询功能

// List all notification types
{
  "serverName": "sys-notification-mcp",
  "toolName": "list_notification_types"
}

// Get system information
{
  "serverName": "sys-notification-mcp",
  "toolName": "get_system_info"
}

🔧 安装和配置

需求

• Node.js 18+
• 平台特定通知支持：

- macOS：无其他依赖项 - Windows:PowerShell 5.0+ - Linux：通知发送（通常与桌面环境一起安装）

方法1：全局npm安装（推荐）

# Install MCP server globally
npm install -g sys-notification-mcp

# Verify installation
sys-notification-mcp --help

方法2：本地源安装

# Clone the project
git clone 
cd sys-notification-mcp

# Install dependencies
npm install

# Run local tests
node index.js

MCP客户端配置

全局安装（方法1）

添加到MCP客户端配置文件：

{
  "mcpServers": {
    "sys-notification-mcp": {
      "command": "sys-notification-mcp"
    }
  }
}

本地安装（方法2）

添加到MCP客户端配置文件（使用绝对路径）：

{
  "mcpServers": {
    "sys-notification-mcp": {
      "command": "node",
      "args": ["/path/to/sys-notification-mcp/index.js"]
    }
  }
}

配置验证

配置后，重新启动MCP客户端。人工智能助手应该能够识别和使用通知功能。

📜 推荐：与规则文件一起使用

为什么使用规则文件？

该项目包括一个精心设计的规则文件 rule.txt 强烈建议所有AI助手确保：

• 一致的用户体验：跨平台的统一通知行为
• 及时的用户交互：在关键时刻通知用户
• 错误处理：出现问题时立即通知
• 性能优化：避免过多的通知影响用户体验

规则文件内容概述

规则文件定义了完整的通知行为规范：

1. 强制性规则：回答问题后必须发送通知
2. 通知类型定义：5种标准通知类型及其使用场景
3. 调用时间规则：关于何时发送通知的详细指南
4. 技术实施规范：MCP工具调用的标准格式
5. 跨平台兼容性：macOS、Windows、Linux的优化说明

规则文件使用示例

// According to the rule file, AI assistants should send notifications after task completion
{
  "serverName": "sys-notification-mcp",
  "toolName": "notify",
  "arguments": {
    "type": "completed",
    "message": "Code refactoring completed, please check the result"
  }
}

获取规则文件

规则文件位于项目根目录中： rule.txt

人工智能助手应定期检查规则文件的更新，以确保使用最新的最佳实践。

🛠️ 开发指南

项目结构

sys-notification-mcp/
├── index.js          # Main server file
├── package.json      # Project configuration
├── README.md         # Documentation (English)
├── README_zh.md      # Chinese documentation
├── rule.txt          # AI behavior rules (recommended)
├── test-cross-platform.js # Functionality test script
└── IMPLEMENTATION.md # Technical implementation documentation

核心功能

• sendNotification()：主要通知发送功能
• playSound()：跨平台声音播放
• getOS()：操作系统检测
• 平台特定的通知实施功能

扩展声音

要添加新声音，请将新映射添加到 SOUND_MAPPING 对象：

const SOUND_MAPPING = {
  "NewSound": { 
    macos: "NewSound", 
    windows: "SystemDefault", 
    linux: "dialog-information" 
  }
};

🌍 平台兼容性

macOS

• ✅ 完全原生通知支持
• ✅ 支持所有14种系统声音
• ✅ 不需要额外的依赖关系

视窗

• ✅ Toast通知支持
• ✅ 通过PowerShell播放SystemSounds
• ✅ 需要PowerShell 5.0+

Linux

• ✅ 桌面通知支持（通知发送）
• ✅ 通过canberra gtk play或paplay播放声音
• ✅ 需要桌面环境支持

📝 使用场景

场景1：代码生成完成

{
  "type": "completed",
  "message": "React component generation completed with full TypeScript type definitions"
}

场景2：需要用户授权

{
  "type": "authorization",
  "message": "Your confirmation is required to install project dependencies",
  "sound": "Glass"
}

场景3：错误处理

{
  "type": "error",
  "message": "Compilation failed: Missing required dependencies",
  "sound": "Basso"
}

🔍 故障排除

常见问题

1. Linux上没有声音

- 安装canberra gtk play： sudo apt-get install libcanberra-gtk-module - 或者安装pulseaudio实用程序： sudo apt-get install pulseaudio-utils

1. Windows通知未显示

- 确保PowerShell执行策略允许脚本执行 - 检查是否启用了系统通知设置

1. macOS听起来不工作

- 检查系统声音设置 - 确认通知中心权限

调试信息

使用 get_system_info 获取当前系统支持信息的工具：

{
  "serverName": "sys-notification-mcp",
  "toolName": "get_system_info"
}

📄 许可证

MIT许可证

🤝 贡献

欢迎提交问题和拉取请求以改进此项目！

______________________________________________________________________

备注：此MCP服务器专为AI助手设计，可确保在需要交互时及时通知用户，增强AI助手的交互体验。强烈建议与 rule.txt 规则文件，以获得最佳用户体验。