Servidor MCP para desplegar código en Google Cloud Run

Habilite agentes de IA compatibles con MCP para desplegar aplicaciones en Cloud Run.

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

Despliegue desde IDEs con AI:

Despliegue desde aplicaciones de asistentes de IA:

Despliegue desde SDKs de agentes, como el SDK de Google Gen AI o el Kit de Desarrollo de Agentes.

[NOTA]
Este es el repositorio de un servidor MCP para desplegar código en Cloud Run, para aprender cómo alojar servidores MCP en Cloud Run, visite la documentación de Cloud Run.

Herramientas

• desplegar-archivos-contenidos: Despliega archivos a Cloud Run proporcionando directamente su contenido.
• list-services: Lista los servicios de Cloud Run en un proyecto y región determinados.
• get-service: Obtiene detalles de un servicio específico de Cloud Run.
• get-service-log: Obtiene los registros y mensajes de error de un servicio específico de Cloud Run.
• deploy-local-files*: Despliega archivos desde el sistema de archivos local a un servicio de Google Cloud Run.
• deploy-local-folder*: Despliega una carpeta local en un servicio de Google Cloud Run.
• list-projects*: Lista los proyectos GCP disponibles.
• create-project*: Crea un nuevo proyecto GCP y lo adjunta a la primera cuenta de facturación disponible. Se puede especificar opcionalmente un ID de proyecto.

* sólo disponible cuando se ejecuta localmente

Utilizar como servidor MCP local

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

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

1. Instale el SDK de Google Cloud y autentifíquese con su cuenta de Google.

2. Accede a tu cuenta de Google Cloud usando el comando

   gcloud auth login

3. Configura las credenciales de la aplicación usando el comando

   gcloud auth application-default login

4. Actualiza el archivo de configuración 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

[ADVERTENCIA]
No utilice el servidor MCP remoto sin autenticación. En las siguientes instrucciones, utilizaremos autenticación IAM para asegurar la conexión al servidor MCP desde su máquina local. Esto es importante para evitar el acceso no autorizado a tus recursos de Google Cloud.

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

1. Instala el SDK de Google Cloud y autentica con tu cuenta de Google.

2. Accede a tu cuenta de Google Cloud utilizando el comando

   gcloud auth login

3. Establece el ID de tu proyecto de Google Cloud utilizando el 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 le solicite, elija una región, por ejemplo europe-west1.

   Tenga en cuenta que el servidor MCP no es de acceso público, sino que requiere autenticación a través de IAM.

5. Ejecute un proxy Cloud Run en su máquina local para conectarse de forma segura utilizando su identidad al servidor MCP remoto que se ejecuta en Cloud Run:

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

   Esto creará un proxy local en el puerto 3000 que reenviará las peticiones al servidor MCP remoto e inyectará su identidad.

6. Actualice el archivo de configuración MCP de su cliente MCP con lo siguiente:

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

   Si su cliente MCP no admite el atributo url, puede utilizar mcp-remote:

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