ER

elonjask/reqable-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

237 stars 18 forks Качество 73 Тренд 18MIT

elonjask/reqable-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/elonjask/reqable-mcp.

Обзор

elonjask/reqable-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/elonjask/reqable-mcp.

Обзор (машинный перевод)

Requable MCP Server предоставляет локальный трафик Requable захвата для MCP-клиентов (Windsurf/Cursor/Claude/Codex).

Архитектура по умолчанию работает только локально:

  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.
  • Парсинг сессий/сообщений WebSocket для записей HAR, содержащих расширения фрейма сообщений.
  • Кроссплатформенная среда выполнения (macOS / Linux / Windows с Python 3.10+).

Предварительные требования

  1. Установите и откройте Reqable.
  2. Настройте Requable Report Server для публикации в http://127.0.0.1:18765/report.
  3. Убедитесь, что Node.js (для npx) и uv (для uvx) доступны.

Установка

Запуск через NPX (рекомендую)

Местное развитие

Конфигурация клиента MCP

Настройка сервера Requable Report

Используйте эти значения в Requable «Добавить сервер отчетов»:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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

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
Открыть полный README на GitHub

Установка

npx -y reqable-mcp@latest
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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