☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes

Name: ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes
Author: jackwotherspoon

@jackwotherspoon

Repository

About ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes

Deploy and host a remote MCP server on Cloud Run

#mcp #cloud-run #remote-mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-on-cloudrun": {
      "command": "uv",
      "args": [
        "run",
        "test_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes?

This project provides a quick-start template and guide to build a remote MCP server using FastMCP and deploy it to Google Cloud Run. It demonstrates how to run a Model Context Protocol server over the streamable-http (or sse) transport, making it centrally accessible, scalable, and secured with authentication. It is aimed at developers who want to move from local MCP servers to a remote, shareable infrastructure.

How to use ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes?

Clone the repository, set your Google Cloud project, and deploy the server with gcloud run deploy mcp-server --no-allow-unauthenticated --region=us-central1 --source .. After deployment, run gcloud run services proxy mcp-server --region=us-central1 to create an authenticated local tunnel. Test the connection using uv run test_server.py, which exercises the add and subtract tools.

Key features of ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes

Deploys a remote MCP server on Cloud Run with automatic scaling.
Enforces authentication via the --no-allow-unauthenticated flag and IAM roles.
Uses FastMCP for a fast, Pythonic server implementation.
Supports streamable-http transport (default) with sse as an option.
Includes two example math tools: add and subtract.
Provides a local proxy tunnel for secure client connections.

Use cases of ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes

Share a centralized MCP server across a team so everyone uses the same tools.
Run an MCP server remotely to eliminate local setup and maintenance for each developer.
Leverage Cloud Run’s scalability to handle variable request loads from AI assistants.
Secure an MCP server with authenticated requests to prevent public access.

FAQ from ☁️ 🚀 Build and Deploy a remote MCP server to Cloud Run in 5 minutes

What transports does this MCP server support?

It uses streamable-http by default, but you can switch to sse by changing the transport parameter in server.py to transport="sse".

How do I deploy the MCP server to Cloud Run?

You can deploy from source with gcloud run deploy mcp-server --no-allow-unauthenticated --region=us-central1 --source . or from a container image built via Cloud Build. Both options require the --no-allow-unauthenticated flag.

How do I authenticate MCP clients?

Use the Cloud Run proxy by running gcloud run services proxy mcp-server --region=us-central1. This creates an authenticated tunnel to your service. You must also ensure that the caller (or the proxy) has the roles/run.invoker IAM role.