Localcloud MCP

Entorno de nube local gratuito para que agentes de IA construyan, prueben y depuren aplicaciones de Google Cloud. CLI 0.1.9+. Sitio web: https://local.cloud/

Ver en local.cloudPrueba este MCPPatrocinado

Documentación

LocalCloud MCP para agentes de codificación con IA

Brinda a los agentes de codificación con IA un entorno de nube local gratuito para construir, probar y depurar aplicaciones de Google Cloud a través de MCP.

Fuente: https://local.cloud/docs/mcp/

LocalCloud le brinda a tu agente de codificación un entorno de nube local gratuito para construir, probar y depurar aplicaciones de Google Cloud. A través de MCP, el agente puede descubrir servicios locales, obtener configuración del SDK, inspeccionar recursos, consultar datos y diagnosticar fallos de aplicaciones. Tu aplicación utiliza los SDK estándar de Google Cloud apuntando al runtime local.

El puente MCP está incluido en LocalCloud CLI 0.1.9 y versiones posteriores. Docker ejecuta el entorno de nube en tu máquina; no se requiere un proyecto activo de Google Cloud para estos flujos de trabajo locales.

Instalar y conectar

En macOS, o Linux con Homebrew:

brew install LocalGCloud/tap/localcloud
lc --version
lc doctor
lc mcp install --client cursor

Para una instalación existente de Homebrew, ejecuta brew update y brew upgrade localcloud. Confirma que lc --version reporte 0.1.9 o una versión posterior.

En macOS o Linux sin Homebrew:

curl -fsSL https://local.cloud/install.sh | sh
localcloud --version
localcloud doctor
localcloud mcp install --client cursor

Recarga Cursor, habilita el servidor MCP localcloud y deja que se conecte. El puente inicia o reutiliza el runtime automáticamente. La primera conexión puede tardar más mientras se descarga la imagen del runtime. Para completar esa descarga y vincular deliberadamente los puertos del runtime recién iniciado a localhost primero, ejecuta:

lc start --local-only

Los lanzamientos de CLI firmados incluyen binarios para macOS ARM64/x86_64 y Linux ARM64/x86_64. Los binarios de macOS requieren macOS 13 o versiones posteriores; los binarios de Linux requieren glibc 2.35 o versiones posteriores. No se distribuyen binarios nativos para Windows; los usuarios de Windows necesitan un entorno Linux/WSL adecuado y una configuración de cliente compatible.

Versión del runtime y entornos existentes

Usa runtime 0.1.5 o versiones posteriores para esquemas validados de entrada y salida de herramientas de clientes estrictos. Las versiones de CLI y runtime son independientes; conectar MCP o actualizar la CLI reutiliza un contenedor existente.

Inspecciona lc status. Para actualizar deliberadamente el runtime seleccionado conservando su volumen de datos con nombre:

lc restart --image agentcloud/localcloud:0.1.5 --pull

Usa el mismo --data-volume y archivo de configuración si normalmente apuntas a un entorno personalizado. El reinicio interrumpe brevemente los clientes; vuelve a conectar después.

Los clientes que admiten extensiones de escritorio también pueden instalar el paquete LocalCloud MCP 0.1.9. El paquete incluye la CLI de plataformas compatibles; Docker y runtime 0.1.5+ siguen siendo necesarios.

Elige tu cliente de codificación

Cliente	Configuración
Cursor	`lc mcp install --client cursor`
Claude Code	`lc mcp install --client claude-code`
Claude Desktop	`lc mcp install --client claude-desktop`
Windsurf	`lc mcp install --client windsurf`
Antigravity	`lc mcp install --client antigravity`
Codex	`codex mcp add localcloud -- "$(command -v localcloud)" mcp`
VS Code / GitHub Copilot	Agrega el servidor stdio a `.vscode/mcp.json`, como se muestra a continuación
Cline	Agrega el servidor a través del editor de configuración MCP de Cline
Gemini CLI	`gemini mcp add --scope user localcloud "$(command -v localcloud)" mcp`

El alias --client gemini de CLI 0.1.9 apunta a Antigravity, no a Gemini CLI. Su opción --client all escribe las configuraciones de Cursor, Claude Code, Claude Desktop, Antigravity y Windsurf; usa las instrucciones manuales para Cline y Gemini CLI.

Para aplicaciones de escritorio, usa la ruta absoluta del ejecutable desde command -v localcloud. /opt/homebrew/bin/localcloud a continuación es un ejemplo de Homebrew en Apple Silicon. Fusiona la entrada en la configuración existente de tu cliente para que se conserven otros servidores MCP.

Cursor, Claude Desktop y Cline

Para un cliente que usa el formato mcpServers:

{
  "mcpServers": {
    "localcloud": {
      "command": "/opt/homebrew/bin/localcloud",
      "args": ["mcp"]
    }
  }
}

Usa el editor de configuración de Cline en lugar de asumir una ubicación de archivo de configuración de extensiones.

VS Code

VS Code usa servers en .vscode/mcp.json:

{
  "servers": {
    "localcloud": {
      "type": "stdio",
      "command": "/opt/homebrew/bin/localcloud",
      "args": ["mcp"]
    }
  }
}

Ejecuta MCP: List Servers en la Paleta de Comandos y luego inicia localcloud.

Dale a tu agente su primera tarea

Copia este prompt en tu cliente de codificación:

Usa el servidor MCP de LocalCloud. Lista los servicios locales, verifica la disponibilidad y obtén el entorno SDK para este proyecto. Verifica la compatibilidad antes de escribir una prueba de integración pequeña. Usa solo los endpoints locales devueltos. Detente si la operación requerida no está disponible; no solicites credenciales reales de Google Cloud ni recurras a Google Cloud real.

Las primeras llamadas son localcloud_list_services con {}, seguidas de disponibilidad y localcloud_get_env con {"format":"json"}. Los valores de endpoint generados tienen en cuenta los mapeos de puertos del runtime en ejecución.

Tarea	Flujo de trabajo del agente
Construir una función de almacenamiento y mensajería	Descubre Cloud Storage y Pub/Sub, configura los SDK, sube un objeto de prueba, publica un mensaje y verifica el resultado
Explorar datos locales	Navega por conjuntos de datos y tablas, inspecciona perfiles de conexión de bases de datos y ejecuta una consulta compatible
Escribir una prueba de integración	Lee la compatibilidad, crea solo recursos propiedad de la prueba, verifica resultados y limpia a través del SDK
Depurar un fallo	Inspecciona disponibilidad, registros, solicitudes recientes, configuración de endpoints y esquemas de API, luego vuelve a ejecutar la prueba que falla

Ejecuta el tutorial de MCP y tres flujos de trabajo de nube, o usa los ejemplos de SDK y la guía de Terraform. Los agentes también pueden leer el punto de entrada del agente y la guía de instalación legible por máquina.

Servicios, herramientas, recursos y prompts

El runtime proporciona inspección de servicios y proyectos, un catálogo de operaciones de API de gestión local, navegación de recursos, consultas de datos compatibles, configuración de SDK/gcloud/Terraform, verificaciones de compatibilidad, diagnósticos, recetas y prompts de prueba.

Lee los resultados de tools/list, resources/list, resources/templates/list y prompts/list del runtime conectado para conocer su catálogo real. Las versiones de CLI y runtime son independientes. Usa localcloud_get_api_catalog antes de localcloud_call_api en lugar de adivinar rutas de gestión.

El volumen de datos predeterminado se comparte entre clientes y repositorios. --project-id selecciona un proyecto lógico; elige un --data-volume separado cuando necesites un runtime independiente. Las operaciones del SDK pueden cambiar datos locales, por lo que las pruebas deben usar sus propios recursos y una limpieza explícita.

Las operaciones de gestión MCP de escritura y destructivas dependen de la configuración del runtime LOCALCLOUD_MCP_WRITE y LOCALCLOUD_MCP_DESTRUCTIVE, ambas deshabilitadas de forma predeterminada. Instalar una configuración de cliente no habilita esos privilegios. La compatibilidad local es específica de servicios y operaciones; valida el comportamiento de lanzamiento de la aplicación contra Google Cloud por separado.

Solución de problemas

Síntoma	Siguiente paso
`mcp install` no está disponible	Actualiza a CLI 0.1.9+ y confirma que el cliente inicia el ejecutable actualizado
El cliente rechaza un esquema de herramienta o resultado estructurado	Verifica la versión del runtime en ejecución; usa 0.1.5+ y vuelve a conectar después de una actualización explícita
Docker no está disponible	Ejecuta `lc doctor`, inicia Docker y vuelve a conectar
El cliente no puede encontrar el comando	Usa la ruta absoluta reportada por `command -v localcloud`
La primera conexión agota el tiempo	Ejecuta `lc start --local-only` una vez y luego vuelve a conectar; aumenta el tiempo de espera de inicio del cliente si es necesario
La conexión del runtime falla	Inspecciona `lc status` y `lc logs --tail 100`; prueba el argumento del puente `--connect-timeout 60`
Se rechaza una operación de escritura	Verifica su clasificación de seguridad y los permisos del runtime; no asumas que la instalación habilitó escrituras
Falta una herramienta o servicio	Verifica la imagen/versión del runtime, el catálogo descubierto, la disponibilidad y la compatibilidad

La referencia completa de MCP cubre la arquitectura del puente, banderas, contexto de llamador/proyecto, recursos y prompts. Revisa licencias y privacidad para el artefacto que instales. Para un informe de problema, incluye la versión de CLI, la imagen del runtime, el nombre del cliente y la salida de error saneada en un problema de CLI.