Gemini Cloud Assist

by googlecloudplatform

Not rated
GitHub

About

An MCP Server that connects to Gemini Cloud Assist APIs, enabling you to manage and troubleshoot your Google Cloud environment using natural language.

Details

Author
googlecloudplatform
Categories
Cloud Service, Other, Infrastructure, AI

Setup

Install Gemini Cloud Assist in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/googlecloudplatform/gemini-cloud-assist-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

What can you do with Gemini Cloud Assist MCP?

- Ask general Google Cloud questions— Get guidance on best practices, architectures, and operations usingask_cloud_assist.
- Design and architect infrastructure— Describe your requirements and usedesign_infrato create infrastructure configurations for Google Cloud.
- Troubleshoot cloud issues— Run deep investigations to find root causes of problems in your environment withinvestigate_issue.
- Manage cloud resources— Create, update, or delete Google Cloud resources directly throughinvoke_operationwhen Agent Actions are enabled.
- Analyze and optimize costs— Get spend breakdowns and identify cost-saving opportunities like idle resources usingoptimize_costs.
- Deploy verified infrastructure designs— Usemanage_applicationto deploy a design after validating it withassess_best_practices.

[!IMPORTANT]Private Preview NoticeThe 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 versionv0.8.0or later. If you wish to continue using the legacy local server during the transition, please pin your configuration to older versions.

This server connectsModel Context Protocol (MCP)clients such as theGemini CLIto theGemini 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] TheGoogle Cloud Platform Terms of Service(available athttps://cloud.google.com/terms/) and theData Processing and Security Terms(available athttps://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 theGemini Cloud Assist overviewin the Google Cloud documentation.

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

- Google Cloud SDKinstalled and configured.
- AGoogle Cloud project.
- The followingIAM roleson 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.

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

# Authenticate your user account to the gcloud CLI gcloud auth login # Set up Application Default Credentials for the server. gcloud auth application-default login

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

Install the MCP server as aGemini CLI extension:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Alternatively, you can manually add the configuration to your~/.gemini/settings.json:

"mcpServers": { "gemini_cloud_assist": { "httpUrl": "https://geminicloudassist.googleapis.com/mcp", "authProviderType": "google_credentials", "oauth": { "scopes": ["https://www.googleapis.com/auth/cloud-platform"] }, "timeout": 600000 }, "application_design_center": { "httpUrl": "https://designcenter.googleapis.com/mcp", "authProviderType": "google_credentials", "oauth": { "scopes": ["https://www.googleapis.com/auth/cloud-platform"] }, "timeout": 600000 } }

Add the following to yourmcp_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" } }

- In your Google Cloud project, create an OAuth 2.0 client ID for a desktop app.
- ConfigureURI://anysphere.cursor-mcp/oauth/callbackas the redirect URL.
- Add or merge the following configuration block:

{ "mcpServers": { "gemini_cloud_assist": { "url": "https://geminicloudassist.googleapis.com/mcp", "auth": { "CLIENT_ID": "${env:OAUTH_CLIENT_ID}", "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}", "scopes": ["https://www.googleapis.com/auth/cloud-platform"] } }, "application_design_center": { "url": "https://designcenter.googleapis.com/mcp", "auth": { "CLIENT_ID": "${env:OAUTH_CLIENT_ID}", "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}", "scopes": ["https://www.googleapis.com/auth/cloud-platform"] } } } }

Follow the configuration instructions for your specific application:

Gemini Cloud Assist is an agent accessible through a set of MCP tools. The agent invoked by MCP tool calls makes its own tool calls internally to Google Cloud. The followingMCP toolsare published for agents to consume:

Application Design Center MCPtools, often orchestrated by GCA’s design_infra tool, manages the infrastructure application lifecycle using Application Design Center, including template management, security compliance and remediation and deployment.

Note:These tools should not be treated as stable APIs. Parameters might be renamed or modified to account for the evolving capabilities of Gemini Cloud Assist.

The Gemini Cloud Assist MCP tools leverageSKILL.mdfiles to instruct your agent on how to properly use the tools. The skills help to guide your agent on chaining together multiple tools into a workstream, passing relevant local information to Gemini Cloud Assist, and enabling explicit invocation.

- If you encounter a bug, please file an issue on ourGitHub Issuespage.
- Before sending a pull request, please review our
Contributing Guide.

This project is licensed under the Apache 2.0 License and provided as-is, without warranty or representation for any use or purpose. For details, see theLICENSEfile.

Manage Kubernetes applications safely by creating and updating Cyclops Modules for AI agents.

Access and manage Google Cloud Platform (GCP) services and resources.

Manage and interact with Google Cloud Platform (GCP) resources through an AI assistant.

Automate Google Cloud Platform infrastructure setup and GitHub repository configuration for cloud-native projects.

An MCP server for interacting with your Google Cloud resources and services.

Enables AI assistants to interact with Kubernetes clusters using natural language.

36 enterprise MCP tools for AWS security, infrastructure generation, AI workflows, and AI agent governance.

Unified API for AI agents to deploy cloud infrastructure across AWS, Azure, and GCP autonomously

Manage Google Cloud Platform (GCP) infrastructure using Terragrunt, with support for experimental features like AutoDevOps and cost management.

Verified GPU compute for humans, applications, and agents.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.