Gemini Cloud Assist MCP server

Gemini Cloud Assist MCP server

[!IMPORTANT]

Private Preview Notice

The Gemini Cloud Assist MCP server APIs are currently in Private Preview and are behind an allowlist. Please contact your Google Cloud account team to request access.

[!WARNING]

Deprecation Notice & Migration to Remote MCP Server

The Gemini Cloud Assist MCP server has migrated from a local Node.js architecture to a Remote MCP Server architecture. The older local Node.js server will lose support in the coming months.

To use the new Remote MCP Servers, please use version v0.8.0 or later. If you wish to continue using the legacy local server during the transition, please pin your configuration to older versions.

This server connects Model Context Protocol (MCP) clients to the Gemini Cloud Assist APIs. It allows you to use natural language to understand, manage, and troubleshoot your Google Cloud environment directly from the local command line.

[!NOTE]

The Google Cloud Platform Terms of Service (available at https://cloud.google.com/terms/) and the Data Processing and Security Terms (available at https://cloud.google.com/terms/data-processing-terms) do not apply to any component of the Gemini Cloud Assist MCP Server software.

To learn more about Gemini Cloud Assist, see the Gemini Cloud Assist overview in the Google Cloud documentation.

✨ Key features

• Design infrastructure: Create and architect infrastructure configurations for Google Cloud.
• Troubleshoot issues: Run deep investigations to find the root cause of complex issues in your Google Cloud environment.
• Manage resources: Create, update, and delete Google Cloud resources directly from your chat workflow (requires Agent Actions).
• Optimize costs: Analyze your spend, track costs, and identify opportunities for efficiency such as idle resources.
• Get general assistance: Ask questions and get guidance on Google Cloud best practices, architectures, and operations.

Quick start

Before you begin, ensure you have the following set up:

• Google Cloud SDK installed and configured.
• A Google Cloud project.
• The following IAM roles on your user account:
• roles/serviceusage.serviceUsageAdmin: Required to enable the Cloud Assist APIs.
• roles/geminicloudassist.user: Required to make requests to the Cloud Assist APIs.

Step 1: Authenticate to Google Cloud

The Gemini Cloud Assist MCP server uses local Application Default Credentials (ADC) to securely authenticate to Google Cloud. To set up ADC, run the following gcloud commands:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

Configure your MCP client

The client-agent configuration depends on which agent you are using.

Antigravity

Add the following to your mcp_config.json:

"mcpServers": {
  "gemini_cloud_assist": {
    "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  },
  "application_design_center": {
    "serverUrl": "https://designcenter.googleapis.com/mcp",
    "headers": {},
    "authProviderType": "google_credentials"
  }
}

Cursor

Shortened. The full README is on GitHub.