FastMCP server that pages on-call via 100+ notification channels (Apprise wrappe

paging-mcp

100 種類以上の通知チャネルを通じてオンコール担当者にページを送る FastMCP サーバーです。Apprise を基盤としており、WhatsApp、ntfy、Pushover、Telegram、Discord、Slack、Signal、Matrix、Gotify、mailto、Twilio SMS、AWS SNS など、多数のサービスに対応しています。

このツールの狙いは、プロバイダーに依存しないことです。MCP を 1 つ接続し、必要な数だけチャネルを設定すれば、ベンダーを切り替えるたびにインテグレーションコードを書き直すことなく、冗長なページ通知を受け取れます。

これが必要な理由

B2B パイプラインの合成モニター、長時間実行されるバッチジョブ、セキュリティアラートなど、人間を起こす必要があるものを構築する場合、次のことが必要です。

1. 1 つのプロバイダーが停止してもページ通知を逃さないよう、複数のチャネルに並行して通知すること。
2. オペレーターに合ったチャネルを使えること（中南米のオンコール担当者には WhatsApp、セルフホスト利用者には ntfy、個人用スマートフォンには Pushover、今でも適しているケースには Twilio SMS）。
3. 出力を読むエージェントが認証情報を会話の記録に漏らさないよう、ツールの応答で認証情報を伏せること。
4. チャネルごとに新しい MCP を用意することなく、エージェントがどこからでも呼び出せる MCP を 1 つ用意すること（Claude Code、Codex、Cursor など）。

Apprise は Python でチャネル 1～2 を解決します。このサーバーは、認証情報のマスキングとチャネルのフィルタリングを加え、MCP から呼び出せるようにします。

インストール

Claude Code を開き、次のコマンドを貼り付けます。

/plugin marketplace add adelaidasofia/paging-mcp
/plugin install paging-mcp@paging-mcp

git clone https://github.com/adelaidasofia/paging-mcp ~/.claude/paging-mcp
cd ~/.claude/paging-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

設定

APPRISE_URLS に 1 つ以上の Apprise URL を設定します。改行、セミコロン、またはカンマで区切ります。

export APPRISE_URLS="
ntfys://ntfy.sh/<your-secret-topic>
whapi+https://gate.whapi.cloud/messages/text?token=<TOKEN>&to=+57...
pover://<USER_KEY>@<APP_TOKEN>
mailto://user:[email protected]/[email protected]
"

プロバイダー別の Apprise URL の例：

全一覧：https://github.com/caronc/apprise/wiki

Claude Code に登録する

プロジェクト単位（<vault>/.mcp.json）：

{
  "mcpServers": {
    "paging": {
      "command": "/Users/<you>/.claude/paging-mcp/.venv/bin/python",
      "args": ["/Users/<you>/.claude/paging-mcp/server.py"],
      "env": {
        "APPRISE_URLS": "ntfys://ntfy.sh/<your-secret-topic>"
      }
    }
  }
}

ユーザー単位：

claude mcp add -s user paging \
  /Users/<you>/.claude/paging-mcp/.venv/bin/python \
  /Users/<you>/.claude/paging-mcp/server.py \
  --env APPRISE_URLS="ntfys://ntfy.sh/<your-secret-topic>"

Claude Code を再起動します。claude mcp list で確認してください。

ツール

severity は info、success、warning、failure のいずれかです。色やアイコンでタグ付けするチャンネルで使用されます。

テスト

.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest tests/ -v

URL の伏せ字化、複数チャンネルへの送信、一部の失敗、チャンネルのフィルタリング、URL に認証情報を含むエンドツーエンドのページングフローを対象とする、16 件の単体テストと統合テストがあります。

セキュリティに関する注意事項

• ツールの応答に認証情報が表示されることはありません。パスを秘密情報として使うスキーム（ntfy、pushbullet、pover）では、パスの最後のセグメントも伏せ字になります。
• notify_one は一時的な URL を受け付けます。エージェントに直接の認証情報を渡す場合、会話にそれらを表示しないようにする責任はユーザーにあります。サーバー起動時に APPRISE_URLS を設定して使用することをおすすめします。
• サーバーはチャンネルやメッセージを永続化しません。すべてプロセス内で処理されます。

テレメトリー

このプラグインは、あるマシンで Claude Code セッション内に初めて読み込まれたときに、匿名のインストール通知を 1 回だけ myceliumai.co に送信します。

送信される情報：

• プラグイン名（例：slack-mcp）
• プラグインのバージョン（例：0.1.0）

送信されない情報：

• ユーザー識別情報、氏名、メールアドレス、トークン、API キーは送信されません
• ファイルパス、メッセージ内容、作業に関する情報は送信されません
• 重複排除の処理後、IP アドレスは保存されません

目的： メンテナーが実際にインストールされているプラグインを把握し、利用されているプラグインに注力できるようにします。

オプトアウト： Claude Code の起動前に環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。通知済みのインストールでは ~/.mycelium/onboarded-<plugin> に識別用ファイルが残ります。状態をリセットする場合は削除してください。

ライセンス

MIT — LICENSE を参照してください。

Mycelium AI が開発しました。完全版またはチーム版は diazroa.com をご覧ください。