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）の一斉送信、アプリ内ポップアップバナーとソーシャルプルーフトーストの設定、トランザクションメール OTP の送信、QRIS クレジットの管理ができます。

---

📦 リポジトリのアーキテクチャ（オープンソースの MCP サーバー実装）

このリポジトリには、@modelcontextprotocol/sdk を基盤に構築された、実行可能な MCP サーバーの完全な実装が含まれています。

• src/index.js — 19 個の PushNotif ツール（ListToolsRequestSchema と CallToolRequestSchema）を公開する Stdio MCP サーバーの完全な実装（@modelcontextprotocol/sdk）。
• 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 エンドポイントに直接接続

Authorization: Bearer pn_live_YOUR_API_KEY_HERE を指定して、https://pushnotif.biz.id/mcp の Streamable HTTP に直接接続することもできます。

---

🛠️ 利用可能なツール（ライフサイクル全体に対応する 19 個のツール）

アカウントの初期設定（API キー不要）

1. register_new_account — 2 段階の初期設定を行います。6 桁のメール OTP をリクエストするか、OTP を検証して新しい PushNotif アカウントを作成します（永久に無料のクレジット 1,000 件付き）。最初のウェブサイトを登録し、api_key（pn_live_...）を返します。
2. login_existing_account — メールアドレスとパスワードで既存のアカウントを認証し、api_key を取得します。必要に応じてワークスペースのプロフィール名またはパスワードを更新できます。

ワークスペース、Web Push、モバイルプッシュ、アプリ内通知、トランザクションメールの自動化

3. list_apps — 登録済みのすべてのWebサイト／アプリ、有効なサブスクライバー数、クレジット残高、および貼り付けてすぐに使えるオプションのSDKスニペット（html、nextjs、laravel、wordpress、flutter）を一覧表示します。
4. create_app — 新しいWebサイトまたはモバイルアプリを登録し、VAPIDキーを生成します。
5. update_app_branding — 通知アイコンのURL、自動ウェルカムプッシュメッセージを更新するか、Firebase FCM Service Account JSON／Apple APNs .p8 認証情報をアップロードします。
6. delete_app — 登録済みアプリケーションと、そのサブスクライバー、キャンペーン、ログを完全に削除します。
7. send_push_notification — Web Push（VAPID）、Android（FCM）、iOS（APNs）の通知を即時配信します。
8. schedule_push_notification — 1回限り、または定期（daily／weekly）のプッシュキャンペーンを予約します。
9. configure_inapp_banner — アプリ内ポップアップモーダル、画面上部の固定バー、または画面下部のスライドカードを設定します。
10. configure_social_toast — サイト上に単独で表示するライブアクティビティのソーシャルプルーフ通知ポップアップを設定します。
11. configure_rss_autopush — RSS／サイトマップ／Atomフィードを24時間365日自動監視し、自動プッシュするよう設定します。
12. configure_payment_webhook — Midtrans、Xendit、Mayar、Lynk.id、Duitku、Tripay、WooCommerce、GitHub用の受信Webhook URLを生成するか、ライブテストイベントをトリガーします。
13. configure_email_automation — 自動トランザクションメール（注文支払い済み領収書、ウェルカムメール、ブロードキャストミラー）とカスタム返信先を、アプリごとに設定します。
14. send_transactional_email — PushNotifのフィッシング対策ロック済みテンプレートを使用して、1対1のトランザクションメール（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 — Copyright (c) 2026 PushNotif.biz.id (AarsyDesign)