de en es ja ko ru zh

elsba3ei Webhook MCP Server

Name: elsba3ei Webhook MCP Server
Author: elsba3ei

by elsba3ei

Overview Schema Source Related Servers Discussions Admin

Python

Local

🤖 elsba3ei Webhook MCP Server

SSRF, API 및 OOB(Out-Of-Band) 상호작용 테스트를 위한 고성능 로컬·공개 웹훅 인스펙터이자 Burp Suite Collaborator의 대안으로, Cloudflare Quick Tunnel 지원, 동적 mock 응답, 실시간 요청 캡처 및 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, form 데이터, raw 텍스트 또는 바이너리 hex 덤프)을 검사할 수 있습니다.
사용자 지정 상태 코드, 콘텐츠 유형, 헤더 및 시뮬레이션된 응답 지연 시간으로 응답을 동적으로 mock 처리할 수 있습니다.
OOB(Out-of-Band) SSRF / 웹훅 콜백을 기다리며 폴링 및 차단 대기할 수 있습니다 (wait_for_request).
사용자 지정 HTTP 요청을 재생하거나 위조(forge)할 수 있습니다 (replay_request).

Related MCP server: pipepie

🛠️ 사용 가능한 MCP 도구 참조

#	도구 이름	매개변수	설명
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=""`	mock 엔진을 기본값인 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)

PowerShell을 열고 이 디렉터리로 이동합니다:
```
cd G:\Playing\elsba3ei-webhook-mcp
```
자동화된 설정 스크립트를 실행합니다:
```
.\setup.ps1
```
Claude Desktop을 완전히 다시 시작합니다(시스템 트레이에서 종료한 후 다시 엽니다).
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"
      ]
    }
  }
}

🔧 문제 해결 매트릭스

증상	원인	해결 방법
`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 컨텍스트 사용	`--context desktop-linux` 인수를 docker run에 추가
"gateway panic" / 도구가 사라짐	여러 줄 tool docstring	모든 `@mcp.tool()` docstring을 정확히 한 줄로 유지
4000/4040 포트 충돌	포트가 이미 사용 중	환경 변수에 `WEBHOOK_PORT=4041` 설정
도구에 "가 표시됨"	이전 세션의 캐시	Claude Desktop을 재시작하고 새 대화를 시작

👨💻 작성자 및 개발자

❤️ (으)로 제작, 작성자: Ahmed E. El-Sbaei

🌐 LinkedIn: Ahmed E. El-Sbaei
🐙 GitHub: @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

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

catchr A
dev.workers.perch-app.catchr
Instant no-signup webhook & HTTP-request inspector for testing webhooks and agent tool-callbacks.
API Testing Developer Tools
1
Hooklistener AOAuth
com.hooklistener
Webhook, email, WebSocket and tunnel testing for AI agents: capture, wait, verify, replay.
Testing & QA Tools API Testing Email
461
AnyHook A
net.anyhook
A webhook inbox for agents: one call returns a live URL. Mock, verify, inspect and replay.
API Testing Testing & QA Tools Developer Tools
121
WebhookTest.net A
net.webhooktest
Anonymous webhook capture, inspection, waiting, and response configuration for AI agents.
API Testing Developer Tools Autonomous Agents
81

Related MCP Servers

UseWebhook MCP
API Testing Developer Tools Testing & QA Tools
figstra
A
license
Not graded
quality
D
maintenance
Enables generating webhook endpoints for testing, inspecting and comparing HTTP request payloads, replaying requests from history, and forwarding requests to localhost.
Updated a year ago (2025-07-02 19:13 UTC)
2
MIT
pipepieofficial
Networking & Infrastructure AI & Machine Learning Developer Tools
pipepie
A
license
A
quality
C
maintenance
Self-hosted webhook relay and tunnel with Noise NK encryption. Inspect requests, replay webhooks, trace AI pipelines, connect/disconnect tunnels — 13 MCP tools. No tokens or passwords needed.
Updated 6 months ago (2026-04-02 14:12 UTC)
13
8
AGPL 3.0
hookray-mcp
Developer Tools API Testing Testing & QA Tools
ShotaTanikawa
A
license
A
quality
D
maintenance
Enables AI agents to create disposable webhook URLs, capture incoming HTTP requests, inspect headers and bodies, and replay them against local or remote endpoints, streamlining the webhook handler development loop.
Updated 5 months ago (2026-05-15 08:15 UTC)
5
11 npm
MIT
Webhook Capture MCP
API Testing Developer Tools
void-pulse
A
license
A
quality
C
maintenance
Captures incoming webhook/HTTP requests and lets AI assistants inspect, wait for, and replay them to debug webhook integrations.
Updated 2 months ago (2026-08-12 22:55 UTC)
6
MIT