mcpField
W
Webhooky

Webhooky

ローカル
webhooky.appコミュニケーション03 日前に更新
リポジトリ公式サイト

Webhooky について

Webhookyは、Webhookyのエンドポイント経由でAIアシスタントからスマートフォンへプッシュ通知を送るMCPサーバーです。長時間かかるタスク向けに通知設定を提供し、エンドポイントURLをツール引数ではなく環境変数に保持します。

主な機能

  1. 01タイトルとメッセージ付き通知を送信
  2. 02サウンドとバイブレーションを選択
  3. 03意味別に分類されたサウンド一覧
  4. 04受理後に未配信となった通知を報告
  5. 05環境設定にエンドポイントURLを保持

活用シーン

  1. 01時間のかかる移行の完了通知を受け取る
  2. 02アシスタントのタスク完了時にスマートフォンで知らせを受ける

MCP 対応

MCPサーバーは`send_notification`と`list_sounds`ツールを提供します。`WEBHOOKY_URL`で指定したエンドポイントを通じて通知を送信します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "matthiasmaigner-webhooky": {
      "command": "npx",
      "args": [
        "-y",
        "webhooky-mcp"
      ],
      "env": {
        "WEBHOOKY_URL": "<WEBHOOKY_URL>"
      }
    }
  }
}
起動コマンドnpx -y webhooky-mcp
設定が必要な環境変数
WEBHOOKY_URLシークレットYour Webhooky endpoint URL, copied from the app.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmwebhooky-mcp1.0.3

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

webhooky-mcp

Webhooky 向けの MCP サーバーです。

AI アシスタントに、スマートフォンへプッシュ通知を送信する機能をひとつ提供します。 時間のかかる作業を頼んでから離席する場合などに便利です。通知を送るコードを書かせなくても、アシスタント自身から知らせてもらえます。

You:  Run the migration and let me know when it's done.
Claude: [runs it, then calls send_notification]
📱      ✅ Migration done · 14,203 rows · 6m12s

セットアップ

Webhooky アプリ（iOS · Android）をインストールし、エンドポイントを作成して URL をコピーします。アカウントは不要です。アプリを開いた時点で URL が作成されます。無料プランでは、最大 3 つのエンドポイントで月 100 件の通知を利用できます。

Claude Code
claude mcp add webhooky -e WEBHOOKY_URL=https://api.webhooky.app/YOUR_KEY -- npx -y webhooky-mcp
Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "webhooky": {
      "command": "npx",
      "args": ["-y", "webhooky-mcp"],
      "env": { "WEBHOOKY_URL": "https://api.webhooky.app/YOUR_KEY" }
    }
  }
}
Cursor、Zed、その他の MCP クライアント

同様の形式です。コマンドは npx、引数は ["-y", "webhooky-mcp"]、環境には WEBHOOKY_URL を設定します。

ツール

send_notification
引数型必須備考
title文字列はい最大 100 文字
message文字列いいえ最大 500 文字。エンドポイントに設定済みのテキストを使う場合は省略します
sound列挙型いいえ40 個のサウンド ID から選択します。エンドポイントのサウンドを使う場合は省略します
vibrate真偽値いいえエンドポイントの振動設定を上書きします

通知が届いたデバイスの数を含む確認結果を返します。通知が受け付けられても配信されなかった場合は、成功を示すメッセージではなくエラーを報告します。これは無料プランの月間上限に達したときに起こります。この場合も Webhooky は意図的に HTTP 200 を返します。Stripe などの送信元による再試行を防ぐためです。このサーバーは、その違いを判別して知らせます。

list_sounds

意味別（お金、成功、失敗、情報、注意喚起、遊び心のある音）に分類された 40 種類のサウンドを一覧表示します。アシスタントは ID から推測するのではなく、イベントに合ったサウンドを選べます。

設定

変数必須デフォルト備考
WEBHOOKY_URLはい（なし）キーを含む完全なエンドポイント URL
WEBHOOKY_TIMEOUT_MSいいえ10000リクエストのタイムアウト

WEBHOOKY_URL には https が必要です。ただし localhost / 127.0.0.1 では、マシンの外部に通信が出ないため、平文の http も使用できます。

URL に関する注意

エンドポイント URL でできることは、スマートフォンに通知を送信することだけです。履歴を読み取ったり、アカウントにアクセスしたり、データを漏らしたりすることはできません。URL を知っている人は誰でも通知を送信できますが、影響範囲はそれだけです。 そのため、このサーバーは URL を環境からのみ受け取り、ツールの引数としては受け取りません。モデルが別のエンドポイントに送信するよう誘導されることはなく、キーが会話に含まれることもありません。また、エラーメッセージを返す前に URL を削除します。

WEBHOOKY_URL は Slack の受信 Webhook URL と同様に扱ってください。公開リポジトリには含めないでください。ただし、パスワードではありません。漏えいした場合は、アプリでエンドポイントを削除して新しく作成してください。古い URL は即座に無効になります。

開発

npm install
npm test     # drives the server over real stdio against a stub endpoint

リンク

MIT · Aigner Software e.U.

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。