MCP server per desplegar codi a Google Cloud Run

Activa agents d'IA compatibles amb MCP per desplegar aplicacions a Cloud Run.

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

Desplega des d'IDE impulsats per IA:

Desplega des d'aplicacions d'assistents IA:

Desplega des de SDK d'agents, com el Google Gen AI SDK o el Agent Development Kit.

[!NOTE]
Aquest és el repositori d'un servidor MCP per desplegar codi a Cloud Run. Per aprendre a host servidors MCP a Cloud Run, visita la documentació de Cloud Run: Cloud Run documentation.

Eines

• deploy-file-contents: Desplega fitxers a Cloud Run proporcionant directament els seus continguts.
• list-services: Llista els serveis de Cloud Run en un projecte i regió donats.
• get-service: Obté detalls d'un servei específic de Cloud Run.
• get-service-log: Obté registres i missatges d'error d'un servei específic de Cloud Run.
• deploy-local-files*: Desplega fitxers del sistema de fitxers local a un servei de Google Cloud Run.
• deploy-local-folder*: Desplega una carpeta local a un servei de Google Cloud Run.
• list-projects*: Llista els projectes GCP disponibles.
• create-project*: Crea un nou projecte GCP i l'adjunta al primer compte de facturació disponible. Es pot especificar opcionalment un ID de projecte.

* només disponible quan s'executa localment

Ús com a servidor MCP local

Executa el servidor MCP de Cloud Run a la teva màquina local utilitzant credencials locals de Google Cloud. Aquesta opció és ideal si utilitzes un IDE assistit per IA (p. ex. Cursor) o una aplicació d'IA de taulell (p. ex. Claude).

0. Instal·la Node.js (es recomana la versió LTS).

1. Instal·la el Google Cloud SDK i autentica't amb el teu compte Google.

2. Inicia sessió al teu compte Google Cloud amb la comanda:

   gcloud auth login
   

3. Configura les credencials d'aplicació amb la comanda:

   gcloud auth application-default login
   

4. Actualitza el fitxer de configuració MCP del teu client amb el següent contingut:

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

Ús com a servidor MCP remot

[!WARNING]
No utilitzis el servidor MCP remot sense autenticació. En les instruccions següents, utilitzarem l'autenticació IAM per protegir la connexió al servidor MCP des de la teva màquina local. Això és important per evitar l'accés no autoritzat als teus recursos de Google Cloud.

Executa el servidor MCP de Cloud Run a Cloud Run amb connexió des de la teva màquina local autenticada via IAM. Amb aquesta opció, només podràs desplegar codi al mateix projecte de Google Cloud on s'executa el servidor MCP.

1. Instal·la el Google Cloud SDK i autentica't amb el teu compte Google.

2. Inicia sessió al teu compte Google Cloud amb la comanda:

   gcloud auth login
   

3. Estableix l'ID del projecte Google Cloud amb la comanda:

   gcloud config set project YOUR_PROJECT_ID
   

4. Desplega el servidor MCP de Cloud Run a Cloud Run:

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

   Quan se't demani, tria una regió, per exemple europe-west1.

   Nota: el servidor MCP no és públicament accessible; requereix autenticació via IAM.

5. Executa un proxy de Cloud Run a la teva màquina local per connectar-te de forma segura amb la teva identitat al servidor MCP remot:

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

   Això crearà un proxy local al port 3000 que redirigeix les peticions al servidor MCP remot i injeta la teva identitat.

6. Actualitza el fitxer de configuració MCP del teu client amb el següent contingut:

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

   Si el teu client MCP no suporta l'atribut url, pots utilitzar mcp-remote:

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