Hi-GCloud

This MCP server provides a focused set of Google Cloud Platform operations you can perform from a command line-driven workflow. You can query Cloud Logging, check Cloud Run status, run read-only Cloud SQL queries, list Cloud Storage buckets and objects, manage secrets, verify authentication status, view enabled API services, and fetch billing information, all through lightweight, scriptable interactions.

How to use

You interact with the Hi-GCloud MCP server through a client that executes the MCP command via an executable interface. Once configured, you can ask it to fetch logs, check service status, or retrieve data from various GCP services using natural, command-like prompts. Each tool corresponds to a specific capability, such as gcp_logs_read for logging queries or gcp_run_status for Cloud Run status.

Key capabilities you will use include Cloud Logging for log viewing and error filtering, Cloud Run for service status and deployment logs, Cloud SQL for read-only queries, Cloud Storage for bucket and object listings, Secret Manager for secret access, Auth Status for current login, API Services for activated services, and Billing for project charges. Use the provided prompts to trigger the corresponding tool and receive structured results.

How to install

Prerequisites you need before installation are the Google Cloud SDK and an authenticated gcloud session.

Install the MCP server globally with npm.

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

Configure your Claude Desktop to use Hi-GCloud by adding the following configuration path and content.

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

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

Configuration and usage notes

The Hi-GCloud MCP server is designed to be driven by an MCP client. You should configure a stdio-based server entry that runs the MCP via npx and points to the package name that exposes the server functionality.

The provided configuration snippet above shows how to wire the server into Claude Desktop so that the client can invoke the Hi-GCloud MCP server with a simple command line.

Available tools and capabilities

The following tools are exposed by the server to interact with various GCP services. Each tool is designed to perform a specific task and can be invoked through natural language prompts or explicit tool names.

gcp_logs_read — Cloud Logging에서 로그 조회

gcp_run_status — Cloud Run 서비스 상태 조회

gcp_run_logs — Cloud Run 서비스 로그 조회

gcp_sql_query — Cloud SQL 읽기 전용 쿼리

gcp_storage_list — Cloud Storage 버킷/객체 목록

gcp_secret_list — Secret Manager 시크릿 조회

gcp_auth_status — GCP 인증 상태 확인

gcp_services_list — 활성화된 API 서비스 목록

gcp_billing_info — 프로젝트 결제 정보 조회

Security, permissions, and access

Ensure your gcloud authentication is active and that your project context is correct using gcloud auth login and gcloud config set project YOUR_PROJECT_ID.

Available tools

gcp_logs_read

Query Cloud Logging to view recent logs, filter by time range and severity, and fetch error logs for debugging.

gcp_run_status

Query Cloud Run to check service status, ready state, and recent deployment status.

gcp_run_logs

Fetch Cloud Run deployment logs to diagnose build and deployment issues.

gcp_sql_query

Execute read-only SELECT queries against Cloud SQL instances to retrieve data without modifying state.

gcp_storage_list

List Cloud Storage buckets and objects to understand storage layout and access patterns.

gcp_secret_list

List and access Secret Manager secrets to inspect stored credentials and configuration.

gcp_auth_status

Check which Google Cloud account is authenticated and active in the current context.

gcp_services_list

List activated API services for your project to verify enabled capabilities.

gcp_billing_info

Retrieve billing information for the project to monitor charges and usage.