article
README
🚀 💬 Notify MCP Server
提供消息推送的 MCP (Model Context Protocol) 服务器,支持企业微信、钉钉、Telegram、Bark、Lark、飞书、Home Assistant 等多种平台,为用户提供便捷的消息通知服务。
🚀 快速开始
- 在线体验:
- 在线体验:
- 添加到 Cursor
- 添加到 VS Code
- 添加到 Cherry Studio
- 添加到 Claude Code, 执行命令:
claude mcp add notify -- uvx mcp-notify - 添加到 OpenAI CodeX, 执行命令:
codex mcp add notify -- uvx mcp-notify
✨ 主要特性
- 支持多种消息推送平台,包括企业微信、钉钉、Telegram 等。
- 提供多种消息类型的发送功能,如文本、图片、视频等。
- 可通过环境变量配置不同平台的参数,方便灵活使用。
📦 安装指南
方式1: uvx
{
"mcpServers": {
"mcp-notify": {
"command": "uvx",
"args": ["mcp-notify"],
"env": {
"WEWORK_BOT_KEY": "your-wework-bot-key"
}
}
}
}
方式2: Smithery
需要通过OAuth授权或Smithery key
{
"mcpServers": {
"mcp-aktools": {
"url": "https://server.smithery.ai/@aahl/mcp-notify/mcp" # 流式传输HTTP
}
}
}
方式3: Docker
mkdir /opt/mcp-notify
cd /opt/mcp-notify
wget https://raw.githubusercontent.com/aahl/mcp-notify/refs/heads/main/docker-compose.yml
docker-compose up -d
{
"mcpServers": {
"mcp-notify": {
"url": "http://0.0.0.0:8809/mcp" # 流式传输HTTP
}
}
}
⚙️ 环境变量
企业微信群机器人
WEWORK_BOT_KEY: 企业微信群机器人默认key,也可以在提示词指定。
企业微信应用号
WEWORK_APP_CORPID: 企业微信所属的企业ID。WEWORK_APP_SECRET: 企业微信应用的凭证密钥。WEWORK_APP_AGENTID: 企业微信应用的ID,默认:1000002。WEWORK_APP_TOUSER: 企业微信默认接收人ID,也可以在提示词指定,默认:@all。WEWORK_BASE_URL: 企业微信API反代理地址,用于可信IP,默认:https://qyapi.weixin.qq.com。
钉钉群机器人
DINGTALK_BOT_KEY: 钉钉群机器人access_token。DINGTALK_BASE_URL: 钉钉API地址,默认:https://oapi.dingtalk.com。
飞书/Lark群机器人
FEISHU_BOT_KEY: 飞书群机器人key,也可以在提示词指定。FEISHU_BASE_URL: 飞书API地址,默认:https://open.feishu.cn。LARK_BOT_KEY: Lark群机器人key,也可以在提示词指定。LARK_BASE_URL: Lark API地址,默认:https://open.larksuite.com。
Telegram
TELEGRAM_DEFAULT_CHAT: Telegram 默认会话ID,也可以在提示词指定。TELEGRAM_BOT_TOKEN: Telegram 机器人令牌。TELEGRAM_BASE_URL: Telegram API反代理地址,默认:https://api.telegram.org。
Home Assistant
HASS_BASE_URL: Home Assistant 地址,默认:http://homeassistant.local:8123。HASS_ACCESS_TOKEN: Home Assistant 长效令牌。HASS_MOBILE_KEY: Home Assistant 移动设备key (如: mobile_app_your_iphone),也可在提示词指定。
其他
BARK_DEVICE_KEY: 默认Bark设备key,也可以在提示词指定。BARK_BASE_URL: Bark API地址,默认:https://api.day.app。NTFY_DEFAULT_TOPIC: 默认Ntfy订阅主题,也可以在提示词指定。NTFY_BASE_URL: Ntfy API地址,默认:https://ntfy.sh。PUSH_PLUS_TOKEN: 默认PushPlus令牌,也可以在提示词指定。PUSH_PLUS_BASE_URL: PushPlus API地址,默认:http://www.pushplus.plus。
🛠️ 可用工具
企业微信群机器人
wework_send_text- 发送文本或Markdown消息wework_send_image- 发送图片消息wework_send_news- 发送图文链接消息
企业微信应用号
wework_app_send_text- 发送文本或Markdown消息wework_app_send_image- 发送图片消息wework_app_send_video- 发送视频消息wework_app_send_voice- 发送语音消息wework_app_send_file- 发送文件消息wework_app_send_news- 发送图文链接消息
Telegram Bot
tg_send_message- 发送文本或Markdown消息tg_send_photo- 发送图片消息tg_send_video- 发送视频消息tg_send_audio- 发送音频消息tg_send_file- 发送文件消息
其他工具
ding_send_text- 通过钉钉群机器人发送文本或Markdown消息lark_send_text- 通过飞书/Lark群机器人发送文本或Markdown消息bark_send_notify- 通过Bark发送通知ntfy_send_notify- 通过Ntfy发送通知pushplus_send_msg- 通过PushPlus发送消息ha_send_mobile- 通过Home Assistant发送通知text_to_sound- 将一段文本转成mp3音频链接
🔗 相关连接
- 大饼报告 - 基于此MCP实现的Telegram频道
- https://github.com/hasscc/ai-conversation/discussions/3
- https://linux.do/t/topic/1098688
Scan to contact