Instalación de MCP Server + HIN (VPN SSL)

Esta guía detalla el proceso para instalar un Hubeet MCP SQL Server junto con un Hubeet Integration Node (HIN), configurando un túnel seguro hacia una base de datos protegida por una VPN SSL.

Estructura Recomendada

Para mantener el orden, se sugiere utilizar la siguiente ruta en su servidor: ~/_repo/hubeet-integration-node/

Aquí se alojarán los archivos de configuración de Docker, el archivo de variables de entorno y el binario del HIN.

---

Paso 1: Configuración de Docker Compose

1. Cree una carpeta para contener los archivos de configuración.
2. Cree un archivo docker-compose.yml con el siguiente contenido:

services:
  # 1. El contenedor de la VPN (Dueño de la red)
  vpn_ssl:
    build: .
    container_name: vpn_ssl
    privileged: true
    restart: always
    ports:
      - "${PORT:-3001}:${PORT:-3001}"
    volumes:
      - ./config:/etc/openfortivpn/config

  # 2. Tu aplicación (Cliente de la red)
  hubeet-mcp-sqlserver:
    image: devopssolunika/hubeet-mcp-sqlserver:latest
    container_name: hubeet-mcp-sqlserver
    # Esto hace que la app "viva" dentro de la red de la VPN
    network_mode: service:vpn_ssl
    restart: unless-stopped
    environment:
      - PORT=${PORT:-3001}
      - NODE_ENV=${NODE_ENV:-development}
      - BEARER_TOKEN=${BEARER_TOKEN:-dev-token-change-me}
      - ENABLE_TEST_UI=${ENABLE_TEST_UI:-true}
      - ALLOWED_ORIGINS=${ALLOWED_ORIGINS:-*}
    volumes:
      - hubeet-mcp-sqlserver_data:/app/packages/mcp-sqlserver/dynamic_tools
    depends_on:
      - vpn_ssl
    healthcheck:
      test: [ "CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3001/health" ]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

volumes:
  hubeet-mcp-sqlserver_data:
    driver: local

Configuración de la VPN

El archivo config/ debe contener los parámetros de conexión de su VPN SSL:

### Archivo: config ###
host = [ip del servidor]
port = [puerto de la vpn]
username = [usuario de la vpn]
password = [contraseña de la vpn]
trusted-cert = [certificado de la vpn]

---

Paso 2: Despliegue de Contenedores

Para levantar los servicios, ejecute el siguiente comando en la terminal:

docker-compose up -d

Este comando descargará las imágenes necesarias y levantará el túnel VPN junto con el servidor MCP de SQL Server. Asegúrese de tener un archivo .env con las variables necesarias si decide personalizarlas.

---

Paso 3: Instalación del Hubeet Integration Node (HIN)

Una vez que los contenedores estén en ejecución, proceda a instalar el HIN:

1. Descarga: Si está en un entorno Linux, descargue el binario:

   wget https://cdn.hubeet.com/hin/builds/vx.x.x/hubeet-integration-node-linux.bin

2. Permisos de ejecución:

   chmod +x hubeet-integration-node-linux.bin

3. Ejecución:

   ./hubeet-integration-node-linux.bin

Durante la ejecución, el sistema le solicitará la API Key de Hubeet. Esta debe ser creada previamente desde la plataforma.

[!NOTE] Para obtener instrucciones sobre cómo generar su API Key, consulte la documentación oficial de Hubeet.

---

Verificación

Una vez completados estos pasos, el HIN estará conectado a la plataforma Hubeet y el servidor MCP tendrá acceso a la base de datos a través del túnel VPN gestionado por Docker.