HTTP Inspector MCP Server

MCP server based on Streamable HTTP, integrated with a Web panel and screenshot functionality.
Single process, single port — an all-in-one HTTP traffic inspection toolbox.
Solves the problem of needing manual screenshot reproduction in later stages of AI-driven automated penetration testing.

Features

• Send any HTTP request — supports all methods, custom Header/Body, proxy, timeout (similar to Burp Repeater)

• Web panel — real-time traffic history table (SSE push), Raw HTTP detail view, manual send panel

• Screenshot — AI can call screenshot_panel to screenshot the Web panel, returning a PNG file URL

• Dual transport modes — defaults to Streamable HTTP (http://localhost:9876/mcp), also supports stdio (--transport stdio, automatically starts the Web panel)

Related MCP server: httptoolkit-mcp

Quick Start

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

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

# 运行
python server.py
# 或指定模式（默认 http）：
python server.py --transport stdio --port 9876
# 可用参数：--transport http|stdio, --host, --port

Open http://localhost:9876 in your browser to view the Web panel.

MCP Client Configuration

Streamable HTTP mode (default)

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

stdio mode

{
  "mcpServers": {
    "http-inspector": {
      "command": "mcp-http-inspector",
      "args": ["--transport", "stdio"]
    }
  }
}

In stdio mode, the Web panel starts automatically in the background (default port 9876); the Web UI and screenshot functionality work as usual; to run alongside an HTTP instance, specify a different port with --port.

MCP Tools

For more usage guides, see skills/SKILL.md

Architecture

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

Supported Platforms

Automatically detects the OS and selects the built-in Chrome browser:

⚠️ The screenshot feature depends on the Chromium browser, which must be downloaded and extracted to the browsers/ directory.

Download: Chrome for Testing

At startup, the OS is automatically detected and the Chrome at the corresponding path is selected. No download is needed if you don't use the screenshot feature.