Cloud Run + Streamable HTTP MCP Starter Kit
Production reference architecture for deploying an Express/TypeScript Model Context Protocol (MCP) server on Google Cloud Run with Firestore gRPC pre-warming, SHA-256 API key auth, and zero-idle cost scaling.
Core Protocol & Specs
2 links[Ref] Official specification for stateless and stateful Streamable HTTP MCP servers over POST /mcp.
#mcp#spec[Context] Configure --min-instances=0 for scale-to-zero or --min-instances=1 with CPU boost when sub-200ms MCP tool discovery is required.
#cloud-run#containers
Authentication & Storage
2 links[Details] Trigger a lightweight dummy document read during container startup so the first MCP tool call avoids the 800ms gRPC TLS handshake.
#firestore#latency[Ref] Store only sha256(apiKey) in Firestore apiKeys/{hash}; never persist raw secrets.
#security#auth
⚙️ Ready-to-Copy .mcp.json Configuration
{
"mcpServers": {
"cloud-run-mcp": {
"type": "streamable-http",
"url": "https://your-mcp-service-uc.a.run.app/mcp",
"headers": {
"X-API-Key": "cn_live_your_api_key_here"
}
}
}
}📡 Live Telemetry Feed
Last 3 heartbeat pulses emitted via POST /api/pulse/cloud-run-mcp-starter
- 🟢03:54 AM
MCP tools/list & Firestore gRPC health check passed (10 tools registered)
Source:
mcp-agent· 118ms - 🟢03:39 AM
Scheduled synthetic tool invocation succeeded
Source:
cron· 134ms - 🟢02:54 AM
Post-deploy smoke verification completed on us-central1
Source:
github-action· 142ms
1-Click Blueprint Actions
🤖 Blueprint AI Assistant
Grounded in pre-compiled blueprint context · Gemini Flash-Lite
Starter Questions
Click a starter prompt above or ask any question about Cloud Run + Streamable HTTP MCP Starter Kit. No sign-in required for your first 5 questions.