用途:通过托管在 Google 的远程 MCP 服务器访问 GCP Cloud Logging,用于日志搜索、VPC 流日志、防火墙日志、审计日志以及日志存储桶和视图的查询,适合调试、错误排查与审计调查。
接入方式:Endpoint 为 https://logging.googleapis.com/mcp,采用 Streamable HTTP;认证使用 Google IAM 的 OAuth 2.0,可用服务账号密钥(GOOGLE_APPLICATION_CREDENTIALS)或 gcloud auth application-default login。需要设置环境变量 GCP_PROJECT_ID,远程托管无需本地安装。
主要能力(6 个工具):list_log_entries 搜索和获取日志条目;list_log_names 发现项目中的日志来源;get_bucket 与 list_buckets 查看日志存储桶;get_view 与 list_views 查看存储桶上的日志视图。
典型用法:先用 list_log_names 定位日志(如 compute.googleapis.com/vpc_flows、firewall、cloudaudit.googleapis.com/activity 或 data_access),再用 list_log_entries 按源/目标 IP、端口、协议、ALLOWED/DENIED、时间范围、principal 或方法名过滤。可用于分析被拒绝流量、统计 top talkers、评估防火墙规则命中率、追踪资源创建修改删除及读取操作,并可结合 gcp-cloud-monitoring 按时间对齐指标。日志过滤示例:resource.type="gce_subnetwork" logName="projects/PROJECT/logs/compute.googleapis.com%2Fvpc_flows" jsonPayload.disposition="DENIED"。
限制:日志按配置的 GCP 项目范围查询;Cloud Logging 查询超出免费额度(每月 50 GB 免费)会产生费用;保留期因类型而异,Admin activity 约 400 天、Data access 默认约 30 天、VPC 流日志取决于存储桶配置。工具报错(超时、主机不可达、响应格式错误)时应直接向用户报告失败与错误信息,不得编造结果;只读调用可检查连通性后重试一次,改变状态或发送消息的调用在结果未知时不得直接重试。
其他细节(如定价、完整命令、各字段取值)资料未提供。