推送通知服务

一个简单的MCP(模型上下文协议)服务器,用于通过ntfy.sh发送推送通知,适用于Claude Desktop和其他MCP兼容客户端。

  • by Aaryan-Kapoor
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 Aaryan-Kapoor/simple-ntfy-mcp

使用说明

简单的Ntfy MCP服务器

一个简单的MCP(模型上下文协议)服务器,用于通过以下方式发送推送通知 ntfy.sh。与Claude Desktop和其他MCP兼容客户端无缝协作。

特性

  • 零配置 -与npx一起开箱即用
  • 推送通知 -通过ntfy向任何设备发送通知
  • 轻量级 -最小依赖性
  • 可定制的 -支持标题、优先级、标签、点击操作和操作按钮

安装与使用

使用npx(推荐)

无需安装!只需添加到您的Claude Desktop配置中(%APPDATA%\Claude\claude_desktop_config.json 在Windows或 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "ntfy": {
      "command": "npx",
      "args": ["-y", "simple-ntfy-mcp"],
      "env": {
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

全球安装

npm install -g simple-ntfy-mcp

然后在Claude Desktop配置中使用:

{
  "mcpServers": {
    "ntfy": {
      "command": "simple-ntfy-mcp",
      "env": {
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

配置

环境变量

变量 描述 默认值
NTFY_DEFAULT_TOPIC 发送通知的默认主题 (必填)
NTFY_BASE_URL ntfy服务器的基本URL https://ntfy.sh

工具: send_ntfy

向您配置的ntfy主题发送推送通知。

参数

参数 类型 必填 说明
message string ✅ 通知消息
topic string ❌ 要发送到的主题(如果未指定,则使用默认值)
title string ❌ 通知标题
priority 编号 ❌ 优先级1-5(默认值:3)
tags string[] ❌ 一大批 标签/表情符号
click string ❌ 单击通知时打开的URL
actions 对象[] ❌ 操作按钮

示例用法

配置后,您可以要求Claude向您发送通知:

“完成此任务后向我发送通知”

或者更具体地说:

发送标题为“构建完成”的高优先级通知和消息“您的项目已完成构建”

示例工具调用

{
  "message": "Your task is complete!",
  "title": "Task Completed",
  "priority": 4,
  "tags": ["white_check_mark", "rocket"],
  "click": "https://example.com"
}

什么是ntfy?

通知命令 是一个简单的基于HTTP的发布-订阅通知服务。它允许您从任何脚本或应用程序向手机或桌面发送推送通知。它是免费的,开源的,你甚至可以自己托管它。

要接收通知,请执行以下操作:

  1. 在您的计算机上安装ntfy应用程序 安卓 或 iOS 设备
  2. 订阅您选择的主题
  3. 使用相同的主题名称配置此MCP服务器

许可证

麻省理工学院