MCP server to deploy code to Google Cloud Run

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

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

Tools

• deploy-file-contents: Deploys files to Cloud Run by providing their contents directly.
• list-services: Lists Cloud Run services in a given project and region.
• get-service: Gets details for a specific Cloud Run service.
• get-service-log: Gets Logs and Error Messages for a specific Cloud Run service.
• deploy-local-files: Deploys files from the local file system to a Google Cloud Run service.
• deploy-local-folder: Deploys a local folder to a Google Cloud Run service.
• list-projects: Lists available GCP projects.
• create-project: Creates a new GCP project and attach it to the first available billing account.

Use as local MCP server

Run the Cloud Run MCP server on your local machine using local Google Cloud credentials. This is best if you are using an AI-assisted IDE (e.g. Cursor) or a desktop AI application (e.g. Claude).

1. Install Node.js (LTS version recommended).
2. Install the Google Cloud SDK and authenticate with your Google account.
3. Log in to your Google Cloud account using the command:

gcloud auth login

4. Set up application credentials using the command:
   ```bash
gcloud auth application-default login

5. Update the MCP configuration file of your MCP client with the following:

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

## Use as remote MCP server
> [!WARNING]
> Do not use the remote MCP server without authentication. In the following instructions, we will use IAM authentication to secure the connection to the MCP server from your local machine.

1. Install the [Google Cloud SDK](https://cloud.google.com/sdk/docs/install) and authenticate with your Google account.
2. Log in to your Google Cloud account using the command:
   ```bash
gcloud auth login

3. Set your Google Cloud project ID using the command:

gcloud config set project YOUR_PROJECT_ID

4. Deploy the Cloud Run MCP server to Cloud Run:
   ```bash
gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated

5. [Optional] Add default configurations:

gcloud run services update cloud-run-mcp --region=REGION --update-env-vars GOOGLE_CLOUD_PROJECT=PROJECT_NAME,GOOGLE_CLOUD_REGION=PROJECT_REGION,DEFAULT_SERVICE_NAME=SERVICE_NAME,SKIP_IAM_CHECK=false

6. Run a Cloud Run proxy on your local machine to connect securely using your identity to the remote MCP server running on Cloud Run:
   ```bash
gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID

7. Update the MCP configuration file of your MCP client with the following:

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