Cloud Run MCP

🚀 MCP server to deploy code to Google Cloud Run

This project enables MCP-compatible AI agents to deploy applications to Google Cloud Run, streamlining the deployment process from various sources.

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

Deployment Sources

• AI-powered IDEs: Seamlessly deploy your applications directly from AI-assisted integrated development environments.
• AI assistant apps: Leverage the power of AI assistants to initiate deployments.
• Agent SDKs: Utilize SDKs such as the Google Gen AI SDK or Agent Development Kit for programmatic deployments.

⚠️ Important 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.

✨ Features

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.
• 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. A project ID can be optionally specified.

* only available when running locally

🚀 Quick Start

💻 Usage as a Local MCP Server

Run the Cloud Run MCP server on your local machine using local Google Cloud credentials. Ideal for AI-assisted IDEs (e.g., Cursor) or desktop AI applications (e.g., Claude).

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

   gcloud auth login
   

4. Set up Application Credentials:

   gcloud auth application-default login
   

5. Update MCP Configuration: 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"]
      }
   

💻 Usage as a Remote MCP Server

⚠️ Important Note

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. This is important to prevent unauthorized access to your Google Cloud resources.

1. Install and Authenticate Google Cloud SDK: Install the Google Cloud SDK and authenticate with your Google account.
2. Log in to Google Cloud:

   gcloud auth login
   

3. Set Google Cloud Project ID:

   gcloud config set project YOUR_PROJECT_ID
   

4. Deploy Cloud Run MCP Server:

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

   When prompted, pick a region, for example europe-west1. Note that the MCP server is not publicly accessible; it requires authentication via IAM.
5. Run Local Proxy:

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

   This will create a local proxy on port 3000 that forwards requests to the remote MCP server and injects your identity.
6. Update MCP Configuration: Update the MCP configuration file of your MCP client with the following:

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

   If your MCP client does not support the url attribute, you can use mcp-remote:

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