hi-gcloud

DevOps

by su-record

提供面向项目的 GCP 运维捷径,快速查看 logs、Cloud Run、只读 Cloud SQL、Storage、secrets、services、auth 与 billing,加速部署排障和成本监控。

什么是 hi-gcloud

提供面向项目的 GCP 运维捷径,快速查看 logs、Cloud Run、只读 Cloud SQL、Storage、secrets、services、auth 与 billing,加速部署排障和成本监控。

README

Hi-GCloud

npm version License: MIT MCP Compatible

MCP server for GCP operations - Query logs, check Cloud Run status, and debug deployments with gcloud CLI.

Features

  • Cloud Logging - 로그 조회 및 에러 필터링
  • Cloud Run - 서비스 상태 및 배포 로그 확인
  • Cloud SQL - 읽기 전용 쿼리 실행
  • Cloud Storage - 버킷/객체 목록 조회
  • Secret Manager - 시크릿 관리 및 조회
  • Auth Status - 인증 상태 확인
  • API Services - 활성화된 서비스 목록
  • Billing - 과금 정보 조회

Prerequisites

  1. Google Cloud SDK 설치
  2. 인증 완료:
    bash
    gcloud auth login
    gcloud config set project YOUR_PROJECT_ID
    

Installation

bash
npm install -g @su-record/hi-gcloud

Claude Desktop Configuration

~/Library/Application Support/Claude/claude_desktop_config.json:

json
{
  "mcpServers": {
    "hi-gcloud": {
      "command": "npx",
      "args": ["-y", "@su-record/hi-gcloud"]
    }
  }
}

Tools (9 tools)

gcp_logs_read

Cloud Logging에서 로그 조회

code
"최근 에러 로그 보여줘"
"지난 6시간 WARNING 이상 로그"

gcp_run_status

Cloud Run 서비스 상태 조회

code
"my-api 서비스 상태 확인"
"Cloud Run 배포 상태"

gcp_run_logs

Cloud Run 서비스 로그 조회

code
"my-api 에러 로그"
"Cloud Run 최근 로그"

gcp_sql_query

Cloud SQL 읽기 전용 쿼리 (SELECT만 허용)

code
"users 테이블 조회"

gcp_storage_list

Cloud Storage 버킷/객체 목록

code
"버킷 목록 보여줘"
"my-bucket 파일 목록"

gcp_secret_list

Secret Manager 시크릿 조회

code
"시크릿 목록"
"API_KEY 시크릿 값 확인"

gcp_auth_status

GCP 인증 상태 확인

code
"인증 상태 확인"
"어떤 계정으로 로그인되어 있어?"

gcp_services_list

활성화된 API 서비스 목록

code
"어떤 API가 활성화되어 있어?"
"run 관련 서비스 찾아줘"

gcp_billing_info

프로젝트 결제 정보 조회

code
"과금 정보 확인"
"얼마나 나왔어?"

Use Cases

배포 실패 디버깅

code
User: "배포가 실패했어"
→ gcp_run_logs로 에러 확인
→ 에러 원인 분석
→ 수정 제안

비용 모니터링

code
User: "이번 달 비용 확인"
→ gcp_billing_info로 결제 정보 조회
→ 비용 절감 팁 제공

시크릿 관리

code
User: "DB 비밀번호 확인"
→ gcp_secret_list로 시크릿 조회

Integration with Hi-AI

hi-ai와 함께 사용하면 강력한 GCP 운영 + 코드 수정 워크플로우를 제공합니다.

자동 연동 힌트

에러 발견 시 hi-ai 도구를 자동으로 추천합니다:

code
📋 Cloud Run 로그: my-api
🔴 3개의 에러가 발견되었습니다.

📋 에러 요약:
  🔴 ERROR: 3건

🔍 최근 에러 상세:
  1. [12/02 14:30:00] TypeError: Cannot read property 'id' of undefined
     └ 리소스: my-api-00001-abc

💡 hi-ai 연동 가능: 에러 분석이 필요하면 analyze_problem 도구로 원인을 분석하고,
   관련 코드를 찾아 수정 방안을 제시할 수 있습니다.
   메모리에 저장하면 같은 에러 재발 시 빠르게 해결할 수 있습니다.

연동 도구 매핑

hi-gcloud 상황hi-ai 추천 도구
에러 로그 발견analyze_problem, find_symbol
배포 실패step_by_step_analysis, suggest_improvements
성능 문제analyze_complexity, check_coupling_cohesion
비용 증가break_down_problem, format_as_plan

워크플로우 예시

code
User: "배포가 실패했어"

[hi-gcloud]
→ gcp_run_logs로 에러 로그 조회
→ 에러 3건 발견, hi-ai 연동 힌트 자동 제공

[hi-ai 자동 연동]
→ analyze_problem으로 에러 원인 분석
→ find_symbol로 관련 코드 위치 파악
→ suggest_improvements로 수정 방안 제시
→ save_memory로 해결 방법 저장 (재발 방지)

함께 설치

json
{
  "mcpServers": {
    "hi-ai": {
      "command": "npx",
      "args": ["-y", "@su-record/hi-ai"]
    },
    "hi-gcloud": {
      "command": "npx",
      "args": ["-y", "@su-record/hi-gcloud"]
    }
  }
}

Configuration Priority

설정 우선순위:

  1. 도구 파라미터로 직접 지정 (예: project_id: "my-project")
  2. gcloud CLI 기본 설정

Required Permissions

ToolRequired Role
gcp_logs_readroles/logging.viewer
gcp_run_*roles/run.viewer
gcp_sql_queryroles/cloudsql.viewer
gcp_storage_listroles/storage.objectViewer
gcp_secret_listroles/secretmanager.secretAccessor
gcp_billing_inforoles/billing.viewer

License

MIT

Related

  • hi-ai - AI development assistant MCP

常见问题

hi-gcloud 是什么?

提供面向项目的 GCP 运维捷径,快速查看 logs、Cloud Run、只读 Cloud SQL、Storage、secrets、services、auth 与 billing,加速部署排障和成本监控。

相关 Skills

可观测性设计

by alirezarezvani

Universal
热门

面向生产系统规划可落地的可观测性体系,串起指标、日志、链路追踪与 SLI/SLO、错误预算、告警和仪表盘设计,适合搭建监控平台与优化故障响应。

把监控、日志、链路追踪串起来,帮助团队从设计阶段构建可观测性,排障更快、系统演进更稳。

DevOps
未扫描9.0k

资深开发运维

by alirezarezvani

Universal
热门

覆盖 CI/CD 流水线生成、Terraform 基建脚手架和自动化部署,适合在 AWS、GCP、Azure 上搭建云原生发布流程,管理 Docker/Kubernetes 基础设施并持续优化交付。

把CI/CD、基础设施即代码、容器与监控串成一条交付链,尤其适合AWS/GCP/Azure多云团队高效落地。

DevOps
未扫描9.0k

环境密钥管理

by alirezarezvani

Universal
热门

统一梳理dev/staging/prod的.env和密钥流程,自动生成.env.example、校验必填变量、扫描Git历史泄漏,并联动Vault、AWS SSM、1Password、Doppler完成轮换。

统一管理环境变量、密钥与配置,减少泄露和部署混乱,安全治理与团队协作一起做好,DevOps 场景很省心。

DevOps
未扫描9.0k

相关 MCP Server

kubefwd

编辑精选

by txn2

热门

kubefwd 是让 AI 帮你批量转发 Kubernetes 服务到本地的开发神器。

微服务开发者最头疼的本地调试问题,它一键搞定——自动分配 IP 避免端口冲突,还能用自然语言查询状态。但依赖 AI 工作流,纯命令行爱好者可能觉得不够直接。

DevOps
4.1k

Cloudflare

编辑精选

by Cloudflare

热门

Cloudflare MCP Server 是让你用自然语言管理 Workers、KV 和 R2 等云资源的工具。

这个工具解决了开发者频繁切换控制台和文档的痛点,特别适合那些在 Cloudflare 上部署无服务器应用、需要快速调试或管理配置的团队。不过,由于它依赖多个子服务器,初次设置可能有点繁琐,建议先从 Workers Bindings 这类核心功能入手。

DevOps
3.6k

Terraform

编辑精选

by hashicorp

Terraform MCP Server 是让 AI 助手直接操作 Terraform Registry 和 HCP Terraform 的桥梁。

如果你经常在 Terraform 里翻文档找模块配置,这个服务器能省不少时间——直接问 Claude 就能生成准确的代码片段。最适合管理多云基础设施的团队,但注意它目前只适合本地使用,别在生产环境里暴露 HTTP 端点。

DevOps
1.3k

评论