Skip to content

aahl/mcp-notify

Repository files navigation

💬 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

Bark

  • BARK_DEVICE_KEY: 默认Bark设备key,也可以在提示词指定
  • BARK_BASE_URL: Bark API地址,默认: https://api.day.app

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),也可在提示词指定

🛠️ 可用工具

企业微信群机器人
  • 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 - 发送文件消息
  • tg_markdown_rule - Telegram markdown 规则
其他工具
  • ding_send_text - 通过钉钉群机器人发送文本或Markdown消息
  • lark_send_text - 通过飞书/Lark群机器人发送文本或Markdown消息
  • bark_send_notify - 通过Bark发送通知
  • ntfy_send_notify - 通过Ntfy发送通知
  • ha_send_mobile - 通过Home Assistant发送通知
  • text_to_sound - 将一段文本转成mp3音频链接

🔗 相关连接


About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors 2

  •  
  •