R

Reqable Mcp Server

Reqable Mcp Server

本地服务

github.com/ElonJask开发工具23724 周前更新

关于 Reqable Mcp Server

Reqable MCP Server 将 Reqable 的本地抓包数据通过 MCP 提供给客户端。默认仅在本机运行并将数据存入本地 SQLite，适合需要分析 HTTP 与 WebSocket 流量的开发者。

主要功能

01接收 Reqable 推送的 HAR 与 WebSocket 事件
02本地 SQLite 存储与保留期清理
03HTTP 请求查询、搜索与域名统计
04WebSocket 会话与消息的查询和分析
05支持从 HAR 文件导入补充数据

适用场景

01检索 Reqable 捕获的 API 请求与响应
02分析 WebSocket 会话中的消息结构
03根据抓包请求生成示例客户端代码

MCP 相关

该服务作为 MCP 服务端，向 Windsurf、Cursor、Claude、Codex 等 MCP 客户端暴露抓包数据的查询与分析工具，如 search_requests 与 get_websocket_session。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y reqable-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmreqable-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Reqable MCP Server

NPM Version PyPI Version GitHub License

Reqable MCP Server 会将 Reqable 本地捕获的流量提供给 MCP 客户端（Windsurf/Cursor/Claude/Codex）。

默认架构仅在本地运行：

Reqable 将 HAR（JSON）发送到 http://127.0.0.1:18765/report。
可选的增量 WebSocket 事件可发送到 http://127.0.0.1:18765/ws/events。
reqable-mcp 会规范化请求和消息，并将其存储在本地 SQLite 中。
MCP 工具仅查询本地数据（默认不使用云端中继）。

文档：English | 中文

功能

本地优先、隐私优先的数据接收流程。
通过 Reqable Report Server 实时接收数据。
支持导入 HAR 文件，作为错过会话时的备用方案。
HTTP 请求查询、搜索、域名统计和 API 分析。
解析包含消息帧扩展的 HAR 条目中的 WebSocket 会话和消息。
跨平台运行（macOS / Linux / Windows，需 Python 3.10+）。

前置条件

安装并打开 Reqable。
将 Reqable Report Server 配置为向 http://127.0.0.1:18765/report 发送数据。
确保可以使用 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 的“Add Report Server”中使用以下值：

名称：reqable-mcp-local
匹配规则：*（或你的目标域名）
服务 URL：http://127.0.0.1:18765/report
压缩：None（或与接收端保持一致）

保存后，生成一些流量并调用 ingest_status，以确认收到的数据量。

重要说明：reqable-mcp 仍使用仅支持 HTTP 的数据接收传输方式（不提供原生 ws:// 监听器），但现在支持两种 HTTP 数据接收路径：/report 用于 HAR/会话数据，/ws/events 用于增量 WebSocket 事件。Reqable 数据包含帧数据（例如 _webSocketMessages 或事件帧对象）时，即可捕获 WebSocket 流量。WebSocket 工具会保留并提供原始条目 JSON 和原始消息 JSON。如果实时推送遗漏帧，仍可使用 HAR 导出/导入作为备用方案。

可用工具

ingest_status：数据接收服务状态和计数器
import_har：从文件路径导入 HAR
list_requests：按筛选条件列出最近的 HTTP/WebSocket 握手请求
get_request：按 ID 获取请求详情（full 包含 raw_entry）
search_requests：在 HTTP URL/正文/上传的原始条目（raw / raw_entry）中进行关键词搜索
list_websocket_sessions：列出已捕获的 WebSocket 会话
list_active_websocket_sessions：根据最近捕获的帧列出近期活跃的 WebSocket 会话
get_websocket_session：按 ID 获取 WebSocket 会话详情和消息（包括 raw_entry 和消息的 raw）
tail_websocket_messages：通过 request_id + after_seq 游标增量获取消息
search_websocket_messages：按关键词、方向、类型、操作码、关闭代码、域名和请求 ID 精确搜索 WebSocket 消息
analyze_websocket_session：汇总会话的方向、消息类型、JSON 结构和关闭事件
export_websocket_session_raw：导出上传的原始 WebSocket 条目和原始帧列表
health_report：数据接收状态和 WebSocket 数据质量报告
repair_websocket_messages：从原始帧回填缺失字段（支持试运行）
get_domains：域名级请求统计
analyze_api：推断某个域名的 API 结构
generate_code：根据捕获的 HTTP 请求生成示例客户端代码

环境变量

变量	描述	默认值
`REQABLE_INGEST_HOST`	报告接收主机	`127.0.0.1`
`REQABLE_INGEST_PORT`	报告接收端口	`18765`
`REQABLE_INGEST_PATH`	报告接收路径	`/report`
`REQABLE_WS_EVENTS_PATH`	增量 WebSocket 事件接收路径	`/ws/events`
`REQABLE_DATA_DIR`	本地数据目录	平台应用数据目录
`REQABLE_DB_PATH`	SQLite 文件路径	`${REQABLE_DATA_DIR}/requests.db`
`REQABLE_MAX_BODY_SIZE`	每个请求/消息持久化的最大正文字节数	`102400`
`REQABLE_MAX_REPORT_SIZE`	可接受的报告负载最大字节数	`10485760`
`REQABLE_MAX_IMPORT_FILE_SIZE`	HAR 导入文件最大字节数	`104857600`
`REQABLE_RETENTION_DAYS`	本地保留期限	`7`
`REQABLE_INGEST_TOKEN`	可选的本地身份验证令牌	未设置

隐私与数据保留

在默认模式下，数据保留在本地计算机上。
保留期限清理会应用于本地 DB 记录，包括 WebSocket 消息。
如果摄取服务离线，Reqable 推送报告失败后不会重试。

许可证

MIT

评论

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。