Skip to main content
Glama
deenesjakoruzh
elsba3ei

elsba3ei Webhook MCP Server

by elsba3ei
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

🤖 elsba3ei Webhook MCP Server

Python FastMCP Docker

Hochleistungsfähiger lokaler & öffentlicher Webhook-Inspektor – eine Alternative zum Burp Suite Collaborator zum Testen von SSRF, APIs und Out-of-Band-Interaktionen (OOB) mit Cloudflare-Quick-Tunnel-Unterstützung, dynamischen Mock-Antworten, Live-Request-Erfassung und Callback-Polling für KI-Codierungsagenten.

⚡ Übersicht & Funktionen

Mit dem elsba3ei-webhook-mcp-Server können Claude Desktop, Antigravity und KI-Agenten:

  • Sofort lokale (http://127.0.0.1:4040/capture) und öffentliche Cloudflare-Quick-Tunnel (https://*.trycloudflare.com/capture) ohne Konto einrichten.

  • Eingehende HTTP/HTTPS-Anfragen untersuchen (Methode, Header, Query, Client-IP, JSON, Formulardaten, Rohtext oder binärer Hex-Dump).

  • Antworten dynamisch mocken mit benutzerdefinierten Statuscodes, Content-Types, Headern und simulierter Antwortlatenz.

  • Auf Out-of-Band-SSRF-/Webhook-Callbacks warten (Polling und Blockieren) (wait_for_request).

  • Benutzerdefinierte HTTP-Anfragen erneut senden und erstellen (replay_request).

Related MCP server: pipepie

🛠️ Referenz der verfügbaren MCP-Tools

#

Tool-Name

Parameter

Beschreibung

1

get_webhook_urls

_dummy=""

Gibt alle verfügbaren Localhost-, LAN- und öffentlichen Cloudflare-Capture-URLs zurück.

2

start_tunnel

port="4040"

Startet einen temporären Cloudflare-Quick-Tunnel, um Port 4040 öffentlich verfügbar zu machen.

3

stop_tunnel

_dummy=""

Beendet den Cloudflare-Tunnel-Subprozess.

4

get_tunnel_status

_dummy=""

Gibt die aktive Tunnel-URL, den Status und die Betriebszeit zurück.

5

list_requests

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

Fasst erfasste Anfragen mit Metadaten zusammen.

6

get_request_details

request_id="<uuid>"

Ruft vollständige Header, analysierten/Roh-Body und Client-IP einer Anfrage-ID ab.

7

wait_for_request

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

Pollt, bis eine eingehende Anfrage innerhalb eines Timeouts mit Pfad, Methode oder Body übereinstimmt.

8

configure_mock_response

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

Legt dynamischen HTTP-Status, Content-Type, Body, Verzögerung und benutzerdefinierte Header fest.

9

reset_mock_response

_dummy=""

Setzt die Mock-Engine auf die Standardantwort 200 OK (JSON) zurück.

10

clear_requests

_dummy=""

Leert den In-Memory-Ringpuffer der erfassten Anfragen.

11

delete_request

request_id="<uuid>"

Entfernt einen einzelnen Anfragedatensatz anhand der ID.

12

replay_request

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

Sendet eine HTTP-Anfrage an eine beliebige Ziel-URL und erfasst die Antwort.

13

get_server_status

_dummy=""

Gibt Serverzustand, aktiven Port, Betriebszeit und Anzahl erfasster Anfragen zurück.

🚀 Schnellstart-Einrichtung (Windows PowerShell)

  1. Öffnen Sie PowerShell und navigieren Sie zu diesem Verzeichnis:

    cd G:\Playing\elsba3ei-webhook-mcp

  2. Führen Sie das automatisierte Setup-Skript aus:

    .\setup.ps1

  3. Starten Sie Claude Desktop vollständig neu (im System-Tray beenden und dann erneut öffnen).

  4. Beginnen Sie eine neue Konversation in Claude, um die neuen Tools zu laden.

🐳 Docker- & MCP-Installation

Schritt 1: Docker-Image erstellen

docker build -t elsba3ei-webhook:latest .

Schritt 2: Zum Docker-MCP-Profil hinzufügen (Docker Desktop 4.40+)

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

Schritt 3: Mit Claude Desktop verbinden

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

Schritt 4: Registriertes Profil & Tools überprüfen

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

⚙️ Claude Desktop manuell konfigurieren

Speicherort der Konfigurationsdatei: %APPDATA%\Claude\claude_desktop_config.json

Direkter Python-Ausführungsmodus (Empfohlen)

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

Docker-Container-Modus

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

🔧 Fehlerbehebungs-Matrix

Symptom

Ursache

Lösung

docker mcp catalog import not recognized

Befehl in Docker Desktop 4.40+ entfernt

Stattdessen docker mcp profile server add default --server file://... verwenden

docker mcp server enable not recognized

Befehl in Docker Desktop 4.40+ entfernt

Ersetzt durch docker mcp profile server add

docker mcp client connect fails: missing flag

--profile ist jetzt erforderlich

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

Tools erscheinen nicht in Claude

Prozess verwendet falschen Docker-Kontext

--context desktop-linux zu den docker-run-Argumenten hinzufügen

„gateway panic“ / Tools verschwinden

Mehrzeiliger Tool-Docstring

Alle @mcp.tool()-Docstrings auf genau eine Zeile beschränken

Portkonflikt auf 4000/4040

Port ist bereits belegt

WEBHOOK_PORT=4041 in der Umgebung setzen

Tool zeigt „not loaded yet“

Cache aus vorheriger Sitzung

Claude Desktop neu starten + neue Konversation beginnen

👨💻 Autor & Entwickler

Mit ❤️ entwickelt von Ahmed E. El-Sbaei

📄 Lizenz

Verteilt unter der MIT-Lizenz — © 2026 elsba3ei.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers