mitmproxy-mcp

mitmproxy 기반 MCP 서버. Claude Code에서 HTTP 트래픽을 조회/수정/차단할 수 있다.

아키텍처

Claude Code ←(stdio/JSON-RPC)→ mitmdump -s addon.py (단일 프로세스)
                                 ├── MCP Server (FastMCP, stdio transport)
                                 └── mitmproxy addon (flow 캡처/수정)

설치

# uv 사용 (권장)
cd ~/rockheung/mitmproxy-mcp
uv sync

사용법

직접 실행

uv run mitmdump -s src/mitmproxy_mcp/server.py --listen-port 8080 \
    --set console_eventlog_verbosity=error

Claude Code MCP 설정

~/.claude.json 또는 프로젝트 .claude/settings.json에 추가:

{
  "mcpServers": {
    "mitmproxy": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/Users/heungjun/rockheung/mitmproxy-mcp",
        "mitmdump",
        "-s", "src/mitmproxy_mcp/server.py",
        "--listen-port", "8080",
        "--set", "console_eventlog_verbosity=error"
      ]
    }
  }
}

브라우저 프록시 설정

프록시 주소: http://localhost:8080

SSL 인증서 설치: 프록시 실행 중 http://mitm.it 방문

MCP 도구 목록

도구	설명
`get_version`	mitmproxy 버전 정보
`get_proxy_status`	프록시 상태 (포트, 레코딩 여부)
`get_certificate_status`	CA 인증서 상태
`get_flows`	캡처된 HTTP flow 목록
`get_flow_detail`	특정 flow 상세 정보
`filter_flows`	고급 필터링
`export_flow_curl`	flow를 cURL로 내보내기
`clear_session`	캡처 데이터 삭제
`toggle_recording`	기록 시작/중지
`create_map_local`	URL → 로컬 파일 매핑
`create_map_remote`	URL → 다른 URL 리다이렉트
`create_intercept`	flow 인터셉트
`create_block_rule`	URL 차단
`list_rules`	활성 규칙 목록