Cloud Run — MCP server for app deployment to GCP
Google Cloud's MCP server enables AI agents to deploy apps to Cloud Run directly from IDEs and assistants. Integrates with Claude Code, Cursor, GitHub Copilot, and other platforms.
no license updated 2026-10-29
Open on GitHubWhat Cloud Run does
The server exposes four core tools: deploying code from file contents, listing services, retrieving service details, and fetching logs. Built-in prompts—deploy and logs—provide shortcuts to common workflows. Running locally requires Google Cloud SDK and authentication via gcloud auth login and gcloud auth application-default login. Configure defaults through environment variables: GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_REGION, DEFAULT_SERVICE_NAME. Optional security: enable Host header validation with ENABLE_HOST_VALIDATION to mitigate DNS rebinding attacks.
What it helps with
- deploy code to Cloud Run from an IDE agent
- fetch logs and errors for a running service
- list or inspect Cloud Run services in a project
- manage Cloud Run resources via Gemini CLI
Example prompts for the agent
- Deploy the current directory to Cloud Run
- Show logs for the service named
api-service - List all Cloud Run services in my project
How to install Cloud Run
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cloud Run
How do I set up Cloud Run in Claude Code?
Claude Code doesn't expose MCP configuration through its UI. Use Cursor, Windsurf, Cline, or Gemini CLI instead. For Gemini CLI, run gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp.
What tools does the server provide?
Four main tools: deploy-file-contents, list-services, get-service, and get-service-log. When running locally, you also get deploy-local-folder, list-projects, and create-project.
What prerequisites are needed?
Install Google Cloud SDK and authenticate: run gcloud auth login and gcloud auth application-default login. For Node.js setup, use Node.js LTS. Docker is an alternative to run locally without Node.js installed.