vpn-bypass-mcp

vpn-bypass-mcp

vpn-bypass-mcp é um servidor MCP para VPN Bypass, o aplicativo da barra de menus do macOS que decide qual tráfego usa a VPN e qual o contorna. Um agente de IA o utiliza para ler o estado do aplicativo e alterar seu roteamento por meio do socket de controle local do aplicativo. Ele roda apenas no macOS.

Recursos

• 23 ferramentas, uma por ação do aplicativo: status, listas de domínios, serviços, modo de roteamento, rotas do kernel, atualização de DNS, o log e rotas e regras do modo Custom.
• Cada ferramenta retorna o JSON do próprio aplicativo inalterado, para que campos adicionados por versões mais novas cheguem ao agente.
• As descrições das ferramentas informam a um agente que nunca viu o aplicativo o que cada modo faz e mantêm as rotas do kernel separadas das rotas de saída do modo Custom.
• Dicas MCP em cada ferramenta (readOnlyHint, destructiveHint, idempotentHint), para que um cliente possa perguntar antes de uma chamada destrutiva.
• VPN_BYPASS_MCP_READ_ONLY=1 registra apenas as 8 ferramentas que não alteram nada.
• Erros que um agente pode tratar: o aplicativo não está em execução, o aplicativo é mais antigo que 4.9.0 (com sua versão quando ele a informa) ou o código de erro do próprio aplicativo.
• Uma senha de proxy viaja em um campo separado e nunca é retornada, ecoada ou registrada.
• Apenas stdio; o servidor não abre nenhuma porta de rede.

Início rápido

npx -y vpn-bypass-mcp --version

Em seguida, adicione o servidor ao seu cliente MCP (Claude Desktop, Cursor ou qualquer cliente que leia mcpServers):

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

O VPN Bypass deve estar aberto. As ferramentas de domínio, serviço, rota ativa, atualização e log exigem VPN Bypass 4.9.0 ou mais recente; status, set_mode e as ferramentas do modo Custom funcionam com versões mais antigas. Claude Code, os binários de lançamento e a compilação a partir do código-fonte estão em Introdução.

Documentação

A documentação completa está em geiserx.github.io/vpn-bypass-mcp.

• Introdução: requisitos, npm, binário de lançamento, código-fonte, primeira execução
• Configuração: variáveis de ambiente, modo somente leitura, tempos limite, segurança
• Uso: modos, os dois tipos de rota, cada ferramenta, erros
• Desenvolvimento: compilação, teste, lançamento
• Projetos relacionados: o aplicativo VPN Bypass, sua linha de comando vpnb e onde este servidor está listado

Projetos relacionados

VPN Bypass, o aplicativo, e seu Homebrew tap.

Licença

MIT