ProxyPin MCP Server (Enhanced)

High-performance HTTP request capture and analysis tool via MCP (Model Context Protocol). Connects to ProxyPin desktop and exposes 24 tools for LLM-driven traffic analysis.

• Connection pooling with automatic retry on transient failures
• Thread-safe operations for concurrent request handling
• 24 MCP tools for searching, replaying, comparing, and rewriting HTTP traffic
• Code generation in Python, JavaScript, cURL, PHP, Java, Go
• HAR import/export for interoperability
• API endpoint extraction for auto-generating API documentation
• Request comparison with JSON diff support

• Python 3.10+
• ProxyPin desktop running on port 17777

git clone https://github.com/1837620622/proxypin-mcp-server-ck.git
cd proxypin-mcp-server-ck
uv venv .venv --python 3.11
uv pip install -e . --python .venv/Scripts/python.exe  # Windows
# or: uv pip install -e . --python .venv/bin/python     # macOS/Linux

git clone https://github.com/1837620622/proxypin-mcp-server-ck.git
cd proxypin-mcp-server-ck
pip install -e .

python proxypin_mcp_server.py

export PROXYPIN_HOST=127.0.0.1   # Default: localhost
export PROXYPIN_PORT=17777        # Default: 17777

Add to ~/.claude.json under "mcpServers":

{
  "proxypin": {
    "type": "stdio",
    "command": "/path/to/.venv/Scripts/python.exe",
    "args": ["/path/to/proxypin_mcp_server.py"],
    "env": {
      "PROXYPIN_HOST": "127.0.0.1",
      "PROXYPIN_PORT": "17777"
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.proxypin]
command = '/path/to/.venv/Scripts/python.exe'
args = ['/path/to/proxypin_mcp_server.py']

[mcp_servers.proxypin.env]
PROXYPIN_HOST = "127.0.0.1"
PROXYPIN_PORT = "17777"

# Search by domain
search_requests(domain="example.com", limit=10)

# Search by method and status
search_requests(method="POST", status_code="200")

# Generate Python code from a request
generate_code(request_id="12345", language="python")

# Compare two requests
compare_requests(request_id_1="123", request_id_2="456")

# Extract all API endpoints for a domain
extract_api_endpoints(domain_filter="api.example.com")

Cannot connect to ProxyPin:

1. Ensure ProxyPin desktop is running
2. Check port 17777 is listening: curl http://127.0.0.1:17777/sse
3. Check firewall rules

Import errors:

pip install --upgrade pip
pip install -r requirements.txt --force-reinstall

MIT - see LICENSE

Original: ProxyPin Team | Enhanced by: ChuanKangKK