Building with the Developer Knowledge API and Antigravity CLI

agy

cd ~
git clone https://github.com/xbill9/knowledge-api-agy

cd knowledge-api-agy
source init.sh

cd knowledge-api-agy
source set_env.sh

> what does @[init.sh] do?

● Read(/root/knowledge-api-agy/init.sh) (ctrl+o to expand)

▸ Thought for 1s, 504 tokens
  Initiating Project Identification
  The init.sh script is the main setup utility used to configure a Google Cloud Project for the Google      
  Developer Knowledge MCP server.

  Here is a breakdown of what the script does step-by-step:

  1. Sets the GCP Project ID: Prompts you for a Google Cloud project ID (defaulting to the contents of             
  ~/project_id.txt if it exists) and saves it back to that file.
  2. Sources Environment Variables: Runs source ./set_env.sh to configure the active project environment and sets
  the default compute region to us-central1 .
  3. Enables Required APIs: Automatically enables the necessary Google Cloud services:
      • Vertex AI ( aiplatform.googleapis.com )
      • Compute Engine ( compute.googleapis.com )
      • Developer Knowledge API ( developerknowledge.googleapis.com )
      • API Keys API ( apikeys.googleapis.com )
  4. Enables the MCP Server: Runs the gcloud beta services mcp enable command for the Developer Knowledge service.
  5. Configures the API Key:
      • Searches for or creates a dedicated API key named "DK API Key" .
      • Restricts the API key specifically to the Developer Knowledge API ( developerknowledge.googleapis.com ) for
      security.
      • Retrieves the raw API key string and exports it as DK_API_KEY .
  6. Updates Local Configuration: Generates/updates the mcp_config.json file with the server URLs and authenticates
  headers using the newly generated key.
  7. Performs Environment & Credential Checks: Identifies whether the script is running in Cloud Shell, on a VM, or
  locally. If running locally and Application Default Credentials (ADC) are not set, it prompts you to log in via  
  gcloud auth application-default login .

> what does @[set_env.sh] do?
      • Searches for or creates a dedicated API key named "DK API Key" .
● Read(/root/knowledge-api-agy/set_env.sh) (ctrl+o to expand)

  The set_env.sh helper script exports common Google Cloud environment variables to your current shell session.
  It is designed to be sourced (i.e. source ./set_env.sh ).

  Here is a summary of what the script does:

  1. Checks Authentication: Verifies that your gcloud CLI is logged in. If not, it warns you to run gcloud auth 
  login and exits early.
  2. Configures the GCP Project: Reads the project ID from your project file (default: ~/project_id.txt ) and sets
  it as your active gcloud project.
  3. Exports Core Google Cloud Variables:
      • PROJECT_ID & GOOGLE_CLOUD_PROJECT : The ID of your GCP Project.
      • PROJECT_NUMBER : The numeric ID of your GCP Project.
      • SERVICE_ACCOUNT_NAME : The default Compute Engine service account name for the project.
      • GOOGLE_CLOUD_LOCATION & REGION : The deployment region (defaults to us-central1 ).
  4. Exports Application & Auth Tokens:
      • ID_TOKEN : Generates a Google identity token using gcloud auth print-identity-token .
      • GOOGLE_GENAI_USE_VERTEXAI : Set to "TRUE" to route Google GenAI SDK calls through Vertex AI.
      • SHORT_SHA : The current short git commit hash (or "none" if outside a git repo) for versioning/tagging
      builds.
      • DK_API_KEY : Fetches and exports the restricted API key string for the Developer Knowledge API if the key
      exists.

{
  "mcpServers": {
    "google-dev-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "$DK_API_KEY"
      }
    }
  }
}

/mcp list

MCP Servers

Plugins (~/.gemini/antigravity-cli/plugins)
> ✓ google-dev-knowledge Tools: search_documents, answer_query, get_documents

Keyboard: ↑/↓ Navigate enter Actions

> use the developer knowledge API - what are the gcloud commands to create a google cloud bucket?

● ListDir(/root/.gemini/antigravity-cli/mcp/google-dev-knowledge)
● Read(/root/.gemini/antigravity-cli/mcp/google-dev-knowledge/answer_query.json)
● google-dev-knowledge/answer_query(Answer query with knowledge API) (ctrl+o to expand)

MCP
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

  answer_query (server: google-dev-knowledge)

Do you want to proceed?
  1. Yes
  2. Yes, and always allow 'google-dev-knowledge/answer_query' in this conversation
> 3. Yes, and always allow 'google-dev-knowledge/answer_query' (Persist to settings.json)
  4. No
  5. No, and always deny 'google-dev-knowledge/answer_query' in this conversation
  6. No, and always deny 'google-dev-knowledge/answer_query' (Persist to settings.json)

 According to the official Google Developer Knowledge API, here are the gcloud commands and options for creating
  a Google Cloud Storage bucket:

  ### 1. Basic Bucket Creation

  To create a standard bucket with a globally unique name and uniform bucket-level access (recommended for
  security):

    gcloud storage buckets create gs://BUCKET_NAME/ --uniform-bucket-level-access                                  

  • BUCKET_NAME : Must be globally unique and contain only lowercase letters, numbers, dashes ( - ), underscores (
  _ ), and dots ( . ).
  ──────
  ### 2. Advanced Creation Options

  You can configure location, default storage class, and specialized features by appending flags:

  • Specify Location: Set where the bucket's data is stored (e.g., US , us-east1 ):
    gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION                                      

  • Enable Hierarchical Namespace: Enables structured folders (cannot be enabled after creation). This also
  requires enabling uniform bucket-level access:
    gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --uniform-bucket-level-access --     
  enable-hierarchical-namespace

  • Specify Storage Class: Set the default class (e.g., STANDARD , NEARLINE , COLDLINE , ARCHIVE ):
    gcloud storage buckets create gs://BUCKET_NAME --default-storage-class=STORAGE_CLASS

  • Zonal Storage: For zonal-specific placements:
    gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION --placement=BUCKET_ZONE --default-   
  storage-class=RAPID --enable-hierarchical-namespace --uniform-bucket-level-access

  • Explicit Project Scoping: Link the bucket to a specific project:
    gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID

  ──────
  ### Common Flags Reference

   Flag | Description
  -----------------------------------|-----------------------------------------------------------------------------
    --location | The geographic region or multi-region.
    --uniform-bucket-level-access | Uniformly manages permissions at the bucket level (security best practice).
    --enable-hierarchical-namespace | Enables true directory/folder layouts (immutable after creation).
    --default-storage-class | Sets the default storage tier for uploaded files.
    --project | Targets a specific Google Cloud project.

> what is the Google Developer Knowledge API?

● google-dev-knowledge/answer_query(Query Developer Knowledge API) (ctrl+o to expand)

  According to the Google Developer Knowledge API (retrieved directly via the API itself), it is a programmatic
  interface providing machine-readable access to Google's official public developer documentation.

  It acts as the canonical source to integrate Google's technical documentation into third-party tools, IDEs, and
  AI
  workflows.

  ### Key Capabilities

  • Search: Find relevant page URIs and content snippets based on queries.
  • Retrieve: Fetch full developer documentation pages structured in Markdown format.
  • Grounded Generation: Synthesize answers to technical questions that are directly grounded in Google's official
  docs (preventing hallucinations).
  ──────
  ### Scope of the Corpus

  The API covers a broad range of Google developer domains:

  • Google Cloud: GCP services ( docs.cloud.google.com ), Firebase, and Apigee.
  • Platforms & Languages: Android, Chrome, Go, TensorFlow, and Web.dev.
  • Developer APIs: Google AI ( ai.google.dev ), Gemini, Ads, Search, Maps, and YouTube.
  • Data Freshness: The index is updated every 24 to 48 hours to ensure documentation is always current.
  ──────
  ### Integration and Access

  • API Endpoint: developerknowledge.googleapis.com 
  • Authentication: Uses Google Cloud API Keys (restricted to the Developer Knowledge API) or OAuth credentials.
  • Model Context Protocol (MCP): It supports MCP, enabling AI agents and LLMs to interact with Google's
  documentation as a tool to assist developers with troubleshooting, code generation, and finding best practices.