vpn-bypass-mcp

vpn-bypass-mcp

vpn-bypass-mcp es un servidor MCP para VPN Bypass, la aplicación de la barra de menús de macOS que decide qué tráfico usa la VPN y cuál la evita. Un agente de IA lo utiliza para leer el estado de la aplicación y cambiar su enrutamiento a través del socket de control local de la aplicación. Solo funciona en macOS.

Características

• 23 herramientas, una por acción de la aplicación: estado, listas de dominios, servicios, modo de enrutamiento, rutas del kernel, actualización de DNS, el registro y rutas y reglas del modo personalizado.
• Cada herramienta devuelve el JSON propio de la aplicación sin cambios, de modo que los campos que añade una versión más reciente llegan al agente.
• Las descripciones de las herramientas indican a un agente que nunca ha visto la aplicación qué hace cada modo y mantienen separadas las rutas del kernel de las rutas de salida del modo personalizado.
• Sugerencias MCP en cada herramienta (readOnlyHint, destructiveHint, idempotentHint), para que un cliente pueda preguntar antes de una llamada destructiva.
• VPN_BYPASS_MCP_READ_ONLY=1 registra solo las 8 herramientas que no cambian nada.
• Errores sobre los que un agente puede actuar: la aplicación no está en ejecución, la aplicación es anterior a 4.9.0 (con su versión cuando la informa) o el código de error propio de la aplicación.
• Una contraseña de proxy viaja en un campo separado y nunca se devuelve, repite ni registra.
• Solo stdio; el servidor no abre ningún puerto de red.

Inicio rápido

npx -y vpn-bypass-mcp --version

Luego añade el servidor a tu cliente MCP (Claude Desktop, Cursor o cualquier cliente que lea mcpServers):

{
  "mcpServers": {
    "vpn-bypass": {
      "command": "npx",
      "args": ["-y", "vpn-bypass-mcp"]
    }
  }
}

VPN Bypass debe estar abierto. Las herramientas de dominio, servicio, ruta activa, actualización y registro requieren VPN Bypass 4.9.0 o posterior; status, set_mode y las herramientas del modo personalizado funcionan con versiones anteriores. Claude Code, los binarios de lanzamiento y la compilación desde el código fuente están en Getting started.

Documentación

La documentación completa está en geiserx.github.io/vpn-bypass-mcp.

• Getting started: requisitos, npm, binario de lanzamiento, código fuente, primera ejecución
• Configuration: variables de entorno, modo de solo lectura, tiempos de espera, seguridad
• Usage: modos, los dos tipos de ruta, cada herramienta, errores
• Development: compilación, pruebas, lanzamiento
• Related projects: la aplicación VPN Bypass, su línea de comandos vpnb y dónde se lista este servidor

Proyectos relacionados

VPN Bypass, la aplicación, y su Homebrew tap.

Licencia

MIT