Kanji
・雲端架構工程師 / 自由職業 ・1993年出生 ・愛媛縣出身 / 現居東京都澀谷區 ・5年 AWS 實戰經驗 個人檔案詳情
目錄
從 2025 年下半年開始,我在內部工具與個人專案中深度使用 Antigravity 和 Claude Code 時,最先著手建構的就是用於查詢內部資料庫、BigQuery 以及執行維運腳本的遠端 MCP(Model Context Protocol)伺服器。
在開發初期,MCP 生態系中最主流的通訊方式是基於 HTTP SSE(Server-Sent Events)的有狀態串流傳輸。在本機開發環境連接 localhost 執行時一切都非常順暢。然而,一旦將其打包成容器並部署到 Google Cloud 的全代管無伺服器容器平台 Cloud Run 上,棘手的正式環境故障便接踵而至。
localhost
Cloud Run 的核心是無伺服器架構:它會根據並行請求量自動將容器執行個體從零擴展到數十個,並在閒置時迅速銷毀容器(Scale-to-Zero)。然而,舊版 MCP 規範要求在連線開始時執行 initialize 交握,並將伺服器簽發的 Mcp-Session-Id 保存在記憶體中,後續所有的 tools/call 或 resources/read 請求都必須在標頭中攜帶該工作階段 ID。
initialize
Mcp-Session-Id
tools/call
resources/read
這種協定與無伺服器底座的衝突,在實務中引發了以下三大痛點:
404 Session Not Found
min-instances: 1
徹底終結「想用無伺服器架構,協定卻強制要求有狀態」這一困境的,正是 2026 年 7 月 28 日正式發布的 「MCP 2026-07-28」 重大規範升級。
▲ 本機 AI 代理透過 Google Cloud IAM 零信任驗證存取 Cloud Run 無狀態 MCP 伺服器的整體架構
新規範「2026-07-28」最根本的變革是協定核心的 「完全無狀態化」 。它與舊版規範的對比如表所示:
_meta
Mcp-Method
Mcp-Name
在無伺服器環境中,最具突破性的設計是 MRTR(Multi Round-Trip Requests) 。
當代理呼叫高風險工具(例如「是否確認修改正式環境資料庫?」或「是否允許呼叫付費外部 API?」)時,通常需要人工審批(Human-in-the-Loop)或補充參數。在舊規範中,伺服端必須在等待使用者輸入期間保持串流連線不中斷;而在新規範的 MRTR 機制下,伺服端只需回傳 input_required 狀態與延續權杖( continuation_token ),然後 立即正常結束當前 HTTP 請求 。
input_required
continuation_token
當使用者在用戶端完成確認後,代理會攜帶使用者回答與 continuation_token 發起新的 POST 請求。即使這次請求被路由到了全新的容器(執行個體 B),伺服端也能從權杖或分散式儲存中還原上下文並順利完成操作。
在公網部署遠端 MCP 伺服器時,最危險的做法莫過於「使用自訂靜態 API Key 放在 X-Api-Key 標頭中鑑權」。靜態金鑰極易被寫死在代理設定檔(如 mcp_config.json )中,存在誤提交至程式碼儲存庫或外洩的高風險。
X-Api-Key
mcp_config.json
使用 Google Cloud Run 的最大優勢在於,可以直接重用 Google Cloud 原生 IAM 驗證( roles/run.invoker )與 OIDC ID 權杖 建構零信任防線:
roles/run.invoker
--no-allow-unauthenticated
https://<service-name>-<hash>-an.a.run.app
Authorization: Bearer <ID_TOKEN>
# 0. 為呼叫方授予最小權限 roles/run.invoker gcloud run services add-iam-policy-binding mcp-secops-server \ --region=asia-northeast1 \ --member="user:developer@example.com" \ --role="roles/run.invoker" # 1. 取得 Cloud Run 服務 URL SERVICE_URL=$(gcloud run services describe mcp-secops-server --region asia-northeast1 --format 'value(status.url)') # 2. 動態簽發匹配目標服務 Audience 的 OIDC ID 權杖 ID_TOKEN=$(gcloud auth print-identity-token --audiences="${SERVICE_URL}") # 3. 攜帶 Mcp-Method 標頭與 Bearer 權杖發起無狀態呼叫 curl -s -X POST "${SERVICE_URL}/mcp" \ -H "Authorization: Bearer ${ID_TOKEN}" \ -H "Mcp-Method: tools/list" \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | jq .
▲ Cloud Run 服務拒絕未驗證存取(--no-allow-unauthenticated)及 IAM 主體 roles/run.invoker 最小權限綁定實機驗證
以下是我在驗證環境中實際執行的、符合 MCP 2026-07-28 規範的最小化無狀態伺服器程式碼(基於 Node.js + Express):
// src/server.ts import express, { Request, Response } from 'express'; const app = express(); app.use(express.json()); app.get('/healthz', (_req: Request, res: Response) => { res.status(200).send('OK'); }); app.post('/mcp', async (req: Request, res: Response) => { const mcpMethod = req.header('Mcp-Method') || req.body?.method; const requestId = req.body?.id ?? 1; if (mcpMethod === 'tools/list' || req.body?.method === 'tools/list') { return res.json({ jsonrpc: '2.0', id: requestId, result: { tools: [ { name: 'query_security_audit_logs', description: '從 Cloud Logging 擷取近期關鍵安全稽核事件', inputSchema: { type: 'object', properties: { hoursAgo: { type: 'number', description: '回溯小時數(預設: 1)' }, severity: { type: 'string', enum: ['WARNING', 'ERROR', 'CRITICAL'] } }, required: ['severity'] } } ] } }); } if (mcpMethod === 'tools/call' || req.body?.method === 'tools/call') { const { name, arguments: args } = req.body.params; if (name === 'query_security_audit_logs') { const severity = args?.severity || 'ERROR'; const mockResult = [ { timestamp: new Date().toISOString(), severity: severity, resource: 'projects/my-prod-project/instances/db-01', message: 'IAM permission check failed for service account' } ]; return res.json({ jsonrpc: '2.0', id: requestId, result: { content: [{ type: 'text', text: JSON.stringify(mockResult, null, 2) }], isError: false } }); } return res.status(404).json({ jsonrpc: '2.0', id: requestId, error: { code: -32601, message: `Tool ${name} not found` } }); } return res.status(400).json({ jsonrpc: '2.0', id: requestId, error: { code: -32600, message: `Unsupported MCP method: ${mcpMethod}` } }); }); const PORT = process.env.PORT || 8080; app.listen(PORT, () => { console.log(`[MCP Server] Stateless Remote MCP listening on port ${PORT}`); });
FROM node:22-alpine AS builder WORKDIR /app COPY package*.json tsconfig.json ./ RUN npm ci COPY src ./src RUN npm run build FROM node:22-alpine AS runner WORKDIR /app ENV NODE_ENV=production COPY package*.json ./ RUN npm ci --only=production COPY --from=builder /app/dist ./dist USER node EXPOSE 8080 CMD ["node", "dist/server.js"]
PROJECT_ID="your-gcp-project-id" REGION="asia-northeast1" SERVICE_NAME="mcp-secops-server" gcloud run deploy "${SERVICE_NAME}" \ --source . \ --region "${REGION}" \ --project "${PROJECT_ID}" \ --no-allow-unauthenticated \ --min-instances 0 \ --max-instances 10 \ --cpu 1 \ --memory 512Mi \ --concurrency 80 \ --timeout 60s
{ "mcpServers": { "cloudrun-secops": { "command": "node", "args": [ "/usr/local/bin/cloudrun-mcp-proxy.js", "--url", "https://mcp-secops-server-xyz-an.a.run.app/mcp" ], "env": { "CLOUD_RUN_AUDIENCE": "https://mcp-secops-server-xyz-an.a.run.app" } } } }
在本機除錯時,亦可直接執行 gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080 ,自動為發往 http://localhost:8080/mcp 的請求注入 OIDC ID 權杖。
gcloud run services proxy mcp-secops-server --region=asia-northeast1 --port=8080
http://localhost:8080/mcp
▲ 遠端驗證環境中透過 gcloud auth 簽發 OIDC ID 權杖並使用 Mcp-Method 標頭完成無狀態呼叫與 MRTR 跨執行個體還原的實測日誌
--min-instances 1
gcloud auth print-identity-token
gcloud
Authorization: Bearer <GCP_ID_TOKEN>
X-Upstream-Authorization
隨著 MCP 2026-07-28 規範徹底走向無狀態化,結合 Cloud Run 的自動擴縮容、Scale-to-Zero 與 Google Cloud IAM 零信任驗證,我們終於能以雲端原生方式安全、低成本地將內部系統開放給 AI 代理使用。
Real-time AI quant analysis of corporate earnings reports.
提供逼真 AI 模擬通話與多維反饋,結合 16 講實戰社交學院與工作室級 AI 肖像生成,全面提升社交互動品質。
拍發票即可完成高精度智慧拆單,支援 LINE 登入無縫結算團隊聚會支出,告別繁雜帳單分攤。
占卜師、管家、調酒師等 AI 角色即時引導話題與聚會遊戲,讓線下與線上聚餐氛圍瞬間升溫。
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。