lokeyxwin/vps-server

¿Qué hace vps-server?

Gestión de activos VPS + automatización de salida proxy — Máquina de estados asíncrona en Python + conjunto de herramientas MCP (doble shell admin/user) + skill de agente complementario

Descripción

Este skill proporciona una solución completa para la gestión de servidores virtuales privados (VPS) y la automatización de túneles proxy de salida. Está diseñado para ser utilizado por agentes de IA (como Claude Code, Cursor, Codex) o por desarrolladores que necesiten administrar infraestructura de red de forma programática.

Características principales

• Gestión de activos VPS: Listado, creación, eliminación y monitoreo de servidores VPS.
• Automatización de proxies: Configuración y gestión de proxies de salida para enrutar tráfico a través de los VPS.
• Doble shell (admin/user): Permite operaciones administrativas (creación/eliminación de VPS) y operaciones de usuario (listado, verificación de estado).
• Máquina de estados asíncrona: Implementación robusta para manejar transiciones de estado y operaciones concurrentes.
• Integración MCP: Exposición de herramientas a través del Model Context Protocol para que los agentes de IA puedan interactuar directamente.

Herramientas MCP

list_servers

Lista todos los servidores VPS gestionados por el sistema.

Parámetros:

• filter (opcional): Filtro por estado o etiqueta.

Ejemplo:

{
  "servers": [
    {
      "id": "vps-001",
      "name": "proxy-eu-1",
      "ip": "203.0.113.10",
      "status": "running",
      "region": "eu-west"
    }
  ]
}

create_server

Crea un nuevo servidor VPS.

Parámetros:

• name: Nombre del servidor.
• region: Región del centro de datos.
• plan: Plan de recursos (CPU, RAM, almacenamiento).

Ejemplo:

mcp call create_server --name "proxy-us-2" --region "us-east" --plan "2vcpu-4gb"

delete_server

Elimina un servidor VPS existente (solo modo admin).

Parámetros:

• server_id: ID del servidor a eliminar.

check_status

Verifica el estado actual de un servidor o proxy.

Parámetros:

• target: ID del servidor o nombre del proxy.

Configuración

Para utilizar este skill, necesitas configurar las siguientes variables de entorno:

• VPS_API_KEY: Clave de API para autenticación con el proveedor de VPS.
• VPS_PROVIDER: Proveedor de VPS (por ejemplo, digitalocean, linode, vultr).
• MCP_ENDPOINT: Endpoint del servidor MCP (opcional, por defecto http://localhost:8080/mcp).

Uso con agentes de IA

Este skill está diseñado para ser cargado en agentes de IA como Claude Code, Cursor o Codex. Una vez cargado, el agente podrá ejecutar comandos como:

"Lista todos mis servidores VPS en la región de Europa" "Crea un nuevo proxy de salida en el servidor vps-002" "Verifica el estado del proxy principal"

Arquitectura

El sistema se compone de:

1. Capa de gestión VPS: Interactúa con las APIs de los proveedores de nube.
2. Capa de automatización de proxies: Configura túneles SSH, wireguard u otros protocolos.
3. Máquina de estados asíncrona: Maneja el ciclo de vida de servidores y proxies.
4. Interfaz MCP: Expone las funcionalidades como herramientas para agentes.

Licencia

MIT