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 (http://localhost:9876/mcp), stdio (--transport stdio, Web 패널 자동 실행)도 지원

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을 열어 Web 패널을 확인합니다.

MCP 클라이언트 구성

Streamable HTTP 모드 (기본)

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

stdio 모드

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

stdio 모드는 백그라운드에서 Web 패널 (기본 포트 9876)을 자동으로 시작하며, Web UI와 스크린샷 기능은 그대로 사용할 수 있습니다. 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 ──▶ 截图

지원 플랫폼

OS를 자동 감지하여 내장 Chrome 브라우저를 선택합니다:

⚠️ 스크린샷 기능은 Chromium 브라우저가 필요합니다. 직접 다운로드하여 browsers/ 디렉터리에 압축을 풀어야 합니다.

다운로드 주소: Chrome for Testing

시작 시 운영체제를 자동 감지하여 해당 경로의 Chrome을 선택합니다. 스크린샷 기능을 사용하지 않으면 다운로드할 필요가 없습니다.