Skip to main content
Glama

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. 인증 완료:

    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

설정 우선순위:

  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

  • hi-ai - AI development assistant MCP

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/su-record/hi-gcloud'

If you have feedback or need assistance with the MCP directory API, please join our Discord server