@prmichaelsen/gcloud-mcp

MCP server for Google Cloud — Cloud Build, Cloud Run, Artifact Registry, and Secret Manager. 17 tools for listing, inspecting, deploying, and managing GCP resources.

Installation

npm install @prmichaelsen/gcloud-mcp

Prerequisites

• Node.js 20+
• GCP Application Default Credentials: gcloud auth application-default login
• Required IAM roles: roles/cloudbuild.builds.viewer, roles/logging.viewer, roles/run.viewer, roles/artifactregistry.reader, roles/secretmanager.viewer

Usage

Claude Code

claude mcp add -e GOOGLE_CLOUD_PROJECT=your-project-id -- gcloud-mcp node /path/to/dist/server.js

Or via npx (after npm publish):

claude mcp add -e GOOGLE_CLOUD_PROJECT=your-project-id -- gcloud-mcp npx -y @prmichaelsen/gcloud-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gcloud-mcp": {
      "command": "npx",
      "args": ["-y", "@prmichaelsen/gcloud-mcp"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "your-project-id"
      }
    }
  }
}

Multi-Tenant (mcp-auth)

import { wrapServer, JWTAuthProvider } from '@prmichaelsen/mcp-auth';
import { createServer } from '@prmichaelsen/gcloud-mcp/factory';

const wrapped = wrapServer({
  serverFactory: createServer,
  authProvider: new JWTAuthProvider({
    jwtSecret: process.env.JWT_SECRET!,
  }),
  resourceType: 'gcloud',
  transport: { type: 'sse', port: 3000 },
});

await wrapped.start();

Tools

gcloud_whoami

Returns current GCP project, authenticated identity, and available permissions.

gcloud_list_builds

List Cloud Build builds with optional filters for status, trigger, and branch.

gcloud_get_build

Get full build details including steps, substitutions, and per-step timing.

gcloud_get_build_logs

Fetch build logs from Cloud Logging with step filtering and line limits.

gcloud_get_service

Get full Cloud Run service details including URL, env vars, resource limits, scaling, and traffic splits.

gcloud_list_revisions

List Cloud Run revisions for a service. Shows deployment history with image tags and creation times.

gcloud_list_services

List Cloud Run services in a region.

gcloud_get_service_logs

Fetch Cloud Run service logs with severity, time, and revision filters.

gcloud_list_triggers

List Cloud Build triggers in a project.

gcloud_get_trigger

Get full Cloud Build trigger configuration including repo, branch filter, build steps, and substitutions.

gcloud_list_jobs

List Cloud Run Jobs in a region.

gcloud_get_job_execution

Get Cloud Run Job execution details or list recent executions.

gcloud_list_artifacts

List Docker images in an Artifact Registry repository, or list repositories.

gcloud_list_secrets

List Secret Manager secret names (NOT values).

gcloud_run_trigger

Manually trigger a Cloud Build. Returns the build ID of the triggered build.

gcloud_deploy_service

Deploy a new revision to a Cloud Run service by updating the container image.

gcloud_set_traffic

Set traffic splitting between Cloud Run revisions for canary deployments and rollbacks.

Environment Variables

Development

npm install
npm run build
npm run dev      # watch mode
npm run typecheck

License

MIT