npm package: @proxies-sx/mcp-proxy-tester
Description: MCP Server for AI agents to test proxies - HTTP, HTTPS, SOCKS5, DNS leak, anonymity checks
Author: PROXIES.SX
Latest version: 1.0.1

# @proxies-sx/mcp-proxy-tester

MCP Server for AI agents to test proxies via natural language. Test any HTTP, HTTPS, or SOCKS5 proxy for connectivity, DNS leaks, anonymity, speed, and more.

## Features

- **3 Powerful Tools** - One master tester + specialized DNS leak & fingerprint tests
- **Smart Auto-Detection** - Detects SOCKS5 from format (`socks5://`) or port (1080) automatically
- **Bulk Testing** - Test up to 10 proxies simultaneously
- **Works with ANY proxy** - Not limited to PROXIES.SX
- **AI-Native** - Designed for Claude, Cursor, Cline, and other MCP clients

## Installation

```bash
npx @proxies-sx/mcp-proxy-tester
```

Or install globally:

```bash
npm install -g @proxies-sx/mcp-proxy-tester
```

## Configuration

### Claude Code / Cursor

Add to your `.mcp.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "proxy-tester": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-proxy-tester"],
      "env": {
        "PROXY_TESTER_API_KEY": "ptx_your_api_key_here"
      }
    }
  }
}
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "proxy-tester": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-proxy-tester"],
      "env": {
        "PROXY_TESTER_API_KEY": "ptx_your_api_key_here"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `test_proxy` | Universal proxy tester. Auto-detects HTTP/SOCKS5, runs UDP tests for SOCKS5 automatically. Supports bulk testing (up to 10 proxies). |
| `test_dns_leak` | DNS leak detection. Tests TCP and UDP DNS to ensure your real DNS isn't exposed. |
| `test_p0f` | P0F OS fingerprinting. Checks if your real operating system is being leaked through TCP/IP stack analysis. |

## Example Usage

### Test a single proxy (auto-detect type)

```
User: Test this proxy: 192.168.1.1:8080:admin:password

AI: ✅ **Proxy Working**

**Proxy:** `192.168.1.1:8080:***:***`
**Type:** HTTP (auto-detected)
**Tests:** 5/5 passed
**Duration:** 1250ms

**Connectivity:**
  HTTP:  ✓ 45.123.xxx.xxx
  HTTPS: ✓ 45.123.xxx.xxx

**Latency:**
  HTTP:  156ms
  HTTPS: 189ms
  RTT:   45ms
```

### Test a SOCKS5 proxy (UDP auto-included)

```
User: Test socks5://proxy.example.com:1080:user:pass

AI: ✅ **Proxy Working**

**Proxy:** `proxy.example.com:1080:***:***`
**Type:** SOCKS5 (auto-detected)
**Tests:** 8/8 passed

**Connectivity:**
  HTTP:  ✓ 203.45.xxx.xxx
  HTTPS: ✓ 203.45.xxx.xxx

**SOCKS5 UDP:**
  UDP:    ✓ Supported
  UDP IP: ✓ 203.45.xxx.xxx

**Latency:**
  HTTP:  89ms
  HTTPS: 112ms
  RTT:   23ms
```

### Check for DNS leaks

```
User: Does this proxy leak DNS? socks5://proxy.example.com:1080

AI: ✅ **NO DNS LEAK**

**Proxy:** `proxy.example.com:1080`

**TCP DNS:** ✓ Safe
  Cloudflare (172.69.xxx.xxx)

**UDP DNS:** ✓ Safe
  Cloudflare (172.69.xxx.xxx)

Your DNS requests are properly routed through the proxy.
```

### Bulk test proxies

```
User: Test these 5 proxies and tell me which work

AI: **Bulk Proxy Test Results**

1. ✅ `proxy1.com:8080` (HTTP) - 5/5 passed
2. ❌ `proxy2.com:8080` (HTTP) - All tests failed
3. ⚠️ `proxy3.com:1080` (SOCKS5) - 6/8 passed
4. ✅ `proxy4.com:8080` (HTTP) - 5/5 passed
5. ❌ `proxy5.com:8080` (HTTP) - Connection timeout

**Summary:** 2 working, 1 partial, 2 dead
```

### Check OS fingerprint anonymity

```
User: Check if this proxy leaks my OS fingerprint

AI: **P0F Fingerprint Analysis**

**Proxy:** `proxy.example.com:8080`
**Proxy IP:** 45.123.xxx.xxx

**IPv4 Fingerprint:**
  ✓ Linux 3.11+ (generic)

**Anonymity Assessment:**
✓ OS fingerprint appears normal/masked. Good anonymity.
```

## Test Modes

The `test_proxy` tool supports different modes:

| Mode | Description | Tests Run |
|------|-------------|-----------|
| `auto` | Smart detection based on proxy type (default) | HTTP/HTTPS + Speed. Adds UDP for SOCKS5 |
| `quick` | Fast connectivity check | HTTP/HTTPS + Speed only |
| `full` | Comprehensive testing | Everything including IPv6 |
| `ipv6` | IPv6 only | HTTP/HTTPS over IPv6 |

## Supported Proxy Formats

```
host:port                     # HTTP (auto-detected)
host:port:user:pass           # HTTP with auth
http://host:port              # Explicit HTTP
http://user:pass@host:port    # HTTP with auth
socks5://host:port            # SOCKS5 (auto-runs UDP tests)
socks5://user:pass@host:port  # SOCKS5 with auth
```

**Auto-Detection:** Proxies are detected as SOCKS5 if:
- URL starts with `socks5://` or `socks://`
- Port is 1080, 1081, 9050, or 9051

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `PROXY_TESTER_API_KEY` | Yes | API key from proxies.sx |
| `PROXY_TESTER_API_URL` | No | Custom API endpoint |

## Rate Limits

| Tier | Tests/Hour | Price |
|------|------------|-------|
| Free | 10 | $0 |
| Basic | 100 | $9.99/mo |
| Pro | 1,000 | $29.99/mo |
| Enterprise | Unlimited | Custom |

Get your API key at: https://proxies.sx/mcp/tester

## Links

- **Website:** https://proxies.sx/mcp/tester
- **Documentation:** https://proxies.sx/docs/mcp-tester
- **API Reference:** https://api.proxies.sx/docs
- **Support:** support@proxies.sx

## License

MIT License - see [LICENSE](LICENSE)

---

Built by [PROXIES.SX](https://proxies.sx) - Premium 4G/5G Mobile Proxies