日本語 English

このリポジトリは、ProxyPinのMCP-enhanced、Android専用フォークです(上流v1.3.0と同期)。 組み込みの**MCP Server(Model Context Protocol)**をフル元のキャプチャ機能セットの上に出荷し、AIクライアント(Claude、Cursor、Windsurfなど)を、Androidデバイス上で実行中のプロキシに直接接続し、キャプチャデータを読み込み、インターセプションと修正を積極的に制御します。追加のサービスやPythonスクリプトは必要ありません。

お問い合わせ

##特徴

• HTTP / HTTPSキャプチャ:フルパケットキャプチャとAndroid上でHTTPSの復号化(VPNベース、システムプロキシは必要ありません)
• MCP Server:AIはリアルタイムでトラフィックを表示、分析、変更、リリースすることができます
• QRコード装置ペアリング:手動Wi-Fiプロキシ設定なしで他の携帯電話を接続して下さい
• ドメインフィルタリング:必要なトラフィックだけを介入 -リクエスト検索:キーワード、コンテンツタイプ、マルチコンディション検索 -JavaScriptスクリプト:動的リクエスト/応答操作 -Request rewrite: ボディをリダイレクト、置換、ヘッダ/パラメータの変更
• リクエストマッピング:リモートサーバではなくローカルファイル/スクリプトに対応
• 要求の復号: 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)