mcpField
W
webhook

webhook

ローカル
github.com/rog0x開発ツール032 週間前に更新
リポジトリ

webhook について

AI エージェント向けに Webhook の管理とテスト機能を提供する MCP サーバーです。送信、署名検証、テスト用ペイロード生成、リクエスト診断、再試行計画に対応します。

主な機能

  1. 01カスタムヘッダーと本文での Webhook 送信
  2. 02Stripe、GitHub、Slack の署名検証
  3. 03対応サービスのイベント用テストペイロード生成
  4. 04リクエスト、署名、タイムスタンプ、本文の検査
  5. 05バックオフとジッターを使った再試行計画の算出

活用シーン

  1. 01URL への Webhook 送信と結果の確認
  2. 02Stripe、GitHub、Slack からの署名検証
  3. 03受信側のデバッグ用イベント生成
  4. 04リクエストの問題診断と失敗時の再試行計画

MCP 対応

MCP クライアントに、Webhook 送信、署名検証、ペイロード生成、リクエスト診断、再試行計画のツールを提供する MCP サーバーです。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "rog0x-webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-webhook-tools"
      ]
    }
  }
}
起動コマンドnpx -y @rog0x/mcp-webhook-tools

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

パッケージ
npm@rog0x/mcp-webhook-tools1.0.2

ツール

5

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
urlstringはいwebhook の送信先 URL
bodystringはいリクエスト本文（通常は JSON 文字列）
methodenumいいえHTTP メソッド（デフォルト：POST）GET | POST | PUT | PATCH | DELETE
headersobjectいいえキーと値のペアで指定するカスタム HTTP ヘッダー
timeout_msnumberいいえリクエストのタイムアウト（ミリ秒、デフォルト：10000）
max_retriesnumberいいえ失敗時の最大再試行回数（デフォルト：0）
content_typestringいいえContent-Type ヘッダー（デフォルト：application/json）
base_delay_msnumberいいえ再試行間の基本遅延（ミリ秒、デフォルト：1000）

詳細

mcp-webhook-tools

Model Context Protocol を基盤とする、AI エージェント向けの Webhook 管理・テストツールです。

ツール

webhook_send

カスタムヘッダー、本文、コンテンツタイプを指定して、任意の URL に Webhook ペイロードを送信します。指数バックオフとジッターによる自動再試行に対応しています。ステータスコード、所要時間、エラーを含む詳細な試行記録を返します。

webhook_validate

HMAC-SHA256 または HMAC-SHA1 を使用して Webhook 署名を検証します。次の組み込みパターンに対応しています。

  • Stripe — タイムスタンプ許容範囲に対応した t=TIMESTAMP,v1=SIGNATURE 形式
  • GitHub — sha256=SIGNATURE または sha1=SIGNATURE 形式
  • Slack — v0:timestamp:body の署名方式による v0=SIGNATURE

タイミング攻撃を防ぐため、タイミングセーフな比較を使用します。

webhook_generate_payload

テスト用の現実的な Webhook ペイロードを生成します。対応するイベントは次のとおりです。

サービスイベント
Stripepayment_intent.succeeded
GitHubpush、pull_request
Slackmessage

各ペイロードには、ランダム化された ID、現在のタイムスタンプ、推奨ヘッダーが含まれます。特定のフィールドをカスタマイズするには、overrides パラメーターを使用してください。

webhook_debug

Webhook リクエストをエンドツーエンドで分析します。

  • ヘッダーを解析して分類します（コンテンツタイプ、署名、タイムスタンプ、配信 ID、カスタム）
  • リクエスト本文を検証します（サイズ、JSON の妥当性、エンコーディング）
  • プロバイダーを自動検出します（Stripe、GitHub、Slack）
  • シークレットが指定されている場合は署名を検証します
  • タイムスタンプの鮮度を確認します（デフォルトのしきい値は 300s）
  • 検出したすべての問題を報告します
webhook_retry_schedule

指数バックオフを使用した再試行スケジュールを計算します。各試行の遅延、累積経過時間、予定された ISO タイムスタンプを表示します。基本遅延、最大遅延上限、乗数、ジッターを設定できます。

セットアップ

npm install
npm run build

MCP 設定

MCP クライアントの設定に追加してください。

{
  "mcpServers": {
    "webhook-tools": {
      "command": "node",
      "args": ["path/to/mcp-webhook-tools/dist/index.js"]
    }
  }
}

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

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

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