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": ["查看", "忽略"]
}