ipvolt Proxy Toolkit

npx add-mcp 'https://mcp.ipvolt.com/mcp'

ipvolt Proxy Toolkit

Un servidor MCP para encontrar documentación revisada sobre proxies, generar ejemplos de configuración probados y diagnosticar fallos estructurados de proxies. Las herramientas públicas se ejecutan localmente contra un catálogo incluido. No necesitan una clave API ni acceso a una cuenta de proxy de ipvolt.

El toolkit es independiente del servicio de proxy comercial de ipvolt, que aún no está abierto. No aprovisiona proxies, compra tráfico, accede a datos de cuenta ni configura la ruta de red de otro agente.

Disponibilidad

La versión publicada en npm 0.1.0 y el servicio público alojado proporcionan cuatro herramientas que utilizan un catálogo público incluido. Consulta el estado de lanzamiento para verificar la disponibilidad de npm, el endpoint alojado y los listados de registros. Las compilaciones desde el código fuente funcionan independientemente de esos canales de distribución. Los metadatos del registro en server.json describen la versión prevista y no son evidencia de que un canal esté activo.

Herramientas

Herramienta	Qué hace	Disponibilidad
search_proxy_docs	Busca guías y artículos revisados; devuelve enlaces canónicos, extractos y una revisión de contenido.	Alojada y local
get_proxy_doc	Recupera un documento o sección con nombre en fragmentos limitados, con cursores de continuación vinculados a la revisión.	Alojada y local
generate_proxy_config	Devuelve una plantilla HTTPS GET de versión exacta con marcadores de entorno local. No ejecuta código.	Alojada y local
diagnose_proxy_error	Interpreta observaciones estructuradas como CONNECT407, fallo TLS o un tiempo de espera ambiguo; indica incertidumbre y límites de reintento.	Alojada y local
check_proxy_route	Realiza una solicitud limitada a través de un proxy local configurado explícitamente hacia el endpoint de eco fijo de ipvolt.	Local, habilitada explícitamente

Por ejemplo, busca con {"query":"curl proxy","topic":"setup"}, luego recupera {"documentId":"/guides/curl-proxy-setup"}. Genera un ejemplo HTTPX síncrono con {"client":"httpx","version":"0.28.1"}. Diagnostica un fallo de autenticación de proxy con {"client":"httpx","version":"0.28.1","phase":"proxy_connect","status":407}. Una observación 407 apunta a la autenticación del proxy; no establece si la causa es una contraseña, el estado de la cuenta o una política de acceso.

Usa consultas de temas cortos y observaciones estructuradas. Proporciona credenciales solo a través de tu entorno local cuando ejecutes un ejemplo generado o habilites el diagnóstico local. Nunca envíes credenciales, URLs privadas ni registros sin procesar como argumentos de herramientas.

Compilar y conectar localmente

Requiere Node.js 24 o superior y npm. Desde el directorio del repositorio:

npm ci
npm run build
npm run check:content
node dist/transports/stdio.js --version

Para un cliente que acepte una configuración mcpServers, usa una ruta absoluta al punto de entrada compilado:

{
  "mcpServers": {
    "ipvolt": {
      "command": "node",
      "args": ["/absolute/path/to/proxy-toolkit-mcp/dist/transports/stdio.js"]
    }
  }
}

El servidor local predeterminado expone cuatro herramientas, no envía telemetría y no realiza solicitudes de red. Un cliente puede enviar resultados de herramientas a su propio proveedor de modelos. El servidor no puede controlar el manejo de datos de ese cliente.

Para la distribución npm, usa la versión fijada del paquete después de confirmar su disponibilidad en el estado de lanzamiento:

{
  "mcpServers": {
    "ipvolt": {
      "command": "npx",
      "args": ["--yes", "@ipvolt/proxy-toolkit-mcp@0.1.0"]
    }
  }
}

Los resultados exactos de aplicaciones y protocolos reales se registran en compatibilidad de clientes.

Ejemplos de configuración probados

Cliente	Versión	Interfaz probada
curl	8.22.0	Línea de comandos, macOS/OpenSSL
Requests	2.34.2	Session, Python 3.14.7
HTTPX	0.28.1	Client síncrono, Python 3.14.7
Playwright	1.63.0	APIRequestContext, Node 24.20.0

Las plantillas usan un proxy HTTP con HTTPS CONNECT, verifican TLS del destino, deshabilitan redirecciones y reintentos automáticos, e imprimen el estado o una categoría de fallo limitada. El destino y el proxy permanecen como variables locales TARGET_URL y PROXY_URL. Los tiempos de espera de Requests y HTTPX son presupuestos de fase/inactividad; no son plazos totales de trabajo. El ejemplo de Playwright usa su API de solicitudes, almacena la respuesta en búfer y está pensado para objetivos de diagnóstico pequeños. No configura la navegación del navegador.

La matriz exacta se ejecutó contra proxies autenticados controlados y orígenes HTTPS. Consulta método de fixtures y evidencia. No se afirma que se hayan probado otras versiones, protocolos de proxy ni plataformas. Revisa el código generado antes de ejecutarlo contra un destino autorizado.

Diagnóstico de ruta local opcional

Establece IPVOLT_ENABLE_ROUTE_CHECK=1 y proporciona el IPVOLT_PROXY_URL privado a través del entorno secreto local de tu cliente MCP. Invoca check_proxy_route con {"profile":"default"}. La herramienta no acepta URL de proxy, credencial ni argumento de destino. Habilitarla no realiza ninguna solicitud hasta que se llama a la herramienta.

La comprobación usa un proxy HTTP CONNECT y TLS de destino verificado para solicitar solo https://mcp.ipvolt.com/egress, con un nonce aleatorio. Tiene un plazo total de diez segundos, sin redirección ni respaldo directo, una solicitud activa, encabezados/cuerpo limitados y limpieza de cancelación. La conexión HTTP al proxy no está cifrada; la autenticación de proxy HTTP puede observarse en ese primer salto. Usa una red de confianza o un túnel local adecuado a tu configuración.

El éxito informa la dirección de salida vista por esa única solicitud de eco. No prueba anonimato, país, tipo de proxy, propiedad ni el enrutamiento de un navegador, shell, SDK u otra herramienta de agente. Consume una pequeña cantidad de ancho de banda del proxy. El servicio de eco recibe la dirección de salida de la solicitud; el registro de acceso de la aplicación está deshabilitado. Se rechazan los ajustes de depuración/TLS del diagnóstico que podrían exponer credenciales o debilitar la verificación.

El diagnóstico requiere que el servicio de eco alojado esté disponible. Consulta el estado de lanzamiento antes de habilitarlo. Las comprobaciones de fixtures controlados no afirman una solicitud exitosa a través de un proveedor en vivo.

Servicio alojado

La URL pública remota es https://mcp.ipvolt.com/mcp, usando Streamable HTTP. Selecciona ese transporte en tu cliente MCP e ingresa la URL. HTTPS público, las cuatro herramientas en ambas versiones de protocolo compatibles y el endpoint de eco se verificaron el 14 de septiembre de 2026; consulta verificación alojada. Expone las cuatro herramientas públicas sin registro ni clave API. El diagnóstico de ruta local se omite y los intentos directos de llamarlo se rechazan. Este servicio no acepta configuración de proxy.

Para una instancia de desarrollo local:

IPVOLT_MCP_PUBLIC_URL=http://127.0.0.1:3040/mcp npm start

El proceso se vincula al loopback. La configuración de producción y el despliegue coordinado se documentan en instrucciones de despliegue. Los límites predeterminados son cuerpos de solicitud de 32 KiB, encabezados de 8 KiB, 16 solicitudes concurrentes y 120 solicitudes por minuto por dirección de par observada. Los orígenes exactos de navegador están en la lista de permitidos. Los encabezados de dirección de proxy inverso se confían solo con un proxy de loopback configurado explícitamente que los sobrescriba.

Las métricas alojadas contienen solo el nombre de la herramienta, estado de éxito/error, duración y versión del toolkit. Los argumentos de herramientas, cuerpos de resultados, credenciales y direcciones de salida no se registran. La limitación de velocidad retiene hashes de direcciones con clave temporales hasta 60 segundos; el uso local de stdio no se rastrea. Los endpoints de máquina usan noindex y permanecen separados de la analítica controlada por consentimiento del sitio web público.

Mantener y verificar

npm run typecheck
npm run build
npm test
npm run check:content
npm run check:manifest
npm run check:package
python3 -m unittest discover -s deploy -p 'test_*.py' -v

check:package inspecciona el tarball npm real, lo instala en un directorio de consumidor temporal y descubre/llama a las cuatro herramientas con las rutas de protocolo actual y heredada. check:content -- --live compara cada documento Markdown incluido con su exportación canónica pública; realiza solo esas lecturas públicas permitidas.

El runtime no rastrea el sitio web. Un mantenedor exporta solo los catálogos revisados públicos de guías/blogs desde una fuente de sitio web verificada usando scripts/export-content.ts, revisa el diff resultante y publica una nueva versión inmutable del paquete. Los borradores y las aplicaciones operativas privadas están fuera de esa lista de permitidos. Los valores SHA-256 del paquete y los documentos hacen observables los cambios de fuente.

El código tiene licencia MIT. El contenido editorial incluido tiene una licencia de contenido separada. El soporte pertenece al rastreador de problemas del repositorio; omite credenciales y registros privados de los informes.