MCP 服务器

Hi-GCloud

Enables interaction with Google Cloud Platform services through gcloud CLI, supporting operations like querying logs, checking Cloud Run status, managing secrets, executing Cloud SQL queries, and monitoring billing information.

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 설치

인증 완료:

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