AI导哈

桌面通知服务

MCP Notifier是一个基于Model Context Protocol（MCP）的服务，提供跨平台的桌面通知功能，支持多种通知类型和自定义设置。

  • by uehaj
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 uehaj/mcp-notifier

使用说明

MCP通知器

一种使用节点通知器提供桌面通知功能的模型上下文协议（MCP）服务器。

特性

  • 简单的通知工具
  • 具有附加选项的高级通知工具
  • 支持不同的通知类型（信息、成功、警告、错误）
  • 可自定义的通知设置

平台支持

此MCP服务器使用 节点通知器 并跨多个平台工作：

  • macOS：使用macOS通知中心
  • 视窗：使用Windows吐司通知（Windows 8+）或任务栏气球（<Windows 8）
  • Linux：使用notify send命令发送Gnome/Ubuntu通知

有关平台特定行为的更多详细信息，请访问 节点通知器文档.

使用选项

您可以通过两种方式使用MCP通知程序：

选项1：直接使用npx运行

使用MCP Notifier的最简单方法是使用npx：

# Run directly with npx
npx @uehaj/mcp-notifier

这将使用单个命令下载并执行该包。

选项2：从源代码克隆和构建

# Clone repository
git clone https://github.com/uehaj/mcp-notifier.git
cd mcp-notifier

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
node build/index.js

与Claude Desktop集成

  1. 编辑您的Claude Desktop配置文件：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  2. 选择以下配置方法之一：

对于npx方法（推荐）：

{
  "mcpServers": {
    "mcp-notifier": {
      "command": "npx",
      "args": [
        "@uehaj/mcp-notifier"
      ]
    }
  }
}

对于本地git clone方法：

{
  "mcpServers": {
    "mcp-notifier": {
      "command": "node",
      "args": [
        "/absolute/path/to/cloned/mcp-notifier/build/index.js"
      ]
    }
  }
}
  1. 重新启动克劳德桌面

Smithery集成

此MCP服务器可在 史密瑟里。由于它需要桌面访问才能正常运行，因此必须在本地安装，而不是用作托管服务。

通过Smithery CLI运行：

# Run using Smithery CLI
npx @smithery/cli run @uehaj/mcp-notifier

从存储库手动设置：

按照上面的“从源代码克隆和构建”说明进行操作。

可用工具

通知

具有以下参数的基本通知工具：

  • title：通知标题（必填）
  • message：通知消息（必填）
  • icon：图标文件的可选路径
  • sound：是否播放声音（可选布尔值）
  • wait：是否等待通知关闭（可选布尔值）

通知高级

具有更多选项的高级通知工具：

  • title：通知标题（必填）
  • message：通知消息（必填）
  • type：通知类型-“信息”、“成功”、“警告”或“错误”（可选）
  • timeout：自动关闭超时（毫秒）（可选）
  • closeLabel：关闭按钮文本（仅限macOS，可选）
  • actions：操作按钮标签数组（仅限macOS，可选）

测试

运行测试：

# For npx method
npx @modelcontextprotocol/inspector npx @uehaj/mcp-notifier

# For git clone method
cd mcp-notifier
npx @modelcontextprotocol/inspector node build/index.js

发展

发布到npm

该包包括几个npm脚本来帮助发布：

# Publish the current version
npm run release

# Increment patch version (1.0.0 -> 1.0.1) and publish
npm run release:patch

# Increment minor version (1.0.0 -> 1.1.0) and publish
npm run release:minor

# Increment major version (1.0.0 -> 2.0.0) and publish
npm run release:major

这些命令将：

  1. 自动运行构建过程
  2. 根据需要更新版本号
  3. 将包发布到具有公共访问权限的npm

你需要登录到npm(npm login)在运行这些命令之前。

需求

  • Node.js 18或更高版本
  • npm 6或更高版本
  • 桌面环境（Windows、macOS或Linux）
  • 通知系统的访问权限

许可证

麻省理工学院

相关 MCP