lookerhost-mcp-server

Servidor MCP (Model Context Protocol) sobre la API de LookerHost. Permite que un agente (Claude u otro cliente MCP) cree y gestione infraestructura de la plataforma sin pasos manuales: VPS, Web Hosting (CloudPanel), apps PaaS desde un repo Git, bases de datos gestionadas y sitios WordPress.

Envuelve lookerhost-api (nunca Proxmox/Coolify directo), así hereda todo el plano de control de la plataforma: aislamiento multi-tenant, entitlements/cuotas por cuenta, rate-limits, auditoría y protección de VMs adoptadas.

Credencial

Usa una API key (lh_live_…) emitida por POST /api/auth/api-keys (portal del cliente). La llave queda atada a una cuenta (Customer) y a un set de scopes — el servidor MCP solo ve/opera los servicios de esa cuenta, y el backend rechaza con insufficient-scope lo que la llave no permita.

| Scope | Habilita | |---|---| | vps:read | listar servicios, detalle, métricas, catálogo, actividad | | vps:write | crear VPS y Web Hosting | | vps:power | start / stop / restart | | apps:write | desplegar apps, crear bases de datos y WordPress, redeploy | | service:delete | eliminar servicios (además la tool exige confirm: true) |

Instalación

Publicado en npm — no hace falta clonar nada:

{
  "mcpServers": {
    "lookerhost": {
      "command": "npx",
      "args": ["-y", "lookerhost-mcp-server"],
      "env": {
        "LOOKERHOST_API_URL": "https://api.lookerhost.com",
        "LOOKERHOST_API_KEY": "lh_live_..."
      }
    }
  }
}

O con Claude Code CLI:

claude mcp add lookerhost \
  -e LOOKERHOST_API_URL=https://api.lookerhost.com \
  -e LOOKERHOST_API_KEY=lh_live_... \
  -- npx -y lookerhost-mcp-server

La API key se emite en el dashboard de LookerHost: Settings → API keys (cuenta de cliente). El secreto se muestra una sola vez.

Desde el código (desarrollo)

pnpm install && pnpm build
# y en la config MCP: "command": "node", "args": ["/ruta/a/lookerhost-mcp/dist/index.js"]

Tools

Lectura — lookerhost_list_services, lookerhost_get_service, lookerhost_get_metrics, lookerhost_list_plans, lookerhost_get_activity, lookerhost_get_deploy_history

Creación — lookerhost_create_vps, lookerhost_create_webhosting, lookerhost_deploy_app, lookerhost_create_database, lookerhost_create_wordpress

Operación — lookerhost_power_service (resuelve VPS↔PaaS automáticamente y traduce restart→reboot en Proxmox), lookerhost_redeploy_app

Destrucción — lookerhost_delete_service (requiere confirm: true explícito además del scope service:delete; la plataforma rechaza VMs protegidas)

Las creaciones son asíncronas: responden provisioning y el agente debe sondear lookerhost_get_service hasta running (1–3 min típico).

Desarrollo

pnpm build && LOOKERHOST_API_URL=http://localhost:3001 LOOKERHOST_API_KEY=lh_live_... node dist/index.js
# inspector interactivo:
npx @modelcontextprotocol/inspector node dist/index.js