HTTP Inspector MCP Server

MCP-сервер на основе Streamable HTTP со встроенной веб-панелью и функцией скриншотов.
Один процесс, один порт — универсальный инструментарий для инспекции HTTP-трафика.
Решает проблему необходимости ручного воспроизведения скриншотов после автоматизированного пентеста с помощью ИИ.

Возможности

• Отправка произвольных HTTP-запросов — поддержка всех методов, пользовательских Header/Body, прокси, таймаутов (аналог Burp Repeater)

• Веб-панель — таблица истории трафика в реальном времени (SSE-рассылка), просмотр Raw HTTP-деталей, панель ручной отправки

• Скриншоты — ИИ может вызывать screenshot_panel для снятия скриншота веб-панели, возвращается URL PNG-файла

• Два режима транспорта — по умолчанию Streamable HTTP (http://localhost:9876/mcp), также поддерживается stdio (--transport stdio, веб-панель запускается автоматически)

Related MCP server: httptoolkit-mcp

Быстрый старт

# 安装依赖
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

Откройте http://localhost:9876 в браузере, чтобы увидеть веб-панель.

Конфигурация MCP-клиента

Режим Streamable HTTP (по умолчанию)

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

Режим stdio

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

В режиме stdio веб-панель автоматически запускается в фоне (порт по умолчанию 9876), веб-интерфейс и функция скриншотов работают как обычно; для сосуществования с HTTP-экземпляром укажите другой порт через --port.

Инструменты MCP

Дополнительные инструкции см. в skills/SKILL.md

Архитектура

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

Поддерживаемые платформы

Автоматическое определение ОС и выбор встроенного браузера Chrome:

⚠️ Функция скриншотов зависит от браузера Chromium — необходимо самостоятельно скачать и распаковать его в каталог browsers/.\

Адрес загрузки: Chrome for Testing

При запуске автоматически определяется ОС и выбирается Chrome по соответствующему пути. Если функция скриншотов не используется, загрузка не требуется.