Reqable MCP 서버는 MCP 클라이언트(Windsurf/Cursor/Claude/Codex)에 로컬 Reqable 캡처 트래픽을 노출합니다.

기본 아키텍처는 로컬 전용입니다:

1. HAR(JSON) 게시물을 http://127.0.0.1:18765/report로 요청할 수 있습니다.
2. 선택적으로 점진적인 WebSocket 이벤트를 http://127.0.0.1:18765/ws/events에 게시할 수 있습니다.
3. reqable-mcp는 요청/메시지를 정규화하여 로컬 SQLite에 저장합니다.
4. MCP 도구는 로컬 데이터만 조회하며(기본적으로 클라우드 릴레이는 없음).

문서: 영어 | 中文

특징

• 로컬 우선, 개인정보 우선 인제스트 경로.
• Reqable Report Server를 통한 실시간 인제스트.
• 놓친 세션에 대한 HAR 파일 가져오기 백업.
• HTTP 요청 쿼리/검색/도메인 통계/API 분석.
• 메시지 프레임 확장을 포함한 HAR 항목에 대한 WebSocket 세션/메시지 파싱.
• 크로스 플랫폼 런타임(macOS / Linux / Windows with Python 3.10+).

선수 조건

1. Reqable을 설치하고 엽니다.
2. http://127.0.0.1:18765/report에 게시되도록 Reqable Report Server를 설정하세요.
3. npx에 대해서는 Node.js과 uv(uvx)가 사용 가능한지 확인하세요.

설치

NPX를 통해 진행하세요 (추천)

지역 개발

MCP 클라이언트 구성

요청 가능한 보고서 서버 설정

Reqable "Add Report Server"에서 이 값들을 사용하세요:

Reqable MCP Server

Reqable MCP Server exposes local Reqable capture traffic to MCP clients (Windsurf/Cursor/Claude/Codex).

Default architecture is local-only:

1. Reqable posts HAR(JSON) to http://127.0.0.1:18765/report.
2. Optional incremental WebSocket events can be posted to http://127.0.0.1:18765/ws/events.
3. reqable-mcp normalizes and stores requests/messages in local SQLite.
4. MCP tools query local data only (no cloud relay by default).

Docs: English | 中文

Features

• Local-first, privacy-first ingest path.
• Real-time ingest via Reqable Report Server.
• HAR file import fallback for missed sessions.
• HTTP request query/search/domain stats/API analysis.
• WebSocket session/message parsing for HAR entries carrying message-frame extensions.
• Cross-platform runtime (macOS / Linux / Windows with Python 3.10+).

Prerequisites

1. Install and open Reqable.
2. Configure Reqable Report Server to post to http://127.0.0.1:18765/report.
3. Ensure Node.js (for npx) and uv (for uvx) are available.

Installation

Run via npx (recommended)

npx -y reqable-mcp@latest

Local development

uv run reqable-mcp

MCP Client Configuration

{
  "mcpServers": {
    "reqable": {
      "command": "npx",
      "args": ["-y", "reqable-mcp@latest"]
    }
  }
}

Reqable Report Server Setup

Use these values in Reqable “Add Report Server”:

1. Name: reqable-mcp-local
2. Match rule: * (or your target domains)
3. Server URL: http://127.0.0.1:18765/report
4. Compression: None (or keep consistent with your receiver)

After saving, generate traffic and call ingest_status to verify incoming payload count.

Important note: reqable-mcp still uses HTTP-only ingest transport (no native ws:// listener), but now supports two HTTP ingest paths: /report for HAR/session payload and /ws/events for incremental WebSocket events. WebSocket capture works when Reqable payload includes frame data (for example _webSocketMessages or event frame objects). Raw entry JSON and raw message JSON are preserved and exposed by WebSocket tools. HAR export/import remains the fallback when live pushes miss frames.

Available Tools

• ingest_status: ingest server state and counters
• import_har: import HAR from file path
• list_requests: list recent HTTP/WebSocket handshake requests with filters
• get_request: fetch request details by ID (full includes raw_entry)
• search_requests: keyword search in HTTP URL/body/raw uploaded entry (raw / raw_entry)
• list_websocket_sessions: list captured WebSocket sessions
• list_active_websocket_sessions: list recently active WebSocket sessions by latest captured frames