Reqable Capture Reader MCP Server

一个 MCP (Model Context Protocol) 服务端，用于读取 Reqable 抓包工具的本地数据，让 AI 助手能够直接查询、筛选和分析你的 HTTP 抓包记录。

它能做什么？

通过自然语言与 AI 助手对话，即可完成以下操作：

• “列出所有访问 api.example.com 的请求” → 按域名筛选抓包记录

• “最近那条 POST 请求返回了什么？” → 查看响应体内容

• “统计一下各个域名的请求量” → 获取聚合统计

• “看看状态码 500 的请求都有哪些” → 按状态码筛选定位问题

• “那条请求的请求头是什么？” → 查看完整请求/响应头、TLS 信息

无需手动翻找 Reqable 界面，AI 帮你直接从数据库中检索。

工作原理

Reqable 使用 ObjectBox（基于 LMDB）存储抓包数据，本项目以只读模式直接读取该数据库，不会修改任何数据，且 Reqable 运行时也可安全读取。

Reqable 抓包 → LMDB 数据库 → reqable-mcp (只读) → MCP 协议 → AI 助手

前置要求

• Python 3.10+

• Reqable 已安装并有抓包记录

• 支持 MCP 的客户端（如 Warp、Claude Desktop 等）

安装

git clone https://github.com/iambond50-svg/reqable-mcp.git
cd reqable-mcp
pip install -e .

配置

Warp

在 Warp 的 MCP 设置中添加：

{
  "mcpServers": {
    "reqable": {
      "command": "python",
      "args": ["-m", "reqable_mcp"],
      "cwd": "/path/to/reqable-mcp"
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "reqable": {
      "command": "python",
      "args": ["-m", "reqable_mcp"],
      "cwd": "/path/to/reqable-mcp"
    }
  }
}

将 /path/to/reqable-mcp 替换为实际项目路径。

提供的 MCP 工具

抓包记录（Proxy Capture）

API 测试记录（REST Client）

安全性

• 只读访问：以 readonly=True, lock=False 模式打开 LMDB，不会写入或修改任何数据

• Body 大小限制：默认最大返回 4KB 响应体，防止大文件撑爆上下文，可调至最大 64KB

• 分页保护：列表默认返回 20 条，最大 100 条，避免一次性加载过多数据

数据位置

Reqable 默认数据目录：

• Windows: %APPDATA%\\Reqable\\

• macOS: ~/Library/Application Support/Reqable/

本项目会自动检测默认路径，无需手动配置。

项目结构

reqable-mcp/
├── pyproject.toml           # 项目配置与依赖
├── README.md
├── .gitignore
└── src/reqable_mcp/
    ├── __init__.py
    ├── __main__.py           # 入口点 (python -m reqable_mcp)
    ├── server.py             # MCP 工具定义（6 个工具）
    ├── db.py                 # LMDB 只读访问层
    └── models.py             # 数据解析与格式化

License

MIT