βοΈ π Build and Deploy a remote MCP server to Cloud Run in 5 minβ¦
@jackwotherspoon
About βοΈ π Build and Deploy a remote MCP server to Cloud Run in 5 minβ¦
Deploy and host a remote MCP server on Cloud Run
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-unauthenticatedflag and IAM roles. - Uses FastMCP for a fast, Pythonic server implementation.
- Supports
streamable-httptransport (default) withsseas an option. - Includes two example math tools:
addandsubtract. - 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.
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.
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).
Frequently asked questions
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.
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.
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).
Basic information
More Developer Tools MCP servers
OpenSumi
opensumiA framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.
Serena
oraiosA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

Termany
thinkany-aiAgent-Native Terminal
Vibgrate MCP
VibgrateQuery your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

Air Pipe
airpipeBuild, validate, deploy β HTTP APIs, cron jobs, webhooks and MCP tools β from your AI client.
Comments