npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@softsurgetech/gcloud-mcp-proxy

v1.0.0

Published

Stdio-to-HTTP MCP proxy for Google Cloud remote MCP servers (Firestore, Cloud Run, Discovery Engine, BigQuery, and more)

Readme

gcloud-mcp-proxy

Stdio-to-HTTP proxy for Google Cloud's remote MCP servers. One binary, any Google Cloud MCP endpoint.

Bridges MCP clients (JSON-RPC over stdin/stdout) to Google's managed MCP servers with automatic authentication via ADC, service account, or API key.

Supported Services

| Service | MCP_ENDPOINT | |---------|-------------| | Agent Search | https://discoveryengine.googleapis.com/mcp | | Firestore | https://firestore.googleapis.com/mcp | | Cloud Run | https://run.googleapis.com/mcp | | Cloud SQL | https://sqladmin.googleapis.com/mcp | | Cloud Storage | https://storage.googleapis.com/storage/mcp | | BigQuery | https://bigquery.googleapis.com/mcp | | Pub/Sub | https://pubsub.googleapis.com/mcp | | Cloud Logging | https://logging.googleapis.com/mcp | | Cloud Monitoring | https://monitoring.googleapis.com/mcp | | Vertex AI | https://aiplatform.googleapis.com/mcp | | GKE | https://container.googleapis.com/mcp | | Compute Engine | https://compute.googleapis.com/mcp | | Spanner | https://spanner.googleapis.com/mcp |

Full list: https://docs.cloud.google.com/mcp/supported-products

Quick Start

make setup       # Install deps + pre-commit hook
make validate    # Compile + test all endpoints

Authentication

Three methods, checked in priority order:

| Priority | Method | Env Variable | Use Case | |----------|--------|-------------|----------| | 1 | API Key | GOOGLE_API_KEY | Simple, no OAuth — limited access | | 2 | Service Account | GOOGLE_SERVICE_ACCOUNT_KEY_FILE | Path to SA JSON — CI/CD, servers | | 3 | ADC | (automatic) | gcloud auth application-default login — local dev |

Error Messages

If auth is misconfigured:

[gcloud-mcp-proxy] ERROR: Authentication failed.
  Could not load the default credentials.

  To fix, do one of:
    1. Run: gcloud auth application-default login
    2. Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE=/path/to/sa-key.json
    3. Set GOOGLE_API_KEY=your-api-key

If MCP_ENDPOINT is missing:

[gcloud-mcp-proxy] ERROR: MCP_ENDPOINT is required.

  Set MCP_ENDPOINT to a Google Cloud MCP server URL:

    Agent Search:      https://discoveryengine.googleapis.com/mcp
    Firestore:         https://firestore.googleapis.com/mcp
    ...

Make Targets

| Target | What it does | |--------|-------------| | make setup | Install deps + git pre-commit hook | | make compile | TypeScript → dist/ | | make lint | ESLint | | make scan | Lint + gitleaks + semgrep | | make build | compile + scan | | make validate | Compile + test all service endpoints | | make package | build + verify output | | make release | package + git tag + push | | make publish | package + npm publish | | make start | Compile + run proxy (requires MCP_ENDPOINT) | | make stop | Kill backgrounded proxy | | make restart | stop + start | | make clean | Remove dist/ + node_modules/ |

Output

$ make scan
  ✓ Lint          — No Issues Found
  ✓ Secrets       — No Secrets Detected
  ✓ SAST          — No Issues Found

$ make validate
  ✓ Agent Search    — Connected
  ✓ Firestore       — Connected
  ✓ Cloud Run       — Connected
  ✓ Cloud SQL       — Connected
  ✓ Cloud Storage   — Connected
  ✓ Pub/Sub         — Connected

  6 passed, 0 failed

Pre-commit Hook

Installed by make setup. Runs make scan on every commit:

  • ESLint (TypeScript)
  • gitleaks (secret detection)
  • semgrep (SAST)

MCP Client Configuration

Set MCP_ENDPOINT to choose which Google Cloud service to proxy. Run one instance per service.

Firestore

{
  "mcpServers": {
    "gcp-firestore": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": {
        "MCP_ENDPOINT": "https://firestore.googleapis.com/mcp"
      }
    }
  }
}

Agent Search (Discovery Engine)

{
  "mcpServers": {
    "gcp-agent-search": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": {
        "MCP_ENDPOINT": "https://discoveryengine.googleapis.com/mcp"
      }
    }
  }
}

Cloud Run

{
  "mcpServers": {
    "gcp-cloud-run": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": {
        "MCP_ENDPOINT": "https://run.googleapis.com/mcp"
      }
    }
  }
}

Multiple services (one proxy per service)

{
  "mcpServers": {
    "gcp-firestore": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": { "MCP_ENDPOINT": "https://firestore.googleapis.com/mcp" }
    },
    "gcp-cloud-run": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": { "MCP_ENDPOINT": "https://run.googleapis.com/mcp" }
    },
    "gcp-agent-search": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": { "MCP_ENDPOINT": "https://discoveryengine.googleapis.com/mcp" }
    }
  }
}

With Service Account (for CI/CD)

{
  "mcpServers": {
    "gcp-firestore": {
      "command": "node",
      "args": ["/path/to/gcloud-mcp-proxy/dist/index.js"],
      "env": {
        "MCP_ENDPOINT": "https://firestore.googleapis.com/mcp",
        "GOOGLE_SERVICE_ACCOUNT_KEY_FILE": "/path/to/sa-key.json"
      }
    }
  }
}

How It Works

  1. MCP client sends JSON-RPC messages to proxy's stdin (one per line)
  2. Proxy reads MCP_ENDPOINT env var to determine target
  3. Authenticates with Google Cloud (ADC / API key / SA)
  4. POSTs the JSON-RPC message to the endpoint with Bearer token
  5. Writes response to stdout
  6. Errors and diagnostics go to stderr (won't pollute JSON-RPC)

Prerequisites

  • Node.js 20+
  • pnpm
  • Authentication (one of):
    • gcloud auth application-default login
    • GOOGLE_API_KEY env var
    • GOOGLE_SERVICE_ACCOUNT_KEY_FILE env var
  • The target GCP API must be enabled in your project
  • For scans: gitleaks, semgrep

Publishing

Option A: Public npm registry (npmjs.com)

npm login                    # One-time: authenticate to npmjs.com
make publish                 # Builds, scans, publishes

Consumers install with:

npx gcloud-mcp-proxy        # Run directly
# or
npm install -g gcloud-mcp-proxy

Option B: GitLab npm registry (gitlab.com)

  1. Scope the package in package.json:
{ "name": "@softsurgetech/gcloud-mcp-proxy" }
  1. Add .npmrc to the repo:
@softsurgetech:registry=https://gitlab.com/api/v4/projects/PROJECT_ID/packages/npm/
//gitlab.com/api/v4/projects/PROJECT_ID/packages/npm/:_authToken=${GITLAB_TOKEN}
  1. Publish:
npm publish

Consumers need registry config to install:

npm install @softsurgetech/gcloud-mcp-proxy --registry=https://gitlab.com/api/v4/projects/PROJECT_ID/packages/npm/

Recommendation

Use npmjs.com for public distribution — zero config for consumers. Use GitLab registry if you want to keep it within your org or need GitLab CI job token auth for publishing.

Development

make setup      # Install everything
make build      # Compile + full scan
make validate   # Test all endpoints

Repository

gitlab.com/softsurgetech/ai/mcp/vertex-ai-mcp-proxy

License

MIT