mcpField
N
Notify MCP Server

Notify MCP Server

Local
github.com/aahlCommunication29Updated 31w ago

About Notify MCP Server

Notify MCP Server is an MCP service for sending messages to WeCom, DingTalk, Telegram, Bark, Feishu, Lark, Home Assistant and other channels. It suits users who want AI assistants to send notifications directly.

Key features

  1. 01WeCom group bot and app support
  2. 02DingTalk, Feishu and Lark group bots
  3. 03Telegram text, image, video and file messages
  4. 04Bark, Ntfy and PushPlus notifications
  5. 05Home Assistant mobile notifications

Use cases

  1. 01Pushing task results from an AI assistant to a Feishu or WeCom group
  2. 02Receiving reminders through Telegram or Bark
  3. 03Sending alerts to a Home Assistant mobile device

MCP support

Runs as an MCP server and exposes messaging tools such as wework_send_text, tg_send_message and bark_send_notify to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"aahl-mcp-notify": {
"command": "uvx",
"args": [
"mcp-notify"
],
"env": {
"WEWORK_BOT_KEY": "<WEWORK_BOT_KEY>",
"WEWORK_APP_CORPID": "<WEWORK_APP_CORPID>",
"WEWORK_APP_SECRET": "<WEWORK_APP_SECRET>",
"WEWORK_APP_AGENTID": "<WEWORK_APP_AGENTID>",
"WEWORK_APP_TOUSER": "<WEWORK_APP_TOUSER>",
"DINGTALK_BOT_KEY": "<DINGTALK_BOT_KEY>",
"LARK_BOT_KEY": "<LARK_BOT_KEY>",
"FEISHU_BOT_KEY": "<FEISHU_BOT_KEY>",
"TELEGRAM_DEFAULT_CHAT": "<TELEGRAM_DEFAULT_CHAT>",
"TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>",
"PUSH_PLUS_TOKEN": "<PUSH_PLUS_TOKEN>",
"TRANSPORT": "<TRANSPORT>"
}
}
}
}
Run commanduvx mcp-notify
Environment variables to set
WEWORK_BOT_KEYSecretThe default key for the WeWork group robot can also be specified in the prompt
WEWORK_APP_CORPIDCompany ID of WeWork
WEWORK_APP_SECRETSecretSecret key of WeWork
WEWORK_APP_AGENTIDAgent ID of WeWork Application, Default: 1000002
WEWORK_APP_TOUSERDefault recipient user ID in WeWork, Default: @all
DINGTALK_BOT_KEYSecretAccess token of DingTalk Robot, Can also be specified in the prompt
LARK_BOT_KEYSecretThe key of Lark Robot, Can also be specified in the prompt
FEISHU_BOT_KEYSecretThe key of Feishu Robot, Can also be specified in the prompt
TELEGRAM_DEFAULT_CHATTelegram Default Chat ID, Can also be specified in the prompt
TELEGRAM_BOT_TOKENSecretTelegram Bot Token
PUSH_PLUS_TOKENSecretDefault PushPlus token, Can also be specified in the prompt
TRANSPORTTransport protocol to use

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-notify0.1.11
ocighcr.io/aahl/mcp-notify:latest

Tools

15

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
textstringYesMessage content. Length limit: (text: 2048 bytes, markdown_v2: 4096 bytes)
bot_keystringNoWeCom group bot key in UUID format; fetched from environment variables by default
msgtypestringNoContent type; only text/markdown_v2 are supported

Details

From the project README

💬 Notify MCP Server

简体中文 | English

提供消息推送的 MCP (Model Context Protocol) 服务器,支持企业微信、钉钉、Telegram、Bark、Lark、飞书、Home Assistant

安装

方式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
    }
  }
}
快速开始
  • 在线体验: fastmcp.cloud
  • 在线体验: smithery.ai
  • 添加到 Cursor Install MCP Server
  • 添加到 VS Code Install MCP Server
  • 添加到 Cherry Studio Install MCP Server
  • 添加到 Claude Code, 执行命令: claude mcp add notify -- uvx mcp-notify
  • 添加到 OpenAI CodeX, 执行命令: codex mcp add notify -- uvx mcp-notify
⚙️ 环境变量
企业微信群机器人
  • 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音频链接

🔗 相关连接


README image

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.