AM

aahl/mcp-notify

Deployment & DevOps
28 stars 0 forks Quality 58 Trend 33

💬 MCP Server for notify to Weixin, Telegram, Bark, Lark, 飞书, 钉钉

Overview

提供消息推送的 MCP (Model Context Protocol) 服务器,支持企业微信、钉钉、Telegram、Bark、Lark、飞书、Home Assistant - 添加到 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 - 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.

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
    }
  }
}

快速开始

  • 在线体验:
  • 在线体验:
  • 添加到 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

  • 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

🛠️ 可用工具


🔗 相关连接


View this README on GitHub

Install

uvx mcp-notify

Configuration

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