PushNotif Official MCP Server

🔔 PushNotif MCP 服务（pushnotif-mcp-server）

这是 PushNotif.biz.id 的官方开源 Model Context Protocol（MCP）服务实现，可让 AI 编码助手（Claude Desktop、Claude Code、Cursor、Windsurf、Cline 和 Glama）注册账户、生成 SDK 代码片段、广播 Web Push（VAPID）和移动推送（Android FCM / iOS APNs）、配置应用内弹出横幅、社交证明 Toast、事务性邮件 OTP，并管理 QRIS 额度。

---

📦 仓库架构（开源 MCP 服务实现）

此仓库包含基于 @modelcontextprotocol/sdk 构建的完整、可运行的 MCP 服务实现：

• src/index.js — 完整的 Stdio MCP 服务实现（@modelcontextprotocol/sdk），提供全部 19 个 PushNotif 工具（ListToolsRequestSchema 和 CallToolRequestSchema）。
• Dockerfile — 容器化构建，用于 Glama.ai 自动检查和本地 Docker 执行。
• package.json — Node.js ES Module 软件包（bin: pushnotif-mcp）。
• glama.json 和 smithery.yaml — 注册表元数据清单。

---

🚀 快速开始（本地 Stdio MCP 服务）

选项 1：通过 Node.js / npx 运行（Stdio）

克隆并安装依赖项：

git clone https://github.com/AarsyDesign/pushnotif-mcp.git
cd pushnotif-mcp
npm install

添加到你的 claude_desktop_config.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "pushnotif": {
      "command": "node",
      "args": ["/absolute/path/to/pushnotif-mcp/src/index.js"],
      "env": {
        "PUSHNOTIF_API_KEY": "pn_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

选项 2：通过 Docker 运行（Stdio）

docker build -t pushnotif-mcp .
docker run -i --rm -e PUSHNOTIF_API_KEY=pn_live_YOUR_API_KEY_HERE pushnotif-mcp

选项 3：直接使用 Streamable HTTP 端点

你也可以通过 Streamable HTTP 直接连接 https://pushnotif.biz.id/mcp，并使用 Authorization: Bearer pn_live_YOUR_API_KEY_HERE。

---

🛠️ 可用工具（19 个全生命周期工具）

账户注册（无需 API Key）

1. register_new_account — 两步注册流程：请求 6 位数邮件 OTP，或验证 OTP 以创建新的 PushNotif 账户（永久获得 +1,000 免费额度点数）、注册首个网站，并返回 api_key（pn_live_...）。
2. login_existing_account — 使用邮箱和密码验证现有账户，以获取其 api_key，并可选择更新工作区个人资料名称或密码。

工作区、Web Push、移动推送、应用内消息与交易邮件自动化

3. list_apps — 列出所有已注册的网站/应用、活跃订阅者数量、积分余额，以及可选的即贴即用 SDK 代码片段（html、nextjs、laravel、wordpress、flutter）。
4. create_app — 注册新网站或移动应用并生成 VAPID 密钥。
5. update_app_branding — 更新通知图标 URL、自动欢迎推送消息，或上传 Firebase FCM 服务账号 JSON / Apple APNs .p8 凭据。
6. delete_app — 永久删除已注册的应用及其订阅者、营销活动和日志。
7. send_push_notification — 广播即时 Web Push（VAPID）、Android（FCM）和 iOS（APNs）通知。
8. schedule_push_notification — 安排一次性或周期性（daily / weekly）推送营销活动。
9. configure_inapp_banner — 配置应用内弹出模态框、顶部固定栏或底部滑入卡片。
10. configure_social_toast — 配置独立的站内实时活动社会认同 Toast 弹窗。
11. configure_rss_autopush — 配置全天候自动监控 RSS / Sitemap / Atom Feed 并自动推送。
12. configure_payment_webhook — 为 Midtrans、Xendit、Mayar、Lynk.id、Duitku、Tripay、WooCommerce 和 GitHub 生成传入 Webhook URL，或触发实时测试事件。
13. configure_email_automation — 配置各应用的自动交易邮件开关（订单付款收据、欢迎邮件、群发邮件副本）和自定义回复地址。
14. send_transactional_email — 通过 PushNotif 的防钓鱼锁定模板发送一对一交易邮件（otp_code、payment_invoice、order_status、security_alert）。
15. list_subscribers — 查看活跃订阅者的设备分布和细分标签。
16. update_subscriber_tags — 为订阅者设备分配、替换或移除受众细分标签。
17. get_campaign_analytics — 查看营销活动的送达情况、点击率（CTR）和转化指标。
18. create_qris_invoice — 生成实时 QRIS 付款账单（起价 Rp 1,000 / 5,000 积分）。
19. check_billing_and_qris_status — 查看实时 QRIS 付款状态（PENDING / PAID）、积分账本历史记录和可下载的 PDF 账单。

---

📄 许可证

MIT License — 版权所有 (c) 2026 PushNotif.biz.id（AarsyDesign）