适合谁
- 希望将 AI 工作流与移动/桌面通知集成的开发者
- 需要任务完成或错误警报的 AI 代理
- 使用 ntfy.sh 或自托管 ntfy 实例的用户
N
60FMRS · C
ntfy-me-mcp 是一个实用工具，让 AI 代理轻松发送和获取 ntfy 通知。它支持公共和自托管服务器，提供丰富的通知功能，如优先级、标签和 markdown。安装简单，通过 npx 或 Docker 即可。安全性方面，支持令牌认证，但公开主题的隐私需注意。
ntfy-me-mcp 是一个模型上下文协议 (MCP) 服务器，使 AI 助手能够通过 ntfy 服务（公共或自托管，支持令牌认证）发送实时通知。它支持丰富的通知功能，包括主题、标题、优先级、标签和详细信息，并支持自动 URL 检测以创建查看操作以及智能 markdown 格式检测。该服务器可通过 npx 或 Docker 快速设置。
工具能力
ntfy_me
向指定的 ntfy 主题发送通知，支持标题、消息、优先级、标签、Markdown 和操作。
ntfy_me_fetch
从 ntfy 主题获取和筛选缓存消息，支持按时间、ID、文本、标题、优先级和标签筛选。
安装接入
- 在您的设备上安装 ntfy 应用（https://ntfy.sh/app）或自行部署 ntfy 服务器。2. 在 MCP 客户端配置中添加服务器，使用 npx、Docker 或本地安装。3. 设置环境变量 NTFY_TOPIC（必需）、NTFY_URL（可选，默认 https://ntfy.sh）和 NTFY_TOKEN（可选）。4. 通过 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"
}
}
}
}
选型与风险
不适合谁
- 需要电子邮件或图像通知的用户（即将推出）
- 需要复杂通知工作流的用户
- 需要非 ntfy 服务的用户
所需权限
- 能够向配置的 ntfy 主题发送通知
- 能够从配置的 ntfy 主题获取消息
- 网络访问，能够访问 ntfy 服务器
风险与副作用
- 如果主题公开且没有令牌，通知可能被公开读取
- 如果令牌泄露，可能导致未授权访问
- 依赖 ntfy 服务的可用性
常见排障
- 如果未收到通知，请检查 NTFY_TOPIC 和 NTFY_URL 设置是否正确。
- 对于受保护主题，确保设置了 NTFY_TOKEN。
- 测试连接：curl -d "test" ntfy.sh/your-topic。
- 如果使用 Docker，确保环境变量正确传递。
使用场景
在 AI 完成任务时发送通知
拉取最近的通知并筛选
向手机或桌面发送实时提醒
在自托管 ntfy 服务器上发送通知
支持客户端
Claude Desktop完整支持
VS Code完整支持
OpenCode完整支持
Copilot CLI完整支持
Smithery完整支持