mcp-server-vyos

Servidor MCP para la gestión de routers VyOS a través de la API REST HTTPS. Proporciona tanto herramientas de gestión de routers como consulta de documentación de VyOS en tiempo real.

Instalación

pip install mcp-server-vyos

Configuración

Establezca las variables de entorno:

• VYOS_URL — Punto final de la API del router (ej. https://vyos.example.com)

• VYOS_API_KEY — Clave de API para la autenticación

• VYOS_READ_ONLY — Establecer en true para deshabilitar todas las herramientas de mutación (cambios de configuración, reinicio, apagado, etc.)

Configuración del router VyOS

Habilite la API HTTPS en su router VyOS:

configure
set service https api keys id my-mcp-key key <your-api-key>
set service https api rest
commit
save

Claude Code

Añada a la configuración de su cliente MCP:

{
  "mcpServers": {
    "vyos": {
      "command": "mcp-server-vyos",
      "env": {
        "VYOS_URL": "https://vyos.example.com",
        "VYOS_API_KEY": "your-api-key"
      }
    }
  }
}

Modo de solo lectura

Para un acceso seguro y de solo consulta (monitoreo, investigación, consulta de documentación), habilite el modo de solo lectura:

{
  "mcpServers": {
    "vyos": {
      "command": "mcp-server-vyos",
      "env": {
        "VYOS_URL": "https://vyos.example.com",
        "VYOS_API_KEY": "your-api-key",
        "VYOS_READ_ONLY": "true"
      }
    }
  }
}

Esto registra solo las herramientas que no realizan mutaciones: vyos_info, vyos_retrieve, vyos_return_values, vyos_exists, vyos_config_diff, vyos_show, vyos_docs_search y vyos_docs_read.

Herramientas

Gestión de routers

Documentación

La documentación se obtiene en tiempo real desde el repositorio vyos-documentation, por lo que se mantiene sincronizada con las últimas versiones de VyOS. Los resultados se almacenan en caché durante 1 hora.

Seguridad

• Los cambios de configuración utilizan commit-confirm de forma predeterminada: los cambios se revierten automáticamente después de 5 minutos a menos que se confirmen con vyos_confirm

• Las operaciones destructivas (vyos_reboot, vyos_poweroff, vyos_image_delete) incluyen descripciones de advertencia

• Las claves de API nunca se registran ni se incluyen en los resultados de las herramientas

• Los certificados TLS autofirmados se aceptan de forma predeterminada (común en VyOS)

Desarrollo

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest
ruff check .

Licencia

MIT