Elfproxy Dynamic IP

🚀 Privacy-First Infrastructure Solution

A privacy-first infrastructure solution that combines dynamic IP rotation with AI-optimized network interaction capabilities.

🚀 Quick Start

This solution is achieved through two collaborative components:

1. ElfProxy Dynamic IP Network

A global residential proxy infrastructure with the following features:

• 🌐 IP pool from over 195 countries, supporting city-level positioning.
• 🔄 Automated IP rotation (adjustable interval: 1s to 24h).
• 🛡️ Built-in TLS fingerprint masking.
• ⚡ Supports multiple protocols (HTTP/SOCKS5/WebSocket).
• 📊 Real-time traffic analysis dashboard.

2. Enhanced Model Context Protocol (MCP)

A network interaction layer designed specifically for AI, with the following features:

• 🧠 Context-aware request scheduling.
• 🖥️ Headless browser rendering cluster.
• ✂️ Intelligent content purification (removal of ads/trackers/redundancy).
• 🔄 Three-stage failover system (IP/HTTPHeader/protocol rotation).
• ⏱️ Adaptive rate limiting (automatically adjusts requests per second).

✨ Features

💻 Usage Examples

Basic Usage

When you have set up the MCP server using Claude, you can execute the following requests:

• Please extract a proxy IP address from the United States for me.
• Use puppeteer to access https://www.amazon.de through a US proxy IP.

📦 Installation

Prerequisites

Before you start, make sure you have:

• ElfProxy Account: Register an account on ElfProxy, contact ElfProxy customer service and obtain an apiKey (the trial version will provide 200MB of data).

Server Configuration

The apiKey can be configured through the application.yml system property.

Cursor Tool Configuration

To use this MCP server in Cursor, add the following configuration to your Cursor settings:

{
  "proxy-pool-server": {
    "url": "http://localhost:9000/sse",
    "enabled": true
  }
}

Build

mvn clean package

Run

java -jar target/proxy-pool-server-{version}.jar

📚 Documentation

API Endpoints

The server exposes the following MCP tools:

• getProxy: Get an IP address from the proxy pool. Please tell me the country code you need. I will extract the IP address according to the code and provide it to you.

📄 License

This project is licensed under the MIT License.

About ElfProxy

With over 100M IP nodes and global service coverage (excluding China), we provide stable and reliable service support for millions of products. Our comprehensive services are trustworthy.