proxypin-mcp-server

# ProxyPin MCP Server ProxyPin's MCP server, which allows AI to utilize the functionalities of a packet capture tool. ## Features - Request Management: Advanced search, get request details, replay request, recent requests, clear requests - Code/Command Generation: Generate Python/JS/cURL code or cURL command - Rewrite and Intercept: Block URL, 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, `http://127.0.0.1:17777` (do not confuse with the packet capture tool's port 9099) - If mobile packet capture is needed, find a software that can forward mobile requests and set up a proxy to the computer's port 17777; recommend using ProxyPin's app version or appproxy, etc. - Python dependencies: `fastmcp`, `requests` ## Installation 1. Download the built-in MCP ProxyPin: Currently compiled for all platforms, a Windows version is provided in this repository, and versions for other platforms can be downloaded from the ProxyPin repository. 2. Download the MCP Python file: Download the Python file from the release and place it anywhere. ## Usage 1. Start ProxyPin and ensure normal packet capture; the default port is 9099 (this step is unrelated to MCP). 2. Start the MCP service and set the listening port to 17777 (to allow ProxyPin to listen for MCP tool calls). 3. Test the connection or manually test using: ```bash python proxypin_mcp_server.py ``` ## Configuring MCP in 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 ## Request and Search (5) - `search_requests` - Advanced search for HTTP requests - `get_request_details` - Get detailed request information - `replay_request` - Replay a request - `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 a cURL command ## Rewrite and Intercept (3) - `block_url` - Block a URL - `add_response_rewrite` - Add a response rewrite rule - `add_request_rewrite` - Add a request rewrite rule ## Script Management (2) - `update_script` - Create or update a JavaScript script - `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 the proxy status - `add_host_mapping` - Add a 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 ## Frequently Asked Questions - ProxyPin connection failure: Usually caused by incorrect port configuration during the communication process. - Empty requests: Check if the ProxyPin proxy is correctly enabled and capturing traffic. ## Contribution Feel free to submit issues or PRs to add more tools, enhance stability, or improve documentation. ## License MIT