ntfy-me MCP Server

社区

从 AI 代理发送和拉取 ntfy 通知的 MCP 服务器

分类: 其他第 71 / 230
Stars: ★ 76 热门
传输方式: stdio（本地进程）
运行环境: Node.js · Docker
凭据: 可选 API Key
许可证: GPL-3.0
最近提交: 3 天前
工具数: 2

60FMRS · C

ntfy-me-mcp 是一个实用工具，让 AI 代理轻松发送和获取 ntfy 通知。它支持公共和自托管服务器，提供丰富的通知功能，如优先级、标签和 markdown。安装简单，通过 npx 或 Docker 即可。安全性方面，支持令牌认证，但公开主题的隐私需注意。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

12/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 服务器为TypeScript编写，使用MCP SDK 1.29.0，未见明显矛盾。但静态审查无法验证启动流程和工具声明是否与实际行为一致，且未看到测试或CI证据，因此可靠性得分较低（≤12）。
安全与权限 14/20: 支持可选令牌认证，文档强调安全处理令牌（如VS Code输入提示）。未发现恶意代码或超范围行为，但令牌可能通过环境变量或工具参数传递，存在潜在泄露风险。未见敏感操作需确认的机制，但整体上安全风险可控。
维护活跃度 12/20: 仓库活跃，有70星、3个未关闭问题，未存档。许可证为GPL-3.0。但未提供依赖更新策略或安全响应渠道的明确证据，维护治理存在缺口。
文档质量 14/20: README提供了详细的配置示例、工具参数说明、环境变量表、身份验证说明和示例。但缺少故障排除部分，且未说明服务限制（如频率限制）或成本。文档整体可用但存在隐藏假设。
安装易用性 12/20: 提供了npx、Docker、本地构建等多种安装方式，并有多个客户端的配置示例。但未提供CI/CD或测试证据，静态审查无法验证安装步骤是否可靠，因此得分受限。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望将 AI 工作流与移动/桌面通知集成的开发者
需要任务完成或错误警报的 AI 代理
使用 ntfy.sh 或自托管 ntfy 实例的用户

不适合谁

需要电子邮件或图像通知的用户（即将推出）
需要复杂通知工作流的用户
需要非 ntfy 服务的用户

所需权限

能够向配置的 ntfy 主题发送通知
能够从配置的 ntfy 主题获取消息
网络访问，能够访问 ntfy 服务器

风险与副作用

如果主题公开且没有令牌，通知可能被公开读取
如果令牌泄露，可能导致未授权访问
依赖 ntfy 服务的可用性

安装接入

准备工作

运行环境：Node.js · Docker

NTFY_TOPIC 必填用于发布通知的 ntfy 主题；需在 ntfy 应用中订阅同一主题。必填。

NTFY_TOKEN 可选密钥受保护主题或私有服务器的访问令牌；可选，可在你的 ntfy 服务器的访问令牌设置中获取。

其他可选配置项（1 个）

NTFY_URL 可选 ntfy 服务器 URL，默认为 https://ntfy.sh；自托管实例请修改（必要时包含端口）。

在您的设备上安装 ntfy 应用（https://ntfy.sh/app）或自行部署 ntfy 服务器。
在 MCP 客户端配置中添加服务器，使用 npx、Docker 或本地安装。
设置环境变量 NTFY_TOPIC（必需）、NTFY_URL（可选，默认 https://ntfy.sh）和 NTFY_TOKEN（可选）。
通过 npx ntfy-me-mcp 或全局安装 npm install -g ntfy-me-mcp 运行。

claude_desktop_config.json

{
  "mcpServers": {
    "ntfy-me-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-me-mcp"
      ],
      "env": {
        "NTFY_TOPIC": "your-ntfy-topic",
        "NTFY_URL": "https://ntfy.sh",
        "NTFY_TOKEN": "your-access-token"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "ntfy-me-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ntfy-me-mcp"
      ],
      "env": {
        "NTFY_TOPIC": "your-ntfy-topic",
        "NTFY_URL": "https://ntfy.sh",
        "NTFY_TOKEN": "your-access-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add ntfy-me-mcp -e NTFY_TOPIC=your-ntfy-topic -e NTFY_URL=https://ntfy.sh -e NTFY_TOKEN=your-access-token -- npx -y ntfy-me-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置客户端后，确认工具列表中出现 ntfy_me 和 ntfy_me_fetch，然后让它发送一条测试通知，检查已订阅 NTFY_TOPIC 主题的设备是否收到。

常见排障

如果未收到通知，请检查 NTFY_TOPIC 和 NTFY_URL 设置是否正确。
对于受保护主题，确保设置了 NTFY_TOKEN。
测试连接：curl -d "test" ntfy.sh/your-topic。
如果使用 Docker，确保环境变量正确传递。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

构建完成后给我发一条通知
任务完成后用高优先级发送标题为'Code Generation Complete'的通知
显示我最近一小时的通知消息
查找过去24小时内标题为'Build Complete'的通知

工具能力 2

ntfy_me 写入

向指定的 ntfy 主题发送通知，支持标题、消息、优先级、标签、Markdown 和操作。

ntfy_me_fetch 只读

从 ntfy 主题获取和筛选缓存消息，支持按时间、ID、文本、标题、优先级和标签筛选。

使用场景

在 AI 完成任务时发送通知

拉取最近的通知并筛选

向手机或桌面发送实时提醒

在自托管 ntfy 服务器上发送通知

支持客户端

Claude Desktop

VS Code

OpenCode

GitHub Copilot CLI

依据项目文档列出，未经本站实测。

详细介绍

ntfy-me-mcp 是一个模型上下文协议 (MCP) 服务器，使 AI 助手能够通过 ntfy 服务（公共或自托管，支持令牌认证）发送实时通知。它支持丰富的通知功能，包括主题、标题、优先级、标签和详细信息，并支持自动 URL 检测以创建查看操作以及智能 markdown 格式检测。该服务器可通过 npx 或 Docker 快速设置。