Skip to main content
Glama
elsba3ei

elsba3ei Webhook MCP Server

by elsba3ei

🤖 elsba3ei Webhook MCP Server

Python FastMCP Docker

SSRF、API、および帯域外(OOB)インタラクションをテストするための、高性能なローカル&パブリックWebhookインスペクタであり、Burp Suite Collaboratorの代替品です。Cloudflare Quick Tunnelサポート、動的モックレスポンス、ライブリクエストキャプチャ、AIコーディングエージェント向けのコールバックポーリングを備えています。


⚡ 概要と機能

elsba3ei-webhook-mcp サーバーを使用すると、Claude Desktop、Antigravity、およびAIエージェントは以下を実行できます。

  • アカウント不要で、ローカル(http://127.0.0.1:4040/capture)およびパブリックなCloudflare Quick Tunnel(https://*.trycloudflare.com/capture)を即座に起動できます。

  • 受信するHTTP/HTTPSリクエスト(メソッド、ヘッダー、クエリ、クライアントIP、JSON、フォームデータ、生テキスト、またはバイナリの16進ダンプ)を検査できます。

  • カスタムステータスコード、コンテンツタイプ、ヘッダー、およびシミュレートされた応答レイテンシを使用して、レスポンスを動的にモックできます。

  • 帯域外SSRF / Webhookコールバックを待機するポーリング&ブロックができます(wait_for_request)。

  • カスタムHTTPリクエストをリプレイおよび作成できます(replay_request)。


Related MCP server: pipepie

🛠️ 利用可能なMCPツールリファレンス

#

Tool Name

Parameters

Description

1

get_webhook_urls

_dummy=""

利用可能なすべてのlocalhost、LAN、およびパブリックCloudflareキャプチャURLを返します。

2

start_tunnel

port="4040"

ポート4040を公開するための一時的なCloudflare Quick Tunnelを起動します。

3

stop_tunnel

_dummy=""

Cloudflareトンネルのサブプロセスを終了します。

4

get_tunnel_status

_dummy=""

アクティブなトンネルURL、ステータス、および稼働時間を返します。

5

list_requests

limit="20", method="", path_filter=""

キャプチャされたリクエストをメタデータ付きで要約します。

6

get_request_details

request_id="<uuid>"

リクエストIDの完全なヘッダー、解析済み/生のボディ、およびクライアントIPを取得します。

7

wait_for_request

timeout_seconds="30", path_contains="", method="", body_contains=""

タイムアウト内で、受信リクエストがパス、メソッド、またはボディに一致するまでポーリングします。

8

configure_mock_response

status_code="200", content_type="application/json", response_body="{...}", delay_ms="0", custom_headers_json="{}"

動的なHTTPステータス、コンテンツタイプ、ボディ、遅延、およびカスタムヘッダーを設定します。

9

reset_mock_response

_dummy=""

モックエンジンをデフォルトの200 OK JSONにリセットします。

10

clear_requests

_dummy=""

キャプチャされたリクエストのインメモリリングバッファを消去します。

11

delete_request

request_id="<uuid>"

IDで単一のリクエストレコードを削除します。

12

replay_request

target_url, method="GET", headers_json="{}", body="", timeout_seconds="10"

任意のターゲットURLにHTTPリクエストを送信し、レスポンスをキャプチャします。

13

get_server_status

_dummy=""

サーバーのヘルス、アクティブなポート、稼働時間、およびキャプチャされたリクエスト数を返します。


🚀 クイックスタートセットアップ(Windows PowerShell)

  1. PowerShellを開き、このディレクトリに移動します:

    cd G:\Playing\elsba3ei-webhook-mcp
  2. 自動セットアップスクリプトを実行します:

    .\setup.ps1
  3. Claude Desktopを完全に再起動します(システムトレイから終了して、再度開きます)。

  4. Claudeで新しい会話を開始して、新しいツールを読み込みます。


🐳 Docker & MCP インストール

ステップ1:Dockerイメージをビルドする

docker build -t elsba3ei-webhook:latest .

ステップ2:Docker MCPプロファイルに追加する(Docker Desktop 4.40以降)

docker mcp profile server add default --server file:///G:/Playing/elsba3ei-webhook-mcp/elsba3ei-webhook-catalog.yaml

ステップ3:Claude Desktopに接続する

docker mcp client connect claude-desktop --global --profile default

ステップ4:登録されたプロファイルとツールを確認する

docker mcp profile server ls
docker mcp tools ls | Select-String "elsba3ei"

⚙️ Claude Desktopを手動で設定する

設定ファイルの場所:%APPDATA%\Claude\claude_desktop_config.json

直接Python実行モード(推奨)

{
  "mcpServers": {
    "elsba3ei-webhook": {
      "command": "G:\\Playing\\elsba3ei-webhook-mcp\\.venv\\Scripts\\python.exe",
      "args": ["G:\\Playing\\elsba3ei-webhook-mcp\\elsba3ei_webhook_server.py"]
    }
  }
}

Dockerコンテナモード

{
  "mcpServers": {
    "elsba3ei-webhook": {
      "command": "docker",
      "args": [
        "--context",
        "desktop-linux",
        "run",
        "-i",
        "--rm",
        "-p",
        "4040:4040",
        "elsba3ei-webhook:latest"
      ]
    }
  }
}

🔧 トラブルシューティングマトリックス

Symptom

Root Cause

Fix

docker mcp catalog import not recognized

Docker Desktop 4.40以降で削除されたコマンド

代わりに docker mcp profile server add default --server file://... を使用します

docker mcp server enable not recognized

Docker Desktop 4.40以降で削除されたコマンド

docker mcp profile server add に置き換えられました

docker mcp client connect fails: missing flag

--profile が必須になりました

docker mcp client connect claude-desktop --global --profile default を使用します

Claudeにツールが表示されない

プロセスが誤ったDockerコンテキストを使用している

docker runの引数に --context desktop-linux を追加します

「gateway panic」/ ツールが消える

複数行のツールdocstring

すべての @mcp.tool() docstringを正確に1行に保ちます

ポート4000/4040の競合

ポートがすでに使用されている

環境で WEBHOOK_PORT=4041 を設定します

ツールに「まだ読み込まれていません」と表示される

前回のセッションのキャッシュ

Claude Desktopを再起動し、新しい会話を開始します


👨💻 作者と開発者

❤️を込めて Ahmed E. El-Sbaei によって開発されました


📄 ライセンス

MITライセンス の下で配布されています — © 2026 elsba3ei。

Related MCP Connectors

Related MCP Servers