Google Cloud Run

Google Cloud Run

Deploy code to Google Cloud Run

469
Stars
78
Forks
5
Releases

Overview

Cloud Run MCP server enables MCP-compatible AI agents to deploy apps to Google Cloud Run. This repository hosts an MCP server that can be configured in MCP clients (e.g., cloud-run with command npx and args -y @google-cloud/cloud-run-mcp). The server supports deployment from Gemini CLI, AI-powered IDEs, agent SDKs, and other MCP-enabled tools. It provides tooling to manage Cloud Run services, including deploy-file-contents (deploys files by content), list-services, get-service, get-service-log, deploy-local-folder (deploys a local folder), list-projects, and create-project. A recommended workflow is to run locally with Node.js or to deploy the server to Cloud Run with IAM-protected remote access. The remote setup uses gcloud auth, gcloud config, and gcloud run deploy to launch cloud-run-mcp with the image, plus optional environment variables. Documentation also covers prompts for common tasks (deploy, logs) and steps to install the Gemini CLI extension and configure MCP clients such as Windsurf, VSCode, Claude Desktop, and Cursor. IAM authentication is required for remote access to secure the deployment surface.

Details

Owner
GoogleCloudPlatform
Language
JavaScript
License
Apache License 2.0
Updated
2025-12-07

Features

Deploy files by contents

Deploys files to a Cloud Run service by providing their contents directly (deploy-file-contents).

List Cloud Run services

Lists Cloud Run services in a given project and region (list-services).

Get service details

Fetches details for a specific Cloud Run service (get-service).

Get service logs

Retrieves logs and error messages for a Cloud Run service (get-service-log).

Deploy local folder

Deploys a local folder to a Cloud Run service (deploy-local-folder).

List projects

Lists available Google Cloud projects to target for deployment (list-projects).

Create project

Creates a new Google Cloud project and attaches it to the first available billing account (create-project).

Remote deployment with IAM authentication

Deploys the MCP server to Cloud Run with IAM-based authentication to secure remote usage.

Audience

AI developersUse MCP to deploy apps to Cloud Run from Gemini and MCP clients.
Cloud engineersHost and manage the MCP server to enable Cloud Run deployments.
MCP clientsConfigure client tooling to deploy via the Cloud Run MCP server.

Tags

cloud-runmcpcloud-run-mcpgemini-cli-extensiondeploymentgoogle-cloud-runnodejsdockeriam-authenticationai-agents