io.github.aahl/mcp-notify

Official

by aahl · Python

Notify MCP Server

MCP Server for notify to Weixin, Telegram, Bark, Lark, Feishu, DingTalk

Sends notifications via Weixin, Telegram, Bark, Lark, Feishu, and DingTalk.

Topics

barkllmmcp-servernotifytelegramweixin

README.md6 KBView on GitHub

💬 Notify MCP Server

简体中文 | English

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

安装

方式1: uvx

yaml

{
  "mcpServers": {
    "mcp-notify": {
      "command": "uvx",
      "args": ["mcp-notify"],
      "env": {
        "WEWORK_BOT_KEY": "your-wework-bot-key"
      }
    }
  }
}

方式2: Smithery

需要通过OAuth授权或Smithery key

yaml

{
  "mcpServers": {
    "mcp-aktools": {
      "url": "https://server.smithery.ai/@aahl/mcp-notify/mcp" # 流式传输HTTP
    }
  }
}

方式3: Docker

bash

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

yaml

{
  "mcpServers": {
    "mcp-notify": {
      "url": "http://0.0.0.0:8809/mcp" # 流式传输HTTP
    }
  }
}

快速开始

在线体验:
在线体验:
添加到 Cursor
添加到 VS Code
添加到 Cherry Studio
添加到 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_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

🛠️ 可用工具

<details> <summary>企业微信群机器人</summary>

wework_send_text - 发送文本或Markdown消息
wework_send_image - 发送图片消息
wework_send_news - 发送图文链接消息

</details> <details> <summary>企业微信应用号</summary>

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 - 发送图文链接消息

</details> <details> <summary>Telegram Bot</summary>

tg_send_message - 发送文本或Markdown消息
tg_send_photo - 发送图片消息
tg_send_video - 发送视频消息
tg_send_audio - 发送音频消息
tg_send_file - 发送文件消息

</details> <details> <summary>其他工具</summary>

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音频链接

</details>

🔗 相关连接

大饼报告 - 基于此MCP实现的Telegram频道
https://github.com/hasscc/ai-conversation/discussions/3
https://linux.do/t/topic/1098688

Install

Configuration

Environment variables

WEWORK_BOT_KEYsecret

The default key for the WeWork group robot can also be specified in the prompt

WEWORK_APP_CORPID

Company ID of WeWork

WEWORK_APP_SECRETsecret

Secret key of WeWork

WEWORK_APP_AGENTID

Agent ID of WeWork Application, Default: 1000002

WEWORK_APP_TOUSER

Default recipient user ID in WeWork, Default: @all

DINGTALK_BOT_KEYsecret

Access token of DingTalk Robot, Can also be specified in the prompt

LARK_BOT_KEYsecret

The key of Lark Robot, Can also be specified in the prompt

FEISHU_BOT_KEYsecret

The key of Feishu Robot, Can also be specified in the prompt

TELEGRAM_DEFAULT_CHAT

Telegram Default Chat ID, Can also be specified in the prompt

TELEGRAM_BOT_TOKENsecret

Telegram Bot Token

PUSH_PLUS_TOKENsecret

Default PushPlus token, Can also be specified in the prompt

TRANSPORTdefault stdio

Transport protocol to use

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-notify": {
      "command": "uvx",
      "args": [
        "mcp-notify"
      ],
      "env": {
        "WEWORK_BOT_KEY": "<YOUR_WEWORK_BOT_KEY>",
        "WEWORK_APP_CORPID": "<YOUR_WEWORK_APP_CORPID>",
        "WEWORK_APP_SECRET": "<YOUR_WEWORK_APP_SECRET>",
        "WEWORK_APP_AGENTID": "<YOUR_WEWORK_APP_AGENTID>",
        "WEWORK_APP_TOUSER": "<YOUR_WEWORK_APP_TOUSER>",
        "DINGTALK_BOT_KEY": "<YOUR_DINGTALK_BOT_KEY>",
        "LARK_BOT_KEY": "<YOUR_LARK_BOT_KEY>",
        "FEISHU_BOT_KEY": "<YOUR_FEISHU_BOT_KEY>",
        "TELEGRAM_DEFAULT_CHAT": "<YOUR_TELEGRAM_DEFAULT_CHAT>",
        "TELEGRAM_BOT_TOKEN": "<YOUR_TELEGRAM_BOT_TOKEN>",
        "PUSH_PLUS_TOKEN": "<YOUR_PUSH_PLUS_TOKEN>"
      }
    }
  }
}