MCP.so
Sign In

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

@jackwotherspoon

Basic information

Category

Developer Tools

License

Apache-2.0 license

Transports

stdio

Author

jackwotherspoon

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

Deploy and host a remote MCP server on Cloud Run

Build and Deploy a remote MCP server to Cloud Run in 5 minutes config

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

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

Build and Deploy a remote MCP server to Cloud Run in 5 minutes tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

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"`.

2

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.

3

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.

4

What are the prerequisites to get started?

You need Python 3.10+ (required by FastMCP), the Google Cloud SDK (`gcloud`), and Git for cloning the repository.

5

What tools are included in the example server?

The example Math MCP server provides two tools: `add` (returns the sum of two numbers) and `subtract` (returns the difference).

Comments

More Developer Tools MCP servers