mcp

通过MCP协议,使用gcloud CLI查询Google Cloud日志并以YAML返回。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mcp。
它的用途是:通过MCP协议,使用gcloud CLI查询Google Cloud日志并以YAML返回。
详细介绍见:https://321skill.com/skills/mcp-mcp-server-google-logging/
请根据该页面的说明完成安装。

使用示例

“帮我查一下项目`my-gcp-project`在过去一小时内,所有严重级别为ERROR的Cloud Run日志。”,它会通过此Skill调用gcloud命令,将匹配的日志条目以清晰的YAML格式列表返回给你,包含时间、服务名、错误信息等关键字段。

介绍

这个Skill解决了开发者和运维人员在排查Google Cloud服务问题时,需要快速、结构化地查询和分析日志的痛点。传统的日志查询可能需要在控制台进行复杂的筛选或编写冗长的gcloud命令,而这个Skill通过MCP协议将查询能力集成到AI助手(如Claude Desktop)中,让用户可以用自然语言直接获取日志。

使用方式非常简单:用户在与集成了此MCP Server的AI助手对话时,直接提出查询Google Cloud日志的需求,例如指定项目、时间范围或过滤条件。AI助手会调用此Skill,在后台通过gcloud CLI执行查询,并将结果以清晰、结构化的YAML格式返回给用户,方便阅读和进一步处理。

它非常适合需要频繁与Google Cloud打交道的后端开发、运维工程师和运维开发人员。这些角色在日常工作中需要监控服务状态、排查线上故障、分析系统日志,此Skill能极大提升他们获取关键日志信息的效率。

使用建议是确保本地已安装并正确配置了gcloud CLI,且已通过gcloud auth login登录了拥有相应日志查看权限的Google Cloud账户。注意事项是,由于依赖本地gcloud CLI和网络,查询速度和结果受本地环境及Google Cloud API限制影响,复杂或数据量极大的查询可能需要优化过滤条件。

核心特点

核心区别在于它并非直接调用Google Cloud Logging API,而是通过本地已认证的gcloud CLI作为代理来执行查询,这简化了复杂的OAuth2.0或服务账号密钥的配置流程。同时,它将原始的、可能冗长的JSON日志输出,转换为更易读、结构化的YAML格式返回。

注意事项

不适合需要实时流式传输日志、进行复杂聚合分析或脱离本地gcloud CLI环境的场景。

常见问题

使用前需要准备什么?

需要在本机安装并配置好gcloud CLI,并通过`gcloud auth login`登录有日志查看权限的Google Cloud账户。

能查询多长时间的日志?

查询时间范围受Google Cloud Logging本身的保留策略和gcloud命令参数限制,通常可查询最近一定天数内的日志,具体需参考gcloud logging read命令文档。