Windows Notify MCP Tool

🚀 Windows Notify MCP

Windows Notify MCP 是一个用于发送 Windows 桌面通知的 MCP (Model Context Protocol) 服务器，能帮助你便捷地在 Windows 系统上实现桌面通知功能。

🚀 快速开始

本项目可通过以下步骤完成安装与配置，从而实现 Windows 桌面通知功能。

✨ 主要特性

• notify - 发送基本的 Windows 桌面通知。
• notify_with_actions - 发送带有操作按钮的通知。

📦 安装指南

在项目根目录下执行以下命令进行安装和构建：

pnpm install
pnpm build

💻 使用示例

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加相关配置：

• Windows：配置文件路径为 %APPDATA%\Claude\claude_desktop_config.json。

{
  "mcpServers": {
    "windows-notify": {
      "command": "node",
      "args": ["D:/2024Dev/2026/MCP/windows_notify_mcp/dist/index.js"]
    }
  }
}

带环境变量配置

若需要设置默认音频文件，可添加 DEFAULT_SOUND 环境变量：

{
  "mcpServers": {
    "windows-notify": {
      "command": "node",
      "args": ["D:/2024Dev/2026/MCP/windows_notify_mcp/dist/index.js"],
      "env": {
        "DEFAULT_SOUND": "D:/sounds/notification.mp3"
      }
    }
  }
}

⚠️ 重要提示

音频播放优先级：

1. 参数 soundFile (最高优先级)
2. 环境变量 DEFAULT_SOUND
3. 系统默认通知声音

只有当 sound: true（默认）时才会播放音频。

工具说明

notify

发送基本通知，各参数说明如下：

notify_with_actions

发送带操作按钮的通知，各参数说明如下：

基础用法

基本通知

{
  "title": "任务完成",
  "message": "您的构建已完成"
}

带自定义音频的通知

{
  "title": "下载完成",
  "message": "文件已保存",
  "soundFile": "D:/sounds/ding.mp3"
}

带图标的通知

{
  "title": "提醒",
  "message": "会议将在5分钟后开始",
  "icon": "D:/icons/reminder.png",
  "sound": true
}

带操作按钮的通知

{
  "title": "新消息",
  "message": "您有一条新消息",
  "actions": ["查看", "忽略"]
}