Cloud Run MCP Server enables MCP-compatible AI agents to deploy applications to Google Cloud Run, Google's fully managed container platform. It integrates with Gemini CLI, AI-powered IDEs like Cursor and VS Code, and agent development frameworks. Key capabilities: - Deploy code directly to Cloud Run by providing file contents or from local folders - Manage Cloud Run services including listing services, retrieving service details, and viewing logs - Manage Google Cloud Platform projects with support for listing and creating new projects with billing account integration - Works with Gemini CLI, Google Gen AI SDK, and Agent Development Kit for automated deployment workflows

Cloud Run MCP server and Gemini CLI extension

Enable MCP-compatible AI agents to deploy apps to Cloud Run.

"mcpServers":{
  "cloud-run": {
    "command": "npx",
    "args": ["-y", "@google-cloud/cloud-run-mcp"]
  }
}

Deploy from Gemini CLI and other AI-powered CLI agents:

Deploy from AI-powered IDEs:

Deploy from AI assistant apps:

Deploy from agent SDKs, like the Google Gen AI SDK or Agent Development Kit.

> [!NOTE] > This is the repository of an MCP server to deploy code to Cloud Run, to learn how to host MCP servers on Cloud Run, visit the Cloud Run documentation.

Tools

_\* only available when running locally_

Prompts

Prompts are natural language commands that can be used to perform common tasks. They are shortcuts for executing tool calls with pre-filled arguments.

Environment Variables

The Cloud Run MCP server can be configured using the following environment variables:

| Variable | Description | | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GOOGLE_CLOUD_PROJECT | The default project ID to use for Cloud Run services. | | GOOGLE_CLOUD_REGION | The default region to use for Cloud Run services. | | DEFAULT_SERVICE_NAME | The default service name to use for Cloud Run services. | | SKIP_IAM_CHECK | Controls whether to check for IAM permissions for a Cloud Run service. Set to false to enable checks. This is true by default which is a recommended way to make the service public. | | ENABLE_HOST_VALIDATION | Prevents DNS Rebinding attacks by validating the Host header. This is disabled by default. | | ALLOWED_HOSTS | Comma-separated list of allowed Host headers (if host validation is enabled). The default value is localhost,127.0.0.1,::1. |

Use as a Gemini CLI extension

To install this as a Gemini CLI extension, run the following command:

2. Install the extension:

   gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp
   

3. Log in to your Google Cloud account using the command:

   gcloud auth login
   

4. Set up application credentials using the command:

   gcloud auth application-default login
   

Use in MCP Clients

Learn how to configure your MCP client

Most MCP clients require a configuration file to be created or modified to add the MCP server.

The configuration file syntax can be different across c