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>
Google Cloud 的前端边缘代理(GFE)会在流量到达容器之前验证令牌签名与有效期,非法请求在基础设施边界就会被直接拦截(HTTP 403 / 401)。
# 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)。无需任何预先握手,即可通过单一 POST /mcp 端点处理工具列表查询与工具调用:
/mcp
// src/server.ts import express, { Request, Response } from 'express'; const app = express(); app.use(express.json()); // Cloud Run 启动探针健康检查端点 app.get('/healthz', (_req: Request, res: Response) => { res.status(200).send('OK'); }); // MCP 2026-07-28 无状态统一端点 app.post('/mcp', async (req: Request, res: Response) => { const mcpMethod = req.header('Mcp-Method') || req.body?.method; const requestId = req.body?.id ?? 1; // 1. 工具发现 (tools/list) 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'] } } ] } }); } // 2. 工具执行 (tools/call) 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}`); });
# Multi-stage build for Minimal Stateless MCP Server 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" } } } }
此外,在本地调试时也可以直接运行 Google Cloud SDK 内置的认证代理: 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 规范彻底走向无状态化,MCP 服务器终于摆脱了本地 stdio 和脆弱的 SSE 长连接束缚。结合 Cloud Run 的自动扩缩容、按需缩容至零以及 Google Cloud IAM 零信任认证,我们可以用极低的运维成本将内部系统安全地开放给 AI 智能体。
stdio
Real-time AI quant analysis of corporate earnings reports.
提供逼真 AI 模拟通话与多维反馈,结合 16 讲实战社交学院与工作室级 AI 肖像生成,全面提升社交互动质量。
拍小票即可完成高精度智能拆单,支持 LINE 登录无缝结算团队聚会支出,告别繁琐账单分摊。
占卜师、管家、调酒师等 AI 角色实时引导话题与聚会游戏,让线下与线上聚餐氛围瞬间升温。
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。