Reqable MCP ServerはローカルのReqableキャプチャトラフィックをMCPクライアント(Windsurf/Cursor/Claude/Codex)に公開します。

デフォルトのアーキテクチャはローカルのみです:

1. HAR(JSON)からhttp://127.0.0.1:18765/reportまでのReqable posts。
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. Reqable Report Serverをhttp://127.0.0.1:18765/reportに投稿する設定。
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