Servidor MCP para desplegar código en Google Cloud Run

Permite que los agentes de IA compatibles con MCP desplieguen aplicaciones en Cloud Run.

"mcpServers":{
  "cloud-run": {
    "command": "npx",
    "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
  }
}

Despliegue desde IDEs impulsados por IA:

Despliegue desde aplicaciones de asistente de IA:

Despliegue desde SDKs de agentes, como el Google Gen AI SDK o el Agent Development Kit.

[!NOTE]
Este es el repositorio de un servidor MCP para desplegar código en Cloud Run. Para aprender a alojar servidores MCP en Cloud Run, visita la documentación de Cloud Run.

Herramientas

• deploy-file-contents: Despliega archivos en Cloud Run proporcionando su contenido directamente.

• list-services: Enumera los servicios de Cloud Run en un proyecto y una región determinados.

• get-service: Obtiene los detalles de un servicio específico de Cloud Run.

• get-service-log: Obtiene los registros y los mensajes de error de un servicio específico de Cloud Run.

• deploy-local-files*: Despliega archivos del sistema de archivos local en un servicio de Google Cloud Run.

• deploy-local-folder*: Despliega una carpeta local en un servicio de Google Cloud Run.

• list-projects*: Enumera los proyectos de GCP disponibles.

• create-project*: Crea un nuevo proyecto de GCP y lo vincula a la primera cuenta de facturación disponible. Se puede especificar opcionalmente un ID de proyecto.

* solo disponible cuando se ejecuta localmente

Related MCP server: Cloud Run MCP Server

Uso como servidor MCP local

Ejecuta el servidor MCP de Cloud Run en tu máquina local utilizando las credenciales locales de Google Cloud. Esto es lo mejor si utilizas un IDE asistido por IA (p. ej., Cursor) o una aplicación de IA de escritorio (p. ej., Claude).

1. Instala Node.js (se recomienda la versión LTS).

2. Instala el Google Cloud SDK y autentícate con tu cuenta de Google.

3. Inicia sesión en tu cuenta de Google Cloud con el siguiente comando:

   gcloud auth login

4. Configura las credenciales de aplicación con el siguiente comando:

   gcloud auth application-default login

5. Actualiza el archivo de configuración de MCP de tu cliente MCP con lo siguiente:

      "cloud-run": {
        "command": "npx",
        "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
      }

Uso como servidor MCP remoto

[!WARNING]
No utilices el servidor MCP remoto sin autenticación. En las siguientes instrucciones, usaremos la autenticación de IAM para proteger la conexión al servidor MCP desde tu máquina local. Esto es importante para evitar el acceso no autorizado a tus recursos de Google Cloud.

Ejecuta el propio servidor MCP de Cloud Run en Cloud Run con la conexión desde tu máquina local autenticada mediante IAM. Con esta opción, solo podrás desplegar código en el mismo proyecto de Google Cloud donde se esté ejecutando el servidor MCP.

1. Instala el Google Cloud SDK y autentícate con tu cuenta de Google.

2. Inicia sesión en tu cuenta de Google Cloud con el siguiente comando:

   gcloud auth login

3. Establece el ID de tu proyecto de Google Cloud con el siguiente comando:

   gcloud config set project YOUR_PROJECT_ID

4. Despliega el servidor MCP de Cloud Run en Cloud Run:

   gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated

   Cuando se te solicite, elige una región, por ejemplo europe-west1.

   Ten en cuenta que el servidor MCP no es de acceso público; requiere autenticación mediante IAM.

5. Ejecuta un proxy de Cloud Run en tu máquina local para conectarte de forma segura con tu identidad al servidor MCP remoto que se ejecuta en Cloud Run:

   gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID

   Esto creará un proxy local en el puerto 3000 que reenvía las solicitudes al servidor MCP remoto e inyecta tu identidad.

6. Actualiza el archivo de configuración de MCP de tu cliente MCP con lo siguiente:

      "cloud-run": {
        "url": "http://localhost:3000/sse"
      }
   

   Si tu cliente MCP no admite el atributo url, puedes usar mcp-remote:

      "cloud-run": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "http://localhost:3000/sse"]
      }