Google Cloud Docs MCP Server

Instructions

Implementation Reference

• src/index.ts:893-910 (handler)

  The main handler function for the 'list_google_cloud_products' tool. It transforms the GOOGLE_CLOUD_PRODUCTS mapping into a JSON response listing all products with their IDs, names, documentation paths, URLs, and descriptions.

  function listGoogleCloudProducts(): string {
    const products = Object.entries(GOOGLE_CLOUD_PRODUCTS).map(
      ([key, value]) => ({
        id: key,
        name: value.name,
        docsPath: value.docsPath,
        docsUrl: `https://cloud.google.com/${value.docsPath}`,
        description: value.description,
      })
    );
  
    return JSON.stringify({
      totalProducts: products.length,
      products: products,
      usage:
        'Use "fetch_google_cloud_doc" with the docsPath to get documentation content.',
    });
  }

• src/index.ts:124-154 (registration)

  Tool registration in the MCP tools array, defining the name, comprehensive description, and empty input schema (no parameters required).

    {
      name: "list_google_cloud_products",
      description: `List all available Google Cloud products with their documentation paths.
  
  **WHEN TO USE**: Use this tool when:
  - User wants to see what GCP services are available
  - User is exploring GCP products
  - You need to find the correct product ID for other tools
  - User asks "what GCP services are there?" or similar
  
  **OUTPUT**: Returns JSON with:
  - totalProducts: Number of products listed
  - products: Array of products with id, name, docsPath, docsUrl, description
  
  **PRODUCTS INCLUDED** (20+):
  - Compute: compute, kubernetes, functions, run, appengine
  - Storage: storage, firestore, spanner
  - Database: sql, bigquery
  - AI/ML: ai (Vertex AI), vision, speech, translate
  - Networking: vpc, loadbalancing, cdn, dns
  - Security: iam, kms
  - Messaging: pubsub
  - Monitoring: logging, monitoring
  
  **TIP**: Use the returned 'docsPath' with 'fetch_google_cloud_doc' to get detailed documentation.`,
      inputSchema: {
        type: "object" as const,
        properties: {},
        required: [],
      },
    },

• src/index.ts:211-315 (helper)

  Constant mapping of Google Cloud product IDs to their display names, documentation paths, and descriptions. This data is used by the listGoogleCloudProducts handler to generate the tool response.

  const GOOGLE_CLOUD_PRODUCTS: Record<
    string,
    { name: string; docsPath: string; description: string }
  > = {
    compute: {
      name: "Compute Engine",
      docsPath: "compute/docs",
      description: "Virtual machines and infrastructure",
    },
    storage: {
      name: "Cloud Storage",
      docsPath: "storage/docs",
      description: "Object storage service",
    },
    bigquery: {
      name: "BigQuery",
      docsPath: "bigquery/docs",
      description: "Data warehouse and analytics",
    },
    kubernetes: {
      name: "Google Kubernetes Engine",
      docsPath: "kubernetes-engine/docs",
      description: "Managed Kubernetes service",
    },
    functions: {
      name: "Cloud Functions",
      docsPath: "functions/docs",
      description: "Serverless compute platform",
    },
    run: {
      name: "Cloud Run",
      docsPath: "run/docs",
      description: "Serverless containers",
    },
    pubsub: {
      name: "Pub/Sub",
      docsPath: "pubsub/docs",
      description: "Messaging and event ingestion",
    },
    sql: {
      name: "Cloud SQL",
      docsPath: "sql/docs",
      description: "Managed relational databases",
    },
    firestore: {
      name: "Firestore",
      docsPath: "firestore/docs",
      description: "NoSQL document database",
    },
    spanner: {
      name: "Cloud Spanner",
      docsPath: "spanner/docs",
      description: "Globally distributed database",
    },
    ai: {
      name: "Vertex AI",
      docsPath: "vertex-ai/docs",
      description: "Machine learning platform",
    },
    vision: {
      name: "Cloud Vision",
      docsPath: "vision/docs",
      description: "Image analysis API",
    },
    speech: {
      name: "Cloud Speech-to-Text",
      docsPath: "speech-to-text/docs",
      description: "Speech recognition API",
    },
    translate: {
      name: "Cloud Translation",
      docsPath: "translate/docs",
      description: "Translation API",
    },
    iam: {
      name: "IAM",
      docsPath: "iam/docs",
      description: "Identity and Access Management",
    },
    vpc: {
      name: "VPC",
      docsPath: "vpc/docs",
      description: "Virtual Private Cloud networking",
    },
    loadbalancing: {
      name: "Cloud Load Balancing",
      docsPath: "load-balancing/docs",
      description: "Global load balancing",
    },
    cdn: {
      name: "Cloud CDN",
      docsPath: "cdn/docs",
      description: "Content delivery network",
    },
    logging: {
      name: "Cloud Logging",
      docsPath: "logging/docs",
      description: "Log management and analysis",
    },
    monitoring: {
      name: "Cloud Monitoring",
      docsPath: "monitoring/docs",
      description: "Infrastructure monitoring",
    },
  };

• src/index.ts:1058-1063 (handler)

  Dispatch case in the MCP server tool call handler that invokes the listGoogleCloudProducts function and returns its result as tool content.

  case "list_google_cloud_products": {
    const result = listGoogleCloudProducts();
    return {
      content: [{ type: "text", text: result }],
    };
  }