Hi-gcloud is an MCP server for Google Cloud Platform operations that enables querying logs, monitoring Cloud Run services, inspecting Cloud SQL databases, and managing cloud resources through the gcloud CLI. Key features: - Cloud Logging integration for querying logs and filtering errors by severity and timeframe - Cloud Run monitoring for checking service status and deployment logs - Read-only Cloud SQL database queries (SELECT only) for safe data inspection - Cloud Storage browsing for listing buckets and objects - Secret Manager access for retrieving and managing secrets - Authentication status verification for GCP account and project configuration - API services discovery to see enabled GCP APIs - Billing information retrieval for cost monitoring and budget awareness

Hi-GCloud

[](https://www.npmjs.com/package/@su-record/hi-gcloud) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io)

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

Features

Prerequisites

1. Google Cloud SDK 설치 2. 인증 완료:

   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

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

gcp_run_status

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

gcp_run_logs

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

gcp_sql_query

"users 테이블 조회"

gcp_storage_list

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

gcp_secret_list

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

gcp_auth_status

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

gcp_services_list

"어떤 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

설정 우선순위: 1. 도구 파라미터로 직접 지정 (예: project_id: "my-project") 2. 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