convez.ai
MCP Server
juliobrasa

proxyseo-mcp

juliobrasa/proxyseo-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for ProxySEO dedicated proxies — use your proxies from Claude, Codex, LangChain and any MCP agent

Instalação

$npx convez-ai juliobrasa/proxyseo-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

ProxySEO MCP Server

Español | English


Español

Servidor MCP (Model Context Protocol) para tu servicio de proxies ProxySEO. Permite a Claude Desktop, Claude Code y cualquier cliente MCP consultar y usar tus proxies directamente desde el asistente.

Tools disponibles

ToolDescripción
get_proxyDevuelve un proxy listo para usar (URL http://user:pass@ip:puerto o JSON)
list_proxiesLista todas las IPs asignadas a tu servicio (simple o detailed)
proxy_statusEstado del servicio: plan, nº de IPs, puertos, tipo de auth
check_proxyComprueba conectividad y anonimato a través del proxy

Todas las tools son de solo lectura sobre tu propio servicio. La API key identifica tu servicio: no necesitas configurar ningún ID.

Instalación

Descarga el binario para tu plataforma desde la última release. Por ejemplo, en Linux/macOS:

# Linux (amd64) — cambia el sufijo por tu plataforma:
# proxy-mcp-linux-arm64 · proxy-mcp-darwin-amd64 · proxy-mcp-darwin-arm64 · proxy-mcp-windows-amd64.exe
curl -L -o proxy-mcp https://github.com/juliobrasa/proxyseo-mcp/releases/latest/download/proxy-mcp-linux-amd64
chmod +x proxy-mcp
sudo mv proxy-mcp /usr/local/bin/proxy-mcp

Genera tu API key desde el panel de cliente de ProxySEO (sección «Acceso para agentes IA»). Se muestra una sola vez: guárdala en un gestor de contraseñas.

Configuración en Claude Desktop / Claude Code

Añade a tu claude_desktop_config.json (Desktop) o .mcp.json (Claude Code):

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "tu-api-key-aqui"
      }
    }
  }
}

Variables de entorno

VariableObligatoriaDefaultDescripción
PROXYSEO_API_KEYSí—API key de tu servicio (64 caracteres hex)
PROXYSEO_API_URLNohttps://api.proxyseo.esURL base de la API

Ejemplo de uso

En Claude, simplemente pide:

«Dame un proxy en formato URL para usar con curl»

Claude llamará a get_proxy y devolverá algo como:

http://usuario:contraseña@185.x.x.x:58542

«¿Cuántas IPs tiene mi servicio y están funcionando?»

Claude combinará proxy_status y check_proxy.

Troubleshooting

SíntomaCausaSolución
ERROR: PROXYSEO_API_KEY environment variable is requiredFalta la variableAñádela al bloque env del config MCP
unauthorized: invalid or revoked API keyKey incorrecta o revocadaVerifica la key; pide una nueva si fue revocada
rate limit exceeded (60 req/min)Demasiadas llamadasEspera 1 minuto; el límite es por key
service not found or inactiveServicio suspendido/canceladoRevisa el estado de tu servicio en el panel
El server no aparece en ClaudeRuta del binario incorrectaUsa ruta absoluta en command y reinicia Claude

English

MCP (Model Context Protocol) server for your ProxySEO proxy service. Lets Claude Desktop, Claude Code and any MCP client query and use your proxies directly from the assistant.

Available tools

ToolDescription
get_proxyReturns a ready-to-use proxy (URL http://user:pass@ip:port or JSON)
list_proxiesLists all IPs assigned to your service (simple or detailed)
proxy_statusService status: plan, IP count, ports, auth type
check_proxyChecks connectivity and anonymity through the proxy

All tools are read-only over your own service. The API key identifies your service: no service ID configuration needed.

Installation

Download the binary for your platform from the latest release. On Linux/macOS:

# Linux (amd64) — swap the suffix for your platform:
# proxy-mcp-linux-arm64 · proxy-mcp-darwin-amd64 · proxy-mcp-darwin-arm64 · proxy-mcp-windows-amd64.exe
curl -L -o proxy-mcp https://github.com/juliobrasa/proxyseo-mcp/releases/latest/download/proxy-mcp-linux-amd64
chmod +x proxy-mcp
sudo mv proxy-mcp /usr/local/bin/proxy-mcp

Generate your API key from the ProxySEO client panel ("AI agent access" section). It is shown only once: store it in a password manager.

Claude Desktop / Claude Code configuration

Add to your claude_desktop_config.json (Desktop) or .mcp.json (Claude Code):

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment variables

VariableRequiredDefaultDescription
PROXYSEO_API_KEYYes—Your service API key (64 hex characters)
PROXYSEO_API_URLNohttps://api.proxyseo.esAPI base URL

Usage example

In Claude, just ask:

"Give me a proxy URL to use with curl"

Claude will call get_proxy and return something like:

http://user:password@185.x.x.x:58542

"How many IPs does my service have and are they working?"

Claude will combine proxy_status and check_proxy.

Troubleshooting

SymptomCauseFix
ERROR: PROXYSEO_API_KEY environment variable is requiredMissing variableAdd it to the env block of your MCP config
unauthorized: invalid or revoked API keyWrong or revoked keyVerify the key; request a new one if revoked
rate limit exceeded (60 req/min)Too many callsWait 1 minute; the limit is per key
service not found or inactiveService suspended/cancelledCheck your service status in the panel
Server not showing up in ClaudeWrong binary pathUse an absolute path in command and restart Claude

Build from source

make mcp   # produces bin/proxy-mcp (linux-amd64) and bin/proxy-mcp-darwin-arm64
Ver o original no GitHub

Bom para

Relacionados