Edgeone Webhook Pusher

openshiye28stars

基于 EdgeOne 的自托管免费微信推送与标准 MCP Server，支持 Agent / IDE、Webhook 风格 API、多应用和订阅群发。Self-hosted free WeChat push service and standard MCP server on EdgeOne, with Agent/IDE support, webhook-style API, multi-app

Developer Tools

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Edgeone Webhook Pusher

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: GPL-3.0
Last checked: 2026-10-27

Stars: 28
Tools: —
Uptime: —

Overview

About Edgeone Webhook Pusher

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Edgeone Webhook Pusher?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Edgeone Webhook Pusher need an API key?

No required environment variable is listed on this record.

What transport does Edgeone Webhook Pusher use?

Edgeone Webhook Pusher runs locally over stdio.

When was Edgeone Webhook Pusher last checked?

Last checked 2026-10-27. 基于 EdgeOne 的自托管免费微信推送与标准 MCP Server，支持 Agent / IDE、Webhook 风格 API、多应用和订阅群发。Self-hosted free WeChat push service and standard MCP server on EdgeOne, with Agent/IDE support, webhook-style API, multi-app support, and subscription broadcast.

From the publisher

Documentation

在线体验：https://webhook-pusher.ixnie.cn/
体验站仅供试用，生产环境建议自部署。

为什么选它？

对比项	EdgeOne MCP Pusher	Server 酱	认证公众号
成本	完全免费	¥49/年起	需认证费
数据归属	自建自托管	第三方托管	腾讯托管
部署方式	EdgeOne 一键部署	平台现成	配置较重
对 Agent / IDE 友好度	标准 MCP Server	不支持	不标准
自定义能力	完全可控	有限	有限

核心卖点：EdgeOne 免费额度 + 微信测试号 + 标准 MCP 接口 = 0 成本长期使用 + 数据自己掌控 + 可被 Agent / IDE 直接识别和调用

Powered by Tencent EdgeOne

产品截图

核心功能

自托管免费微信推送：适合个人、NAS、Home Assistant、服务器告警
标准 MCP Server：可直接接入 Claude Code、Cursor、Codex、OpenCode 等 Agent / IDE
Webhook 风格 API：一行 curl 就能发消息
多应用管理：同一后台统一管理多个 appKey
订阅群发：适合公众号订阅、群组通知、多人接收
多渠道能力：微信公众号、企业微信、钉钉、飞书
可视化后台：创建应用、复制 appKey、测试发送、查看消息历史
EdgeOne 一键部署：无需单独买服务器

适用场景

HomeLab / 智能家居：NAS 下载通知、Home Assistant 告警、路由器监控
开发运维：CI/CD 通知、服务器监控、Docker 异常、错误提醒
自动化工作流：RSS 订阅、价格监控、爬虫结果、签到脚本
Agent / IDE 工作流：已知 appKey 时直接发消息；需要让 AI 自己查 appKey 或读后台工具时再加 Bearer Token

快速开始

1. 一键部署到 EdgeOne

点击上方 Deploy to EdgeOne
创建并绑定 1 个 KV 命名空间：PUSHER_KV
设置构建参数：
- Root: /
- Output: dist
- Build: yarn build
配置环境变量：

变量名	必填	说明
`KV_BASE_URL`	是	站点完整域名，例如 `https://your-domain.com`
`BUILD_KEY`	是	Node Functions 与 Edge Functions 共用的内部鉴权口令

BUILD_KEY 只要求两端一致，建议设置为难猜的复杂字符串。

2. 初始化后台

打开 https://your-domain.com/admin/login
完成初始化，或使用已有管理员令牌登录
进入后台 应用 页创建第一个 app
在应用详情中复制 AppKey 和 Send URL

管理员令牌主要用于后台和 MCP 管理只读工具，不影响普通 /send/{appKey} 调用。

3. 发送第一条消息

curl "https://your-domain.com/send/{appKey}?title=部署成功&desp=你的 EdgeOne MCP Pusher 已上线"

如果你更喜欢 JSON：

curl -X POST "https://your-domain.com/send/{appKey}" \
  -H "Content-Type: application/json" \
  -d '{"title":"部署成功","desp":"你的 EdgeOne MCP Pusher 已上线"}'

Webhook 使用教程

Send Endpoint

发送地址：https://your-domain.com/send/{appKey}
appKey 来自后台应用详情
同一个站点可以管理多个 app，每个 app 都有自己的 appKey

常用参数

参数	说明
`title`	必填，消息标题
`desp`	简单正文，最常用
`content`	扩展正文，复杂消息时使用
`format`	`text / markdown / html`
`type`	`text / page`，`page` 会生成托管详情页
`url`	可选跳转链接
`summary`	可选摘要
`template`	可选模板预设 key

最小示例

curl "https://your-domain.com/send/{appKey}?title=CPU告警&desp=CPU使用率超过90%"

POST JSON 示例

curl -X POST "https://your-domain.com/send/{appKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "构建完成",
    "content": "# Build Success\n\n项目已经完成部署。",
    "format": "markdown"
  }'

网页详情页示例

curl -X POST "https://your-domain.com/send/{appKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "生产告警",
    "desp": "CPU 使用率超过 90%，请打开详情页查看上下文。",
    "type": "page"
  }'

GET 适合轻量调用；复杂内容、长正文、Markdown / HTML 推荐用 POST JSON。

MCP 使用教程

MCP Endpoint

BASE_URL：当前项目地址，例如 https://your-domain.com
MCP 入口：<BASE_URL>/mcp
传输方式：Streamable HTTP
适配方向：Claude Code、Cursor、Codex、OpenCode 以及其他支持远程 MCP 的 Agent / IDE
/mcp 是独立 MCP 入口，应直接走 Node Functions，不经过 Nuxt 页面路由

权限模型

Workflow:
1. Set BASE_URL to your current project address, then use <BASE_URL>/mcp.
2. If you already know appKey, call send_message directly. No bearer token is required.
3. If you need apps_list, apps_get, message history, stats, or setup tools, reconnect with Authorization: Bearer <AT_...>.
4. Copy appKey from the admin Apps page or from the existing /send/{appKey} URL.
If sendType is "page", body is required.

匿名连接时，tools/list 只会看到：

send_message

带管理员令牌后，才会额外看到：

apps_list
apps_get
messages_list
messages_get
stats_get
setup_overview_get

管理员请求头：

Authorization: Bearer <AT_...>

客户端配置示例

Claude Code

匿名发送：

export BASE_URL="https://your-domain.com"
claude mcp add --transport http edgeone-mcp-pusher "$BASE_URL/mcp"

管理员模式：

export BASE_URL="https://your-domain.com"
export EDGEONE_MCP_ADMIN_TOKEN="AT_xxx"
claude mcp add --transport http edgeone-mcp-pusher-admin "$BASE_URL/mcp" \
  --header "Authorization: Bearer $EDGEONE_MCP_ADMIN_TOKEN"

Codex

匿名发送：

export BASE_URL="https://your-domain.com"
codex mcp add edgeone-mcp-pusher --url "$BASE_URL/mcp"

管理员模式：

export BASE_URL="https://your-domain.com"
export EDGEONE_MCP_ADMIN_TOKEN="AT_xxx"
codex mcp add edgeone-mcp-pusher-admin \
  --url "$BASE_URL/mcp" \
  --bearer-token-env-var EDGEONE_MCP_ADMIN_TOKEN

Cursor

匿名发送：

{
  "mcpServers": {
    "edgeone-mcp-pusher": {
      "url": "https://your-domain.com/mcp"
    }
  }
}

管理员模式：

{
  "mcpServers": {
    "edgeone-mcp-pusher-admin": {
      "url": "https://your-domain.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EDGEONE_MCP_ADMIN_TOKEN}"
      }
    }
  }
}

OpenCode

匿名发送：

{
  "mcp": {
    "edgeone-mcp-pusher": {
      "type": "remote",
      "url": "https://your-domain.com/mcp",
      "enabled": true
    }
  }
}

管理员模式：

{
  "mcp": {
    "edgeone-mcp-pusher-admin": {
      "type": "remote",
      "url": "https://your-domain.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:EDGEONE_MCP_ADMIN_TOKEN}"
      }
    }
  }
}

Tools 与权限

Tool	是否需要 Bearer	说明
`send_message`	否	已知 `appKey` 时可直接发送
`apps_list`	是	列出 app 与 `appKey`
`apps_get`	是	读取单个 app 的发送能力
`messages_list`	是	读取消息列表
`messages_get`	是	读取单条消息详情
`stats_get`	是	读取系统统计
`setup_overview_get`	是	读取初始化与索引概览

send_message 最小 payload

{
  "appKey": "APKxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "title": "Server Alert",
  "body": "CPU usage exceeded 80%",
  "sendType": "text"
}

字段说明：

appKey：从后台「应用」页复制，或取现有 /send/{appKey} 的最后一段
title：必填
body：正文；sendType=page 时必填
sendType：text 或 page
format：可选 text / markdown / html
linkUrl：可选跳转链接
summary：可选摘要
templateKey：可选模板 key

接入提示

大多数远程 MCP 客户端会自动处理 initialize、notifications/initialized 与 tools/list
你只需要保证 MCP 地址指向 <BASE_URL>/mcp
如果只需要发送消息，可以不配 Bearer Token
如果要让 Agent 自己发现 appKey 或读取后台信息，再补 Authorization: Bearer <AT_...>

可选安全白名单

如果你希望限制 /mcp 的访问来源，可配置以下环境变量：

变量名	说明
`MCP_ALLOWED_HOSTS`	允许访问 `/mcp` 的 Host 白名单，逗号分隔，支持 `*.example.com`
`MCP_ALLOWED_ORIGINS`	允许跨域访问 `/mcp` 的 Origin 白名单，逗号分隔，支持 `https://*.example.com`

未配置时默认不限制生产 Host / Origin；本地开发仍只接受 loopback host。

集成示例

群晖 NAS 下载通知

curl "https://your-domain.com/send/{appKey}?title=下载完成&desp=${TR_TORRENT_NAME}"

GitHub Actions 部署通知

- name: 部署通知
  run: curl "https://your-domain.com/send/${{ secrets.WEBHOOK_KEY }}?title=部署成功&desp=项目已上线"

Home Assistant 告警

notify:
  - name: edgeone_mcp_pusher
    platform: rest
    resource: https://your-domain.com/send/{appKey}
    method: POST
    data:
      title: "{{ title }}"
      desp: "{{ message }}"

服务器监控

CPU_USAGE=$(top -bn1 | grep "Cpu(s)" | awk '{print $2}')
[ ${CPU_USAGE%.*} -gt 80 ] && curl "https://your-domain.com/send/{appKey}?title=CPU告警&desp=使用率${CPU_USAGE}%"

常见问题

Q: 它和 Server 酱最大的区别是什么？
A: 这是自托管方案，数据和 appKey 都在你自己的 EdgeOne 账号里，而且额外提供标准 MCP Server 给 Agent / IDE 使用。

Q: Webhook 和 MCP 有什么区别？
A: Webhook 适合脚本和服务直接调用；MCP 适合让 Claude Code、Cursor、Codex 这类客户端通过标准协议调用 send_message，并在带管理员 Bearer Token 时继续使用 app/消息/统计工具。

Q: appKey 从哪里拿？
A: 去后台「应用」页复制 AppKey，或者直接从现有 https://your-domain.com/send/{appKey} 里取最后一段。

Q: 管理员令牌 AT_... 是做什么的？
A: 主要用于后台登录，以及 MCP 的后台只读工具；普通 /send/{appKey} 调用不依赖它。

Q: EdgeOne 免费额度够用吗？
A: 对个人通知、家庭告警、轻量自动化场景通常足够；如果流量和消息量持续增长，再考虑独立资源即可。

开源协议

GPL-3.0 License

对比项

EdgeOne MCP Pusher

Server 酱

认证公众号

成本

完全免费

¥49/年起

需认证费

数据归属

自建自托管

第三方托管

腾讯托管

部署方式

EdgeOne 一键部署

平台现成

配置较重

对 Agent / IDE 友好度

标准 MCP Server

不支持

不标准

自定义能力

完全可控

有限

变量名

必填

说明

KV_BASE_URL

是

站点完整域名，例如 https://your-domain.com

BUILD_KEY

是

Node Functions 与 Edge Functions 共用的内部鉴权口令

参数

说明

title

必填，消息标题

desp

简单正文，最常用

content

扩展正文，复杂消息时使用

format

text / markdown / html

type

text / page，page 会生成托管详情页

url

可选跳转链接

summary

可选摘要

template

可选模板预设 key

curl -X POST "https://your-domain.com/send/{appKey}" \ -H "Content-Type: application/json" \ -d '{ "title": "构建完成", "content": "# Build Success\n\n项目已经完成部署。", "format": "markdown" }'

curl -X POST "https://your-domain.com/send/{appKey}" \ -H "Content-Type: application/json" \ -d '{ "title": "生产告警", "desp": "CPU 使用率超过 90%，请打开详情页查看上下文。", "type": "page" }'

Workflow: 1. Set BASE_URL to your current project address, then use <BASE_URL>/mcp. 2. If you already know appKey, call send_message directly. No bearer token is required. 3. If you need apps_list, apps_get, message history, stats, or setup tools, reconnect with Authorization: Bearer <AT_...>. 4. Copy appKey from the admin Apps page or from the existing /send/{appKey} URL. If sendType is "page", body is required.

export BASE_URL="https://your-domain.com" export EDGEONE_MCP_ADMIN_TOKEN="AT_xxx" claude mcp add --transport http edgeone-mcp-pusher-admin "$BASE_URL/mcp" \ --header "Authorization: Bearer $EDGEONE_MCP_ADMIN_TOKEN"

{ "mcpServers": { "edgeone-mcp-pusher-admin": { "url": "https://your-domain.com/mcp", "headers": { "Authorization": "Bearer ${env:EDGEONE_MCP_ADMIN_TOKEN}" } } } }

{ "mcp": { "edgeone-mcp-pusher-admin": { "type": "remote", "url": "https://your-domain.com/mcp", "enabled": true, "headers": { "Authorization": "Bearer {env:EDGEONE_MCP_ADMIN_TOKEN}" } } } }

Tool

是否需要 Bearer

说明

send_message

否

已知 appKey 时可直接发送

apps_list

是

列出 app 与 appKey

apps_get

是

读取单个 app 的发送能力

messages_list

是

读取消息列表

messages_get

是

读取单条消息详情

stats_get

是

读取系统统计

setup_overview_get

是

读取初始化与索引概览

变量名

说明

MCP_ALLOWED_HOSTS

允许访问 /mcp 的 Host 白名单，逗号分隔，支持 *.example.com

MCP_ALLOWED_ORIGINS

允许跨域访问 /mcp 的 Origin 白名单，逗号分隔，支持 https://*.example.com