SuperAPI AI 工具集

resolving-mcp-region-configs

部署与运维

查看项目

更新于 10-15 21:54

技能介绍

用途:这是一个面向 Google Cloud 区域级 MCP 服务(如 Dataproc)的强制第 0 步预检技能。区域级 MCP 服务器地址形如 https://dataproc-$GCP_REGION.googleapis.com/mcp,若区域占位符未被替换,服务器会静默连接失败,注册零个工具,且不报错、不显示占位符,难以察觉。

主要能力与触发条件:当任务涉及区域级服务(如 Dataproc 集群、Spark 批处理、作业、会话),先检查当前环境中是否注册了预期的 mcp__<service> 工具(可通过 ToolSearch 或延迟工具列表确认)。若工具缺失,或调用因主机名格式错误而失败/挂起,不要立即退回 gcloud/bq CLI,而应检查运行时 MCP 配置文件是否存在未替换的 $GCP_REGION 或 ${REGION} 占位符。若区域已填为有效值(如 us-central1),本技能不适用,正常继续任务。

配置位置:应编辑运行时实际加载的文件(位于插件安装/缓存路径),并尽量同步修改源副本以在重装后保留。Claude Code 路径:~/.claude/plugins/cache/<marketplace>/dak/<version>/.claude-plugin/mcp.json(<marketplace>/<version> 从 ~/.claude/plugins/installed_plugins.json 获取),同时检查 ./.claude-plugin/mcp.json 与 claude_desktop_config.json。Codex 路径:~/.codex/plugins/cache/<marketplace>/dak/<version>/mcp.json。Antigravity 路径:./mcp_config.json 或 ~/.gemini/antigravity/mcp_config.json。

使用方式:不得在修复前调用区域工具(此时通常并无工具可调);必须向用户询问其 GCP 区域,禁止猜测;将配置文件中的占位符替换为该区域;告知用户重启,因为 MCP 连接仅在启动时加载,不会在会话中热重载。重启不会丢失对话,可分别使用 claude --resume(或 --continue)、codex resume --last(或 codex resume 打开选择器),Antigravity 则使用其恢复/历史选择器(如可用)。

支持服务:Dataproc(https://dataproc-$GCP_REGION.googleapis.com/mcp)。

限制:目前资料仅列出 Dataproc;区域值必须由用户提供;重启方式因客户端而异,Antigravity 的恢复功能需视其是否提供而定,其余细节暂未提供。