Reqable Mcp Server

Created By
ElonJask2 months ago
MCP server for Reqable local capture data
Overview

Reqable MCP Server

NPM Version PyPI Version GitHub License

reqable-mcp 用于把本地 Reqable 抓包数据暴露给 MCP 客户端(Windsurf/Cursor/Claude/Codex)。

默认采用本地优先架构:

  1. Reqable 把 HAR(JSON) 上报到 http://127.0.0.1:18765/report
  2. reqable-mcp 解析后写入本地 SQLite。
  3. MCP 工具只读取本地数据,不走默认云端中转。

文档: English | 中文

核心特性

  • 本地优先、隐私优先。
  • 基于 Report Server 的近实时上报。
  • 支持 HAR 文件补录兜底。
  • 请求列表、检索、域名统计、API 结构分析、代码生成。
  • 跨平台可用(macOS / Linux / Windows,Python 3.10+)。

前置条件

  1. 已安装并打开 Reqable。
  2. 在 Reqable 中配置 Report Server 上报到 http://127.0.0.1:18765/report
  3. 本机具备 Node.js(给 npx)和 uv(给 uvx)。

安装与启动

npx 启动(推荐)

npx -y reqable-mcp@latest

本地开发运行

uv run reqable-mcp

MCP 配置示例

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

Reqable Report Server 配置

在 Reqable 的“添加报告服务器”中建议填写:

  1. 名称:reqable-mcp-local
  2. 匹配规则:*(或你自己的目标域名规则)
  3. 服务器 URL:http://127.0.0.1:18765/report
  4. 压缩:(或与接收端保持一致)

保存后产生一点请求流量,再调用 ingest_status 验证计数是否增长。

可用工具

  • ingest_status:查看接收端状态和计数
  • import_har:从 HAR 文件导入
  • list_requests:按条件列出请求
  • get_request:按 ID 查询明细
  • search_requests:按关键字检索 URL/Body
  • get_domains:按域名聚合统计
  • analyze_api:分析某域名 API 结构
  • generate_code:从抓包生成调用代码

环境变量

变量说明默认值
REQABLE_INGEST_HOST接收服务监听地址127.0.0.1
REQABLE_INGEST_PORT接收服务监听端口18765
REQABLE_INGEST_PATH接收服务路径/report
REQABLE_DATA_DIR本地数据目录平台默认应用数据目录
REQABLE_DB_PATHSQLite 文件路径${REQABLE_DATA_DIR}/requests.db
REQABLE_MAX_BODY_SIZE每条请求落库 body 最大字节数102400
REQABLE_MAX_REPORT_SIZE单次上报最大字节数10485760
REQABLE_MAX_IMPORT_FILE_SIZEHAR 导入文件最大字节数104857600
REQABLE_RETENTION_DAYS数据保留天数7
REQABLE_INGEST_TOKEN可选本地鉴权 token未设置

隐私与保留策略

  • 默认模式下数据仅存本机。
  • 过期数据会按保留窗口自动清理。
  • 若接收端离线,Reqable 对失败上报默认不重试,该次数据会丢失。

许可证

MIT

Server Config

{
  "mcpServers": {
    "reqable": {
      "command": "npx",
      "args": [
        "-y",
        "reqable-mcp@latest"
      ]
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
ElonJask
Star
-
Language
-
License
-
Category
Tags

Recommend Servers

View All
Memchats

4 hours ago
Mira

26 minutes ago
Nordic Data

2 days ago