MCPgee
MCPgee
MCPgeeMCPgee

Cloud Run

v1.0.0•Cloud Services•stable

MCP server to deploy apps to Cloud Run

google-cloudgoogle-cloud-runmcpmcp-server
Share:
609
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Cloud Run?

Cloud Run is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server to deploy apps to cloud run

MCP server to deploy apps to Cloud Run

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server to deploy apps to Cloud Run

Use Cases

Deploy applications to Google Cloud Run directly from AI agents. Manage serverless container deployments through natural language. Enable rapid deployment workflows for serverless applications.
GoogleCloudPlatform

Maintainer

LicenseApache-2.0
Languagejavascript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx cloud-run

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Cloud Run

The Cloud Run MCP server is an official Google Cloud tool that lets AI assistants deploy, manage, and troubleshoot applications on Google Cloud Run directly through natural language. It exposes tools for deploying code (either from local file contents or a local folder), listing and inspecting Cloud Run services, and fetching service logs — all without leaving your AI client. Developers can use it to go from writing code to a live serverless deployment in a single conversation, making it ideal for rapid prototyping and AI-assisted DevOps workflows.

Prerequisites

  • Node.js 18 or later installed
  • Google Cloud SDK (gcloud CLI) installed and authenticated with 'gcloud auth application-default login'
  • A Google Cloud project with the Cloud Run API enabled
  • An MCP-compatible client such as Claude Desktop, Cursor, or Gemini CLI
  • Appropriate IAM permissions: Cloud Run Admin and Service Account User on your project
1

Authenticate with Google Cloud

Authenticate the gcloud CLI so the MCP server can use your credentials to deploy and manage Cloud Run services.

gcloud auth application-default login
gcloud config set project YOUR_PROJECT_ID
2

Enable the Cloud Run API

Ensure Cloud Run is enabled in your target Google Cloud project.

gcloud services enable run.googleapis.com
3

Configure environment variables

Set optional environment variables to avoid repeating your project and region in every AI prompt. These can also be set in the MCP client config.

export GOOGLE_CLOUD_PROJECT=your-project-id
export GOOGLE_CLOUD_REGION=us-central1
4

Add the server to your MCP client config

Register the Cloud Run MCP server in your client configuration using the official npm package.

5

Test by listing services

Ask your AI assistant to list your Cloud Run services to verify the integration is working correctly.

Cloud Run Examples

Client configuration

Add this block to your claude_desktop_config.json. Pass GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_REGION to avoid specifying them in every prompt.

{
  "mcpServers": {
    "cloud-run": {
      "command": "npx",
      "args": ["-y", "@google-cloud/cloud-run-mcp"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "your-project-id",
        "GOOGLE_CLOUD_REGION": "us-central1"
      }
    }
  }
}

Prompts to try

These prompts use the deploy-file-contents, list-services, get-service, and get-service-log tools.

- "Deploy the code in my current directory to Cloud Run as a service named 'my-api'."
- "List all Cloud Run services in my project and show their URLs."
- "Get the last 50 log lines for my Cloud Run service named 'my-api' and identify any errors."
- "What is the current status and latest revision of my 'my-api' Cloud Run service?"
- "Create a new GCP project called 'staging-env' and deploy this app to it."

Troubleshooting Cloud Run

Deployment fails with PERMISSION_DENIED

Your authenticated account needs the 'Cloud Run Admin' and 'Service Account User' IAM roles on the target project. Run 'gcloud projects add-iam-policy-binding YOUR_PROJECT --member=user:[email protected] --role=roles/run.admin' and the equivalent for Service Account User.

GOOGLE_CLOUD_PROJECT is not set and every request asks for a project

Set GOOGLE_CLOUD_PROJECT in the env block of your MCP client config (as shown above) or run 'gcloud config set project YOUR_PROJECT_ID' in your shell before starting the client.

deploy-local-folder tool is not available

The deploy-local-folder, list-projects, and create-project tools are only available when running the server in local mode (not remote/Cloud Run hosted mode). Make sure you are using the local npx command, not a remotely hosted instance.

Frequently Asked Questions about Cloud Run

What is Cloud Run?

Cloud Run is a Model Context Protocol (MCP) server that mcp server to deploy apps to cloud run It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Cloud Run?

Follow the installation instructions on the Cloud Run GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Cloud Run?

Cloud Run works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Cloud Run free to use?

Yes, Cloud Run is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Cloud Run Alternatives — Similar Cloud Services Servers

Looking for alternatives to Cloud Run? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.

Open WebUI

★ 138.2k

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

Anything LLM

★ 60.4k

The all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.

LocalAI

★ 46.4k

LocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.

Nacos

★ 33.0k

an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.

Xiaozhi ESP32

★ 26.7k

本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.

Gateway

★ 11.8k

A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Cloud ServicesBrowse All Servers

Quick Config Preview

{ "mcpServers": { "cloud-run": { "command": "npx", "args": ["-y", "cloud-run"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Cloud Run?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides