JinDaGe - windows-notify-mcp-tool MCP Details

article

README

🚀 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"
      }
    }
  }
}

⚠️ 重要提示

音频播放优先级：

参数 soundFile (最高优先级)

环境变量 DEFAULT_SOUND

系统默认通知声音

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

工具说明

notify

发送基本通知，各参数说明如下： | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | title | string | 是 | 通知标题 | | message | string | 是 | 通知内容 | | icon | string | 否 | 图标文件路径 (png, jpg, ico) | | sound | boolean | 否 | 是否播放声音 (默认 true) | | soundFile | string | 否 | 自定义音频文件路径 (mp3, wav)，指定后将播放此音频而非默认声音 | | wait | boolean | 否 | 是否等待用户交互 (默认 false) |

notify_with_actions

发送带操作按钮的通知，各参数说明如下： | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | title | string | 是 | 通知标题 | | message | string | 是 | 通知内容 | | actions | string[] | 否 | 操作按钮标签数组 |

基础用法

基本通知

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

带自定义音频的通知

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

带图标的通知

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

带操作按钮的通知

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

windows-notify-mcp-tool