hi-gcloud
DevOpsby 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
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
- Google Cloud SDK 설치
- 인증 완료:
bash
gcloud auth login gcloud config set project YOUR_PROJECT_ID
Installation
npm install -g @su-record/hi-gcloud
Claude Desktop Configuration
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"hi-gcloud": {
"command": "npx",
"args": ["-y", "@su-record/hi-gcloud"]
}
}
}
Tools (9 tools)
gcp_logs_read
Cloud Logging에서 로그 조회
"최근 에러 로그 보여줘"
"지난 6시간 WARNING 이상 로그"
gcp_run_status
Cloud Run 서비스 상태 조회
"my-api 서비스 상태 확인"
"Cloud Run 배포 상태"
gcp_run_logs
Cloud Run 서비스 로그 조회
"my-api 에러 로그"
"Cloud Run 최근 로그"
gcp_sql_query
Cloud SQL 읽기 전용 쿼리 (SELECT만 허용)
"users 테이블 조회"
gcp_storage_list
Cloud Storage 버킷/객체 목록
"버킷 목록 보여줘"
"my-bucket 파일 목록"
gcp_secret_list
Secret Manager 시크릿 조회
"시크릿 목록"
"API_KEY 시크릿 값 확인"
gcp_auth_status
GCP 인증 상태 확인
"인증 상태 확인"
"어떤 계정으로 로그인되어 있어?"
gcp_services_list
활성화된 API 서비스 목록
"어떤 API가 활성화되어 있어?"
"run 관련 서비스 찾아줘"
gcp_billing_info
프로젝트 결제 정보 조회
"과금 정보 확인"
"얼마나 나왔어?"
Use Cases
배포 실패 디버깅
User: "배포가 실패했어"
→ gcp_run_logs로 에러 확인
→ 에러 원인 분석
→ 수정 제안
비용 모니터링
User: "이번 달 비용 확인"
→ gcp_billing_info로 결제 정보 조회
→ 비용 절감 팁 제공
시크릿 관리
User: "DB 비밀번호 확인"
→ gcp_secret_list로 시크릿 조회
Integration with Hi-AI
hi-ai와 함께 사용하면 강력한 GCP 운영 + 코드 수정 워크플로우를 제공합니다.
자동 연동 힌트
에러 발견 시 hi-ai 도구를 자동으로 추천합니다:
📋 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 |
워크플로우 예시
User: "배포가 실패했어"
[hi-gcloud]
→ gcp_run_logs로 에러 로그 조회
→ 에러 3건 발견, hi-ai 연동 힌트 자동 제공
[hi-ai 자동 연동]
→ analyze_problem으로 에러 원인 분석
→ find_symbol로 관련 코드 위치 파악
→ suggest_improvements로 수정 방안 제시
→ save_memory로 해결 방법 저장 (재발 방지)
함께 설치
{
"mcpServers": {
"hi-ai": {
"command": "npx",
"args": ["-y", "@su-record/hi-ai"]
},
"hi-gcloud": {
"command": "npx",
"args": ["-y", "@su-record/hi-gcloud"]
}
}
}
Configuration Priority
설정 우선순위:
- 도구 파라미터로 직접 지정 (예:
project_id: "my-project") - gcloud CLI 기본 설정
Required Permissions
| Tool | Required Role |
|---|---|
| gcp_logs_read | roles/logging.viewer |
| gcp_run_* | roles/run.viewer |
| gcp_sql_query | roles/cloudsql.viewer |
| gcp_storage_list | roles/storage.objectViewer |
| gcp_secret_list | roles/secretmanager.secretAccessor |
| gcp_billing_info | roles/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
面向生产系统规划可落地的可观测性体系,串起指标、日志、链路追踪与 SLI/SLO、错误预算、告警和仪表盘设计,适合搭建监控平台与优化故障响应。
✎ 把监控、日志、链路追踪串起来,帮助团队从设计阶段构建可观测性,排障更快、系统演进更稳。
资深开发运维
by alirezarezvani
覆盖 CI/CD 流水线生成、Terraform 基建脚手架和自动化部署,适合在 AWS、GCP、Azure 上搭建云原生发布流程,管理 Docker/Kubernetes 基础设施并持续优化交付。
✎ 把CI/CD、基础设施即代码、容器与监控串成一条交付链,尤其适合AWS/GCP/Azure多云团队高效落地。
环境密钥管理
by alirezarezvani
统一梳理dev/staging/prod的.env和密钥流程,自动生成.env.example、校验必填变量、扫描Git历史泄漏,并联动Vault、AWS SSM、1Password、Doppler完成轮换。
✎ 统一管理环境变量、密钥与配置,减少泄露和部署混乱,安全治理与团队协作一起做好,DevOps 场景很省心。
相关 MCP Server
kubefwd
编辑精选by txn2
kubefwd 是让 AI 帮你批量转发 Kubernetes 服务到本地的开发神器。
✎ 微服务开发者最头疼的本地调试问题,它一键搞定——自动分配 IP 避免端口冲突,还能用自然语言查询状态。但依赖 AI 工作流,纯命令行爱好者可能觉得不够直接。
Cloudflare
编辑精选by Cloudflare
Cloudflare MCP Server 是让你用自然语言管理 Workers、KV 和 R2 等云资源的工具。
✎ 这个工具解决了开发者频繁切换控制台和文档的痛点,特别适合那些在 Cloudflare 上部署无服务器应用、需要快速调试或管理配置的团队。不过,由于它依赖多个子服务器,初次设置可能有点繁琐,建议先从 Workers Bindings 这类核心功能入手。
Terraform
编辑精选by hashicorp
Terraform MCP Server 是让 AI 助手直接操作 Terraform Registry 和 HCP Terraform 的桥梁。
✎ 如果你经常在 Terraform 里翻文档找模块配置,这个服务器能省不少时间——直接问 Claude 就能生成准确的代码片段。最适合管理多云基础设施的团队,但注意它目前只适合本地使用,别在生产环境里暴露 HTTP 端点。