☁️ 🚀 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

代码仓库

关于 ☁️ 🚀 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

基本信息

分类

开发工具

许可证

Apache-2.0 license

运行时

python

传输方式

stdio

发布者

jackwotherspoon

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.