英文 |中文

本仓库是 MCP 增强的 Android 专用分支 ProxyPin（与上游 v1.3.0 同步）。 它内置了 MCP 服务器（模型上下文协议），建立在完整的原始捕获功能之上，允许 AI 客户端（Claude、Cursor、Windsurf 等）直接连接到你安卓设备上的运行代理，读取捕获数据，并主动控制拦截和修改——无需额外服务或 Python 脚本。

---

特色

• HTTP/HTTPS 捕获：Android 上实现完整数据包捕获和 HTTPS 解密（基于 VPN，无需系统代理）
• 内置MCP服务器：AI可以实时查看、分析、修改并释放你的流量
• 二维码设备配对：无需手动Wi-Fi代理配置即可连接其他手机
• 域过滤：只拦截你需要的流量
• 请求搜索：关键词、内容类型、多条件搜索
• JavaScript脚本：动态请求/响应操作
• 请求重写：重定向、替换正文、修改头部/参数
• 请求映射：用本地文件/脚本响应，而非远程服务器
• 请求解密：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)