proxypin-mcp-server

# ProxyPin MCP Server The ProxyPin MCP server acts as a bridge between packet capture software and AI tools, enabling AI to leverage the functionalities of packet capture software. ## Features - Request Management: Advanced search, get request details, replay requests, recent requests, clear requests - Code/Command Generation: Generate Python/JS/cURL code or cURL commands - Rewrite and Intercept: Block URLs, add request/response rewrite rules - Script Management: Create/update/list JavaScript scripts for request processing - Proxy Control: Start/stop proxy, get proxy status, Hosts mapping - HAR Import/Export: Export HAR, import HAR - Analysis and Statistics: Request statistics, compare requests, extract API endpoints - Others: Set ProxyPin configuration, export statistics, etc. ## Environment Requirements - Python 3.10+ - ProxyPin: Listens on port 17777 by default for MCP communication, accessible at `http://127.0.0.1:17777` (distinct from the 9099 port used by packet capture tools) - For mobile packet capture, use any software capable of forwarding mobile requests, then proxy to the computer's 17777 port; recommended: ProxyPin's app version, appproxy, etc. - Python dependencies: `fastmcp`, `requests` ## Installation 1. Download the built-in MCP ProxyPin: Compiled for all platforms; a Windows version is provided in this repository, while other platforms can find it in the ProxyPin repository. 2. Download the MCP Python file: Available in the release section; place it anywhere. ## Usage 1. Launch ProxyPin for normal packet capture; default port is 9099. > This step is prerequisite and unrelated to MCP. 2. Start the MCP server and set the listening port to 17777. > This step enables ProxyPin to listen for MCP tool calls from AI. 3. Test the connection or manually verify: ```bash python proxypin_mcp_server.py ``` ## Configuring MCP in an IDE (Example) ```json "proxypin-mcp": { "command": "path/to/your/python.exe", "args": ["path/to/downloaded/py/file"], "disabled": false, "autoApprove": [ "search_requests", "get_request_details", "replay_request", "generate_code", "get_curl", "block_url", "add_response_rewrite", "add_request_rewrite", "update_script", "get_scripts", "set_config", "add_host_mapping", "get_proxy_status", "start_proxy", "stop_proxy", "export_har", "import_har", "get_recent_requests", "clear_requests", "get_statistics", "compare_requests", "find_similar_requests", "extract_api_endpoints" ] } ``` ## Tool List (Primary) ### Requests and Search (5) - `search_requests` - Advanced search for HTTP requests - `get_request_details` - Get detailed request information - `replay_request` - Replay requests - `get_recent_requests` - Get a list of recent requests (Legacy) - `clear_requests` - Clear captured requests ### Code and Command (2) - `generate_code` - Generate example code (Python/JS/cURL) - `get_curl` - Generate cURL commands ### Rewrite and Intercept (3) - `block_url` - Block URLs - `add_response_rewrite` - Add response rewrite rules - `add_request_rewrite` - Add request rewrite rules ### Script Management (2) - `update_script` - Create or update JavaScript scripts - `get_scripts` - List all scripts ### Proxy and Network (4) - `start_proxy` - Start the proxy server - `stop_proxy` - Stop the proxy server - `get_proxy_status` - Get proxy status - `add_host_mapping` - Add Hosts mapping ### HAR and Import/Export (2) - `export_har` - Export HAR - `import_har` - Import HAR ### Analysis and Statistics (3) - `get_statistics` - Get request statistics - `compare_requests` - Compare two requests - `extract_api_endpoints` - Extract and group API endpoints ### Others (2) - `set_config` - Set ProxyPin configuration (e.g., system_proxy, ssl_capture) - `find_similar_requests` - Find similar requests ## FAQ - ProxyPin connection failure: Typically due to miscommunication leading to incorrect port configurations. - Empty requests: Check if ProxyPin proxy is correctly enabled and capturing traffic. ## Contribution Submit issues or PRs to add more tools, enhance stability, or improve documentation. ## License MIT