Supports proxy configuration for cURL, allowing HTTP/HTTPS traffic monitoring and analysis when making requests with cURL through the proxy server.
Provides automated proxy setup for Firefox with custom profile support, enabling selective monitoring of web traffic through the proxy.
Supports system-wide proxy configuration for Linux, allowing traffic monitoring and analysis across applications on Linux systems.
Enables system-wide proxy configuration for macOS, supporting traffic monitoring and analysis across applications on macOS systems.
Provides Node.js integration for proxy setup and traffic monitoring, supporting the core functionality of the proxy server.
Web Proxy MCP Server
Intelligent HTTP/HTTPS proxy server with Model Context Protocol (MCP) integration for automated traffic monitoring, analysis, and browser setup.
🌟 Features
Core Proxy Capabilities
Selective Proxying: Only monitor specific domains while allowing direct access to others
HTTP/HTTPS Support: Full support for HTTP requests and HTTPS tunneling via CONNECT
PAC File Generation: Automatic Proxy Auto-Configuration file generation
Traffic Capture: Detailed request/response logging with optional header/body capture
MCP Integration
16 MCP Tools: Complete automation via Model Context Protocol
Dynamic Configuration: Add/remove monitored domains at runtime
Real-time Analysis: Traffic pattern analysis and performance metrics
HAR Export: Standard HTTP Archive format for external analysis
Browser Setup Automation
Multi-Browser Support: Chrome, Firefox, cURL, and system-wide proxy setup
Script Generation: Automated setup script generation for different platforms
One-Click Configuration: Simple browser proxy configuration
🚀 Quick Start
Installation
Basic Usage
Add to VS Code MCP Configuration
Add to your VS Code mcp.json
:
🔧 MCP Tools
Target Management
proxy_add_target
: Add domains to monitorproxy_remove_target
: Remove domains from monitoringproxy_list_targets
: List all configured targetsproxy_update_target
: Update target configuration
Server Control
proxy_start_server
: Start the proxy serverproxy_stop_server
: Stop the proxy serverproxy_server_status
: Get server status and statistics
Browser Setup
proxy_generate_setup
: Generate browser setup scriptsproxy_get_pac_file
: Get PAC file content
Traffic Analysis
proxy_get_traffic_log
: View captured trafficproxy_export_har
: Export traffic as HAR fileproxy_clear_traffic_log
: Clear traffic logsproxy_analyze_traffic
: Analyze traffic patterns
Configuration
proxy_import_config
: Import configuration from fileproxy_export_config
: Export configuration to file
Advanced Analysis
proxy_analyze_traffic
: Traffic pattern analysisproxy_get_performance_metrics
: Performance monitoring
📊 Usage Examples
1. Monitor Specific API
2. Traffic Analysis
3. Browser Configuration
🔄 Workflow Integration
Development Debugging
Add your development domains to the proxy
Start the proxy server
Configure your browser to use the proxy
Monitor API calls and responses in real-time
Export traffic logs for analysis
API Testing
Configure proxy for your test endpoints
Run automated tests through the proxy
Capture all HTTP traffic automatically
Analyze response times and error patterns
Export detailed HAR files for reporting
Security Analysis
Monitor specific domains for security testing
Capture detailed request/response headers
Analyze traffic patterns for anomalies
Export logs for security review
📁 Project Structure
⚙️ Configuration
Target Configuration
Targets are stored in data/targets.json
:
Traffic Analysis
Max Entries: 5,000 traffic entries (configurable)
Persistence: Automatic save/load from
data/traffic-log.json
HAR Export: Standard HTTP Archive format
Real-time Metrics: Performance and usage statistics
Proxy Server
Default Port: 8080 (configurable)
PAC File: Automatic generation at
/proxy.pac
Protocol Support: HTTP and HTTPS (via CONNECT tunneling)
Performance Monitoring: Built-in metrics collection
🔒 Security Considerations
Local Only: Default configuration binds to localhost only
Selective Monitoring: Only configured domains are proxied
No Body Capture by Default: Sensitive data protection
Configurable Headers: Optional header capture for debugging
🤝 Integration with Other Tools
VS Code Workflow
Add to MCP configuration in VS Code
Use AI assistant to manage proxy configuration
Automate traffic analysis through AI commands
Generate reports and documentation automatically
Development Workflow
Monitor local development APIs
Test staging environment interactions
Debug production API calls (headers only)
Performance testing and analysis
📈 Performance
Minimal Overhead: Only proxied domains incur processing cost
Efficient Storage: Configurable traffic log retention
Background Processing: Non-blocking traffic capture
Memory Management: Automatic cleanup of old entries
🛠️ Advanced Features
Custom PAC Generation
The proxy generates intelligent PAC files that only route monitored domains through the proxy, maintaining normal browsing speed for other sites.
Traffic Pattern Analysis
Built-in analysis tools help identify:
API usage patterns
Response time trends
Error rate monitoring
Domain-specific metrics
Multi-Browser Support
Automated setup scripts for:
Chrome (with security flags for testing)
Firefox (with custom profile)
System-wide proxy (Linux/macOS)
Command-line tools (cURL)
🔧 Troubleshooting
Common Issues
Port in use: Change the proxy port in server configuration
Browser not using proxy: Verify PAC file URL or manual proxy settings
HTTPS issues: Check certificate handling in browser settings
No traffic captured: Ensure domains are added to target list
Debug Mode
Run with debug logging:
Logs Location
Server logs: Console output
Traffic logs:
data/traffic-log.json
Target config:
data/targets.json
📝 License
This project is part of the Docker Appliance MCP server collection and follows the same licensing terms.
🤖 AI Assistant Integration
This proxy is designed to work seamlessly with AI assistants through MCP:
Natural Language Control: "Start monitoring api.example.com"
Automated Analysis: "Analyze the last hour of API traffic"
Report Generation: "Export traffic data for the payment API"
Configuration Management: "Set up Chrome to use the proxy"
The MCP integration makes this proxy particularly powerful for AI-assisted development and debugging workflows.
Tools
Intelligent HTTP/HTTPS proxy server with MCP integration for automated traffic monitoring, analysis, and browser setup.
Related MCP Servers
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -82
- JavaScriptMIT License
- -securityAlicense-qualityA proxy server that sits between MCP clients and servers, providing authentication, tool discovery, caching, and guardrail enforcement to protect MCP servers from malicious inputs.Last updated -31MIT License
- AsecurityAlicenseAqualityA comprehensive HTTP client MCP server for security testing, API testing, and web automation that provides full-featured HTTP tools with detailed logging capabilities.Last updated -83MIT License