Reqable MCP Server

NPM Version PyPI Version GitHub License

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

Default architecture is local-only:

Reqable posts HAR(JSON) to http://127.0.0.1:18765/report.
reqable-mcp normalizes and stores requests in local SQLite.
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.
Fast request query/search/domain stats/API analysis.
Cross-platform runtime (macOS / Linux / Windows with Python 3.10+).

Prerequisites

Install and open Reqable.
Configure Reqable Report Server to post to http://127.0.0.1:18765/report.
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":

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

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

Available Tools

ingest_status: ingest server state and counters
import_har: import HAR from file path
list_requests: list recent requests with filters
get_request: fetch request details by ID
search_requests: keyword search in URL/body
get_domains: domain-level request statistics
analyze_api: infer API shapes for a domain
generate_code: generate sample client code from captured request

Environment Variables

| Variable | Description | Default | |---|---|---| | REQABLE_INGEST_HOST | Report receiver host | 127.0.0.1 | | REQABLE_INGEST_PORT | Report receiver port | 18765 | | REQABLE_INGEST_PATH | Report receiver path | /report | | REQABLE_DATA_DIR | Local data directory | platform app data dir | | REQABLE_DB_PATH | SQLite file path | ${REQABLE_DATA_DIR}/requests.db | | REQABLE_MAX_BODY_SIZE | Max persisted body bytes per request | 102400 | | REQABLE_MAX_REPORT_SIZE | Max accepted report payload bytes | 10485760 | | REQABLE_MAX_IMPORT_FILE_SIZE | Max HAR import file bytes | 104857600 | | REQABLE_RETENTION_DAYS | Local retention window | 7 | | REQABLE_INGEST_TOKEN | Optional local auth token | unset |

Privacy and Data Retention

Data stays on local machine in default mode.
Retention cleanup is applied to local DB records.
If ingest server is offline, Reqable failed report push is not retried.

License

MIT

MCP Servers