gcloud-mcp

[](https://github.com/googleapis/gcloud-mcp/actions/workflows/presubmit.yml) [](https://github.com/googleapis/gcloud-mcp/blob/main/LICENSE) # gcloud MCP Server ☁️ The gcloud [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) server enables AI assistants to easily interact with the Google Cloud environment using the gcloud CLI. With the gcloud MCP server you can: - **Interact with Google Cloud using natural language.** Describe the outcome you want instead of memorizing complex command syntax, flags, and arguments. - **Automate and simplify complex workflows.** Chain multiple cloud operations into a single, repeatable command to reduce manual effort and the chance of error. - **Lower the barrier to entry for cloud management.** Empower team members who are less familiar with gcloud to perform powerful actions confidently and safely. ## 📡 Available MCP Servers This repository also hosts other MCP servers in addition to the gcloud MCP server. An up to date list is below, and links to other Google Cloud MCP servers hosted outside of this repo are [here](#-other-google-cloud-mcp-servers). | MCP Server Name | Description | Package Name | Version | | :-------------- | :---------------------------------------------------------------------------- | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------- | | gcloud | Interact with Google Cloud via the gcloud CLI using natural language prompts. | `gcloud-mcp` | [](https://www.npmjs.com/package/@google-cloud/gcloud-mcp) | | observability | Access Google Cloud Observability APIs to query logs, metrics, and traces. | `observability-mcp` | [](https://www.npmjs.com/package/@google-cloud/observability-mcp) | | storage | Interact with Google Cloud Storage for bucket and object management. | `storage-mcp` | [](https://www.npmjs.com/package/@google-cloud/storage-mcp) | ## 🚀 Getting Started ### Prerequisites - [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm): version 20 or higher - [gcloud CLI](https://cloud.google.com/sdk/docs/install) ## ✨ Set up your MCP server ### Gemini CLI and Gemini Code Assist To integrate MCP servers with Gemini CLI or Gemini Code Assist, run the setup command below from your home directory for MCP server listed in the table. This will install the MCP server as a [Gemini CLI extension](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md). for the current user, making it available for all your projects. ```shell npx @google-cloud/[PACKAGE_NAME] init --agent=gemini-cli ``` For example, for the gcloud-mcp: ```shell npx @google-cloud/gcloud-mcp init --agent=gemini-cli ``` After the initialization process, you can verify that the gcloud-mcp server is configured correctly by running the following command: ``` gemini mcp list > ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected ``` ### For other AI clients To use MCP servers in this repo with other clients, add the following snippet to their respective JSON configuration files for each MCP server: ```json "[SERVER_NAME]": { "command": "npx", "args": ["-y", "@google-cloud/[PACKAGE_NAME]"] } ``` For example, for gcloud: ```json "gcloud": { "command": "npx", "args": ["-y", "@google-cloud/gcloud-mcp"] } ``` Instructions for popular tools: - **Claude Desktop:** Open **Claude > Settings > Developer > Edit Config** and edit `claude_desktop_config.json`. - **Cline:** Click the MCP Servers icon, then **Configure MCP Servers** to edit `cline_mcp_settings.json`. - **Cursor:** Edit `.cursor/mcp.json` for a single project or `~/.cursor/mcp.json` for all projects. - **Gemini CLI (Manual Setup):** [If not using extensions](#gemini-cli-and-gemini-code-assist), edit `.gemini/settings.json` for a single project or `~/.gemini/settings.json` for all projects. For **Visual Studio Code** edit the `.vscode/mcp.json` file in your workspace for a single project or your global user settings file for all projects: ```json "servers": { "[SERVER_NAME]": { "command": "npx", "args": ["-y", "@google-cloud/[PACKAGE_NAME]"] } } ``` For example, for gcloud and observability: ```json "servers": { "gcloud": { "command": "npx",