MCP Notifier 使用说明

项目简介

MCP Notifier 是一个基于 Model Context Protocol (MCP) 的服务器，它扩展了 LLM 应用的能力，使其可以通过桌面通知与用户进行更直接的交互。该服务器利用 'node-notifier' 库，支持在 macOS、Windows 和 Linux 系统上显示原生桌面通知。

主要功能点

简单的通知工具: 提供基础的桌面通知功能。
高级通知工具: 支持更多自定义选项，例如通知类型、超时关闭、自定义按钮等。
多种通知类型: 支持信息 (info)、成功 (success)、警告 (warning)、错误 (error) 等不同类型的通知，并可根据类型显示不同的图标。
可定制的通知设置: 允许设置通知标题、消息内容、图标、声音、超时时间、操作按钮等。
跨平台支持: 兼容 macOS、Windows 和 Linux 操作系统。

安装步骤

您可以通过以下两种方式安装和运行 MCP Notifier 服务器：

方式一：使用 npx 直接运行 (推荐)

这是最简单快捷的方式。您无需下载和构建代码，只需使用 'npx' 命令即可运行：

npx @uehaj/mcp-notifier

方式二：从源代码克隆并构建

如果您希望自定义代码或离线运行，可以选择从 GitHub 克隆仓库并手动构建：

克隆仓库

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

安装依赖
```
npm install
```
构建项目
```
npm run build
```
运行服务器
```
node build/index.js
```

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以 Claude Desktop 为例，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，添加 MCP Notifier 服务器的配置信息。

对于 npx 方式 (推荐):

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

对于本地 Git 克隆方式:

{
  "mcpServers": {
    "mcp-notifier": {
      "command": "node",
      "args": [
        "/absolute/path/to/cloned/mcp-notifier/build/index.js" // 请替换为您的 mcp-notifier 仓库 build/index.js 文件的绝对路径
      ]
    }
  }
}

配置参数说明:

'server name': 'mcp-notifier' (服务器名称，在 Claude Desktop 配置文件中作为键名)
'command': 服务器启动命令。
- npx 方式为 'npx'
- 本地 Git 克隆方式为 'node'
'args': 命令参数。
- npx 方式为 '["@uehaj/mcp-notifier"]'
- 本地 Git 克隆方式为 '["/absolute/path/to/cloned/mcp-notifier/build/index.js"]'，请务必替换为实际路径。

配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

MCP Notifier 服务器注册了两个工具 (Tools)：

'notify': 基础通知工具，参数包括 'title' (标题), 'message' (消息内容), 'icon' (可选图标路径), 'sound' (是否播放声音), 'wait' (是否等待通知关闭)。
'notify-advanced': 高级通知工具，参数包括 'title' (标题), 'message' (消息内容), 'type' (通知类型: "info", "success", "warning", "error"), 'timeout' (自动关闭超时时间), 'closeLabel' (macOS 关闭按钮文本), 'actions' (macOS 操作按钮标签数组)。

LLM 客户端可以通过 MCP 协议调用这些工具来发送桌面通知。例如，使用 'tools/call' 方法，指定工具名称和参数，即可触发相应的桌面通知。具体调用方式请参考 MCP 客户端的文档。

关键词