HTTP Inspector MCP Server

基于 Streamable HTTP 的 MCP 服务器，集成 Web 面板与截图功能。
单进程、单端口 — 一站式 HTTP 流量检测工具箱。
解决AI自动化渗透测试后续需要人工复现截图的问题。

功能

• 发送任意 HTTP 请求 — 支持全部方法、自定义 Header/Body、代理、超时（类似 Burp Repeater）
• Web 面板 — 实时流量历史表格（SSE 推送）、Raw HTTP 详情视图、手动发送面板
• 截图 — AI 可调用 screenshot_panel 截图 Web 面板，返回 PNG 文件 URL
• Streamable HTTP — MCP 客户端通过 http://localhost:9876/mcp 连接

快速开始

# 安装依赖
cd mcp-http-inspector
pip install -e .

# 安装 Chromium 浏览器（用于截图）
# 项目 browsers/ 目录已内置 linux/mac-arm/win64 三平台 Chrome
# 无需额外安装，启动时自动检测

# 运行
python server.py

浏览器打开 http://localhost:9876 查看 Web 面板。

MCP 客户端配置

{
  "mcpServers": {
    "http-inspector": {
      "url": "http://localhost:9876/mcp"
    }
  }
}

MCP 工具

工具	说明
send_http_request	发送任意 HTTP 请求，支持 auto_screenshot 一步获取截图
list_history	列出请求历史，支持过滤和分页（不返回 raw body）
get_request_detail	按 ID 获取原始 HTTP 请求/响应（默认截断 5000 字符）
screenshot_panel	截图 Web 面板（history/detail/sender），返回 PNG 下载 URL
screenshot_last_request	快捷截图最新请求的 Detail，无需传 ID
clear_all_history	清空所有历史记录和截图文件

更多使用指南见 .reasonix/skills/http-inspector/SKILL.md

架构

MCP 客户端 ──HTTP──▶ :9876/mcp (Streamable HTTP)
浏览器     ──HTTP──▶ :9876/    (Web 面板 SPA)
                     :9876/api/* (REST + SSE)
                            │
                     httpx ──▶ 目标服务器
                     SQLite ◀── 历史存储
                     Playwright ──▶ 截图

支持平台

自动检测 OS 选择内置 Chrome 浏览器：

系统	路径
Linux x64	browsers/chrome-linux64/chrome
macOS ARM	browsers/chrome-mac-arm64/.../Google Chrome for Testing
Windows x64	browsers/chrome-win64/chrome.exe