{
  "markdown": "# gcloud Extension for Gemini CLI ☁️\n\nThe gcloud\n[Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro)\nserver enables AI assistants to easily interact with the Google Cloud\nenvironment using the gcloud CLI. With the gcloud MCP server you can:\n\n-   **Interact with Google Cloud using natural language.** Describe the outcome\n    you want instead of memorizing complex command syntax, flags, and arguments.\n-   **Automate and simplify complex workflows.** Chain multiple cloud operations\n    into a single, repeatable command to reduce manual effort and the chance of\n    error.\n-   **Lower the barrier to entry for cloud management.** Empower team members\n    who are less familiar with gcloud to perform powerful actions confidently\n    and safely.\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n-   [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm):\n    version 20 or higher\n-   [gcloud CLI](https://cloud.google.com/sdk/docs/install)\n\n## ✨ Install the Extension\n\n### Gemini CLI and Gemini Code Assist\n\nTo integrate this extension with Gemini CLI or Gemini Code Assist, run the setup\ncommand below. This will install the MCP server as a\n[Gemini CLI extension](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md)\nfor the current user, making it available for all your projects. Refer to \n[Gemini CLI extension management](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md#extension-management)\nfor uninstall, disable, enable, and update instructions.\n\n```shell\ngemini extensions install https://github.com/gemini-cli-extensions/gcloud\n```\n\nAfter the initialization process, you can verify that the gcloud-mcp server is\nconfigured correctly by running the following command:\n\n```\ngemini mcp list\n\n> ✓ gcloud: npx -y @google-cloud/gcloud-mcp (stdio) - Connected\n```\n\n### For other AI clients\n\nSee github.com/googleapis/gcloud-mcp for instructions on using the gcloud MCP\nserver with other AI clients.\n\n## 🧰 Available MCP Tools\n\n| Tool                      | Description                     |\n| ------------------------- | ------------------------------- |\n| `run_gcloud_command`      | Executes a gcloud command. Some commands have been restricted from execution by the agent. See [MCP Permissions](#-mcp-permissions) for more information. |\n\n## 🔑 MCP Permissions\n\nThe permissions of the gcloud MCP extension are directly tied to the permissions of the active\ngcloud account. To restrict permissions and operate with the principle of least\nprivilege, you can\n[authorize as a service account using impersonation](https://cloud.google.com/sdk/docs/authorizing#impersonation) and\nassign the service account a\n[role with limited permissions](https://cloud.google.com/iam/docs/roles-overview).\n\nBy default, the gcloud MCP extension prevents execution of gcloud commands that don't\nmake sense for AI agents. This is done to restrict commands that can run\narbitrary inputs and initiate interactive sessions. See\n[here](https://github.com/googleapis/gcloud-mcp/blob/ed743f04272744e57aa4990f5fcd9816a05b03ba/packages/gcloud-mcp/src/index.ts#L29)\nfor the list of denied commands.\n\n## 👥 Contributing\n\nWe welcome contributions! Whether you're fixing bugs, sharing feedback, or\nimproving documentation, your contributions are welcome. Please read our\n[Contributing Guide](CONTRIBUTING.md) to get started.\n\n## 📄 Important Notes\n\nThis repository is currently in preview and may see breaking changes. This\nrepository is providing a solution, not an officially supported Google product.\nIt may break when the MCP specification, other SDKs, or when other solutions and\nproducts change. See also our [Security Policy](SECURITY.md).\n",
  "bytes": 3718,
  "sha": "19d8ed3144e1d25a7210e61b6c19e9ccb786be740969fa1bab1afcdca59c738c",
  "repo_slug": "gemini-cli-extensions/gcloud",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gemini_cli_extensions_gcloud_52f4086c/readme"
}