README.md
Query, filter, and analyze local HTTP capture records from Reqable.
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 助手
前置要求
安装
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）
| 工具 | 说明 |
|---|---|
list_captures |
列出抓包记录，支持按 host / method / status code / app / keyword 筛选，分页返回 |
get_capture_detail |
获取单条抓包的完整详情：请求头、响应头、TLS 握手信息、应用信息、时间戳 |
get_capture_body |
读取请求体或响应体内容，支持大小限制（默认 4KB，最大 64KB） |
get_capture_stats |
聚合统计：按域名、HTTP 方法、状态码、应用名称分组计数 |
API 测试记录（REST Client）
| 工具 | 说明 |
|---|---|
list_api_tests |
列出 Reqable REST 客户端的 API 测试记录，支持关键词搜索 |
get_api_test_detail |
获取单条 API 测试的完整请求与响应详情 |
安全性
- 只读访问：以
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
Tools (6)
list_capturesList capture records with filtering by host, method, status code, app, or keyword.get_capture_detailGet full details of a single capture including headers, TLS info, and timestamps.get_capture_bodyRead request or response body content with size limits.get_capture_statsGet aggregated statistics grouped by domain, HTTP method, status code, or application.list_api_testsList API test records from the REST client with keyword search.get_api_test_detailGet full request and response details for a specific API test.Configuration
claude_desktop_config.json
{"mcpServers": {"reqable": {"command": "python", "args": ["-m", "reqable_mcp"], "cwd": "/path/to/reqable-mcp"}}}Try it
→List all recent requests made to api.example.com.
→Show me the response body for the last POST request I made.
→Calculate the total request count for each domain in my capture history.
→Find all requests that returned a 500 status code.
→Show me the request headers for the most recent API test.