Agent Skill 核验档案

API Gateway MCP Server

该 Skill 指导将 Google Cloud API Gateway 配置为远程 Model Context Protocol (MCP) 服务器（Public Preview），通过 HTTP POST /mcp 将 REST API 暴露为智能体工具，把 MCP JSON-RPC 2.0 请求转换为标准 HTTP REST 请求并沿用现有认证与配额策略。

适用任务

将 OpenAPI 2.0 规范迁移为 OpenAPI 3.x 并添加 x-google-api-management.mcp 和 x-google-mcp-tool 注解，把 REST API 转换为 MCP 工具
使用 x-google-api-management.mcp.tools-list.security（单一 JWT 或 API key 方案）加固 tools/list 并用 x-google-mcp-tool: false 隐藏管理路由
运行 scripts/validate_mcp_openapi.py 在部署前对 OpenAPI 规范做确定性 MCP 校验
通过 POST https://{default_hostname}/mcp 验证 initialize、notifications/initialized、tools/list、tools/call 生命周期并排查 -32601/-32602/-32000 错误
连接 Google ADK (McpToolset) 并验证在 Apigee API hub ({your_api} (MCP)) 和 Agent Registry 中的自动目录发现

输入

OpenAPI 3.x（3.0.x 或 3.1.x）规范文件（待注解或已注解的候选规范）
OpenAPI 2.0 (swagger: "2.0") 规范（需迁移）
gcloud CLI 凭据（gcloud auth login / application-default login）
带 {project_id}、有效结算账号的 Google Cloud 项目
访问令牌：Google ID token（--impersonate-service-account --audiences）或 x-api-key 请求头中的 API key

输出

部署在 API Gateway 上的远程 MCP 服务器，端点为 POST https://{default_hostname}/mcp
tools/list 返回的各工具 inputSchema
验证脚本的 status: PASS 结果
API hub 中显示的 {your_api} (MCP) 条目及 Agent Registry 自动目录发现

限制与检查

MCP 不支持 OpenAPI 2.0 规范，不能给 OpenAPI 2.0 添加 MCP 扩展
仅 GET、POST、PUT、PATCH、 DELETE 操作可作为工具，每个网关最多服务 1,000 个工具
工具不能返回 HTTP 204，响应必须是非空响应体
请求参数必须是基本类型；API Gateway 在创建 API 配置时拒绝复杂嵌套 schema 和 OpenAPI 3.1 类型列表（如 type: ["string", "null"]）
不能在同一 API 配置中同时使用 x-google-api-management.mcp 与 x-google-model-router
不支持含 API key 的替代（OR）安全要求；JWT tools-list.security 方案必须出现在根 security 列表
MCP 是无状态的，仅支持 UTF-8 文本响应
若 API 配置含多个文档，API Gateway 仅服务其中一个文档的 MCP 工具

API Gateway MCP Server

适用任务

输入

输出

限制与检查

搜索

项目详情