Korean | 한국어

이 재포는 MCP-enhanced, ProxyPin의 Android 전용 포크입니다 (업스트림 ** v1.3.0**와 동기화). 그것은 내장 ** MCP 서버 (모델 콘텍스트 프로토콜) ** 전체 원본 캡처 기능 세트의 상단에, AI 클라이언트 (클래드, 커서, 윈드 서핑 등) 직접 안드로이드 장치에서 실행 프록시에 연결, 캡처 데이터를 읽고, 적극적으로 상호 인식 및 수정을 제어 - 추가 서비스 또는 파이썬 스크립트 필요.

---

특징

• **HTTP/HTTPS 캡처 **: Android에서 풀 패킷 캡처 및 HTTPS 해독 (VPN 기반, 시스템 프록시 필요) -Built-in MCP Server: AI는 실시간 트래픽을 보고 분석, 수정 및 해제할 수 있습니다.
• QR 코드 장치 페어링: 수동 Wi-Fi 프록시 설정 없이 다른 전화 연결
• Domain filtering: 필요한 트래픽만 허용 -Request search: 키워드, 내용 유형, 다중 상태 검색
• JavaScript 스크립트: 동적 요청/response 조작 -Request rewrite: 리디렉션, 체 교체, 헤더/params 수정 -Request mapping: 원격 서버 대신 로컬 파일/문자로 응답 -Request decryption: AES 키 자동 해독 메시지체

ProxyPin MCP (Android)

English | 中文

This repo is an MCP-enhanced, Android-only fork of ProxyPin (synced with upstream v1.3.0). It ships a built-in MCP Server (Model Context Protocol) on top of the full original capture feature set, letting AI clients (Claude, Cursor, Windsurf, etc.) connect directly to the running proxy on your Android device, read capture data, and actively control interception and modification — no extra service or Python script needed.

---

Features

• HTTP/HTTPS capture: full packet capture and HTTPS decryption on Android (VPN-based, no system proxy needed)
• Built-in MCP Server: AI can see, analyze, modify and release your traffic in real time
• QR code device pairing: connect other phones without manual Wi-Fi proxy config
• Domain filtering: intercept only the traffic you need
• Request search: keyword, content-type, multi-condition search
• JavaScript scripts: dynamic request/response manipulation
• Request rewrite: redirect, replace body, modify headers/params
• Request mapping: respond with local files/scripts instead of remote server
• Request decryption: AES key auto-decrypts message bodies
• Request blocking: block requests by URL pattern
• Breakpoint interception: Fiddler-style breakpoints, controllable by AI
• History: auto-save capture data; HAR import/export

---

MCP Server

TL;DR: Open ProxyPin, and AI can see every request you capture, help you analyze it, modify it, and release it — like Fiddler breakpoints, but controlled by AI.

Connection

The MCP Server listens on port 9010 by default and speaks two transports:

• Streamable HTTP at /mcp — the current MCP transport (protocol 2025-06-18, with version negotiation and Mcp-Session-Id session management). Recommended.
• Legacy HTTP+SSE at /sse — kept for older clients (protocol 2024-11-05).

The server starts automatically when the app launches (default on; toggle in Toolbox → MCP Server). The port is configurable there as well and is persisted across restarts.

Configure in Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "proxypin": {
      "url": "http://127.0.0.1:9010/mcp"
    }
  }
}

Running on a phone? Use the device IP (e.g. http://192.168.1.5:9010/mcp) or adb forward tcp:9010 tcp:9010.

---

Available MCP Tools (25 total)

1. Basic Capture Query (9 tools)