ntfy-mcp-server

ntfy MCP 服务

一个 Model Context Protocol (MCP) 服务，可让 AI 助手通过 ntfy.sh 发送推送通知。此服务提供了一种简单的方式，可将实时通知集成到 AI 工作流中，让你能够在手机、桌面设备或任何支持 ntfy.sh 的设备上接收提醒。

什么是 ntfy.sh？

ntfy.sh 是一项基于 HTTP 的简单发布-订阅通知服务，可让你向设备发送推送通知。它尤其适用于：

• 在长时间运行的任务完成时接收通知
• 接收自动化工作流发出的提醒
• 及时了解应用中的重要事件

功能

• 向任意 ntfy.sh 频道发送消息
• 支持消息标题、优先级（1-5）和标签
• 轻松集成兼容 MCP 的 AI 助手
• 公共频道无需身份验证

安装

1. 安装依赖项：

npm install --save-dev typescript @types/node ts-node

2. 构建 TypeScript 代码：

npm run build

3. MCP 服务现已位于 ./build/index.js

使用方法

运行服务

构建完成后，你可以直接运行服务：

npm start

或者将 MCP 客户端指向已构建的服务 ./build/index.js。

可用工具

此服务提供一个工具：

send_message

向指定的 ntfy.sh 频道发送消息。

参数：

• channel（必需）：要向其发送消息的 ntfy.sh 频道名称
• message（必需）：要发送的消息内容
• title（可选）：通知标题
• priority（可选）：优先级，范围为 1-5（5 为最高优先级）
• tags（可选）：用于对消息分类的标签数组

在 MCP 客户端中的用法示例：

{
  "tool": "send_message",
  "arguments": {
    "channel": "my-notifications",
    "message": "Task completed successfully!",
    "title": "Workflow Update",
    "priority": 4,
    "tags": ["automation", "success"]
  }
}

配置

无需其他配置。此服务使用 ntfy.sh 公共服务 https://ntfy.sh/。

频道名称

• 频道名称可以是任意字符串，但应确保唯一，以避免冲突
• 可考虑使用描述性名称，例如 my-project-alerts 或 personal-notifications
• 任何知道频道名称的人都可以向其发送消息，因此请谨慎选择

开发

构建脚本

• npm run build - 将 TypeScript 编译为 JavaScript
• npm run build:linux - 在 Linux 上构建并设为可执行文件
• npm run build:windows - 为 Windows 构建
• npm start - 运行编译后的服务

项目结构

• src/index.ts - 服务主要实现
• build/index.js - 编译后的 JavaScript 输出（构建后）

许可证

详情请参阅 LICENSE 文件。