Status: [LIVE] Endpoints found: https://example.com/api/people Source: https://github.com/shahfazliz/proxy-mcp # proxy-mcp **MCP server** for AI agents to run a local HTTPS MITM proxy and mock headend/backend responses on real Android devices — at the network level, with zero app source changes. - Intercepts HTTP/HTTPS traffic from physical devices and emulators - Registers mock responses and JSON transform rules via MCP tools - Modifies outgoing requests (headers / query / body) via request-transform rules - Probes transforms before registering (one-shot dry-run patch) - Persists/restores transform rules across proxy restarts - Tracks per-request transform outcomes — distinguish patched, no_match, error - Gzip-safe — transparently decompresses, patches, and recompresses - Rewrites passthrough hosts (e.g. Android emulator `10.0.2.2` → `127.0.0.1`) - Simulates slow servers on mocks: `delayMs` processing time + `bandwidthKbps` streaming cap - Capture scoping (`proxy_scope`): retain only the hosts you're investigating so the log stays small - CLI fallback when MCP is unavailable ## Charles-only CA This proxy **must** use the same CA certificate that the target app's `network_security_config.xml` trusts. The only supported path is the **Charles Proxy CA** — no auto-generation, no Frida, no alternative CAs. ## Requirements - Node >= 18 - `adb` on PATH (for device proxy setup) - Charles Proxy CA (cert + key exported from Charles) ## Setup No clone needed. The server is installed from the npm registry (prebuilt `dist/` — no devDeps, no build step), then registered with your MCP client. ```bash # verify the CLI works once npx -y @shahfazliz/proxy-mcp@latest --help ``` > **Updates:** use `@latest` so new releases are picked up automatically — no cache clearing, no config changes. If you need reproducibility (e.g. comparing behavior across sessions), pin a specific version like `@0.1.1` instead. ### 1. Extract your Charles Proxy CA Charles stores its CA at `~/Library/Application Support/Charles/ca/`. Extract the cert and key into your project's `.proxy-ca/` d