📤 ntfy-me-mcp
2025.04.18
4
JavaScript实时通知AI 助手集成任务提醒交流协作
ntfy-me-mcp 是一个基于 Model Context Protocol (MCP) 的服务器，专门用于通过 ntfy 服务（公共或自托管）发送实时通知。它为 AI 助手提供了向用户设备发送通知的能力，适用于任务完成、错误提醒或重要里程碑等场景。该服务器支持丰富的通知功能，包括智能 URL 检测、Markdown 格式化以及安全认证等。
View on GitHub
Overview
基本能力
产品定位
ntfy-me-mcp 是一个专注于实时通知传递的 MCP 服务器，旨在为 AI 助手和开发者提供便捷的通知服务。
核心功能
- 🚀 快速设置：支持通过 npm/npx 或 Docker 快速部署
- 🔔 实时通知：向手机/桌面设备发送任务完成等实时更新
- 🎨 丰富通知：支持主题、标题、优先级、表情标签和详细消息
- 🎯 智能动作链接：自动检测消息中的 URL 并创建查看动作
- 📄 智能 Markdown：自动检测并启用 Markdown 格式化
- 🔒 安全性：支持使用访问令牌进行认证
- 🌐 自托管支持：兼容 ntfy.sh 和自托管 ntfy 实例
适用场景
- AI 助手任务完成通知
- 系统错误或重要事件提醒
- 开发工作流中的状态更新
- 团队协作中的即时通知
工具列表
- npm/npx：用于快速安装和运行服务器
- Docker：用于容器化部署
- VS Code 输入：用于安全处理令牌
常见问题解答
- 如何设置认证？通过 NTFY_TOKEN 环境变量或 VS Code 输入
- 如何自定义通知？通过 taskTitle、taskSummary 等参数
- 如何启用 Markdown？自动检测或手动设置 markdown 参数
使用教程
使用依赖
- Node.js 环境
- npm/npx 工具
- 可选：Docker 环境
安装教程
通过 npm 全局安装
npm install -g ntfy-me-mcp
通过 npx 直接运行
npx ntfy-me-mcp
通过 Docker 运行
docker run -i --rm -e NTFY_TOPIC -e NTFY_URL -e NTFY_TOKEN gitmotion/ntfy-me-mcp
调试方式
- 检查环境变量设置
echo $NTFY_TOPIC
- 测试通知发送
curl -d "Test notification" ntfy.sh/your-topic
- 查看服务器日志
npm start