Skip to content
Back to search

gcp-mcp

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Google Cloud Platform environment. This allows for natural language querying and management of your GCP resources during conversations.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eniayomi--gcp-mcp/badge.svg)](/listings/eniayomi--gcp-mcp)

HTML

<a href="/listings/eniayomi--gcp-mcp"><img src="/api/listings/eniayomi--gcp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone the repository:

git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp

2. Install dependencies:

npm install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # GCP MCP
  2. A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Google Cloud Platform environment. This allows for natural language querying and management of your GCP resources during conversations.
  3. ![GCP MCP Demo](images/claude.png)
  4. ## Features
  5. * 🔍 Query and modify GCP resources using natural language
  6. * ☁️ Support for multiple GCP projects
  7. * 🌐 Multi-region support
  8. * 🔐 Secure credential handling (no credentials are exposed to external services)
  9. * 🏃‍♂️ Local execution with your GCP credentials
  10. * 🔄 Automatic retries for improved reliability
  11. ## Prerequisites
  12. * Node.js
  13. * Claude Desktop/Cursor/Windsurf
  14. * GCP credentials configured locally (application default credentials)
  15. ## Installation
  16. 1. Clone the repository:
  17. ```bash
  18. git clone https://github.com/eniayomi/gcp-mcp
  19. cd gcp-mcp
  20. ```
  21. 2. Install dependencies:
  22. ```bash
  23. npm install
  24. ```
  25. ## Configuration
  26. ### Claude Desktop
  27. 1. Open Claude desktop app and go to Settings -> Developer -> Edit Config
  28. 2. Add the following entry to your `claude_desktop_config.json`:
  29. via npm:
  30. ```json
  31. {
  32. "mcpServers": {
  33. "gcp": {
  34. "command": "sh",
  35. "args": ["-c", "npx -y gcp-mcp"]
  36. }
  37. }
  38. }
  39. ```
  40. If you installed from source:
  41. ```json
  42. {
  43. "mcpServers": {
  44. "gcp": {
  45. "command": "npm",
  46. "args": [
  47. "--silent",
  48. "--prefix",
  49. "/path/to/gcp-mcp",
  50. "start"
  51. ]
  52. }
  53. }
  54. }
  55. ```
  56. Replace `/path/to/gcp-mcp` with the actual path to your project directory if using source installation.
  57. ### Cursor
  58. 1. Open Cursor and go to Settings (⌘,)
  59. 2. Navigate to AI -> Model Context Protocol
  60. 3. Add a new MCP configuration:
  61. ```json
  62. {
  63. "gcp": {
  64. "command": "npx -y gcp-mcp"
  65. }
  66. }
  67. ```
  68. ### Windsurf
  69. 1. Open `~/.windsurf/config.json` (create if it doesn't exist)
  70. 2. Add the MCP configuration:
  71. ```json
  72. {
  73. "mcpServers": {
  74. "gcp": {
  75. "command": "npx -y gcp-mcp"
  76. }
  77. }
  78. }
  79. ```
  80. ### GCP Setup
  81. 1. Set up GCP credentials:
  82. - Set up application default credentials using `gcloud auth application-default login`
  83. 2. Refresh your AI assistant (Claude Desktop/Cursor/Windsurf)
  84. ## Usage
  85. Start by selecting a project or asking questions like:
  86. * "List all GCP projects I have access to"
  87. * "Show me all Cloud SQL instances in project X"
  88. * "What's my current billing status?"
  89. * "Show me the logs from my Cloud Run services"
  90. * "List all GKE clusters in us-central1"
  91. * "Show me all Cloud Storage buckets in project X"
  92. * "What Cloud Functions are deployed in us-central1?"
  93. * "List all Cloud Run services"
  94. * "Show me BigQuery datasets and tables"
  95. ## Available Tools
  96. 1. `run-gcp-code`: Execute GCP API calls using TypeScript code
  97. 2. `list-projects`: List all accessible GCP projects
  98. 3. `select-project`: Select a GCP project for subsequent operations
  99. 4. `get-billing-info`: Get billing information for the current project
  100. 5. `get-cost-forecast`: Get cost forecast for the current project
  101. 6. `get-billing-budget`: Get billing budgets for the current project
  102. 7. `list-gke-clusters`: List all GKE clusters in the current project
  103. 8. `list-sql-instances`: List all Cloud SQL instances in the current project
  104. 9. `get-logs`: Get Cloud Logging entries for the current project
  105. ## Example Interactions
  106. 1. List available projects:
  107. ```
  108. List all GCP projects I have access to
  109. ```
  110. 2. Select a project:
  111. ```
  112. Use project my-project-id
  113. ```
  114. 3. Check billing status:
  115. ```
  116. What's my current billing status?
  117. ```
  118. 4. View logs:
  119. ```
  120. Show me the last 10 log entries from my project
  121. ```
  122. ## Supported Services
  123. * Google Compute Engine
  124. * Cloud Storage
  125. * Cloud Functions
  126. * Cloud Run
  127. * BigQuery
  128. * Cloud SQL
  129. * Google Kubernetes Engine (GKE)
  130. * Cloud Logging
  131. * Cloud Billing
  132. * Resource Manager
  133. * More coming soon...
  134. ## Troubleshooting
  135. To see logs:
  136. ```bash
  137. tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log
  138. ```
  139. Common issues:
  140. 1. Authentication errors: Ensure you've run `gcloud auth application-default login`
  141. 2. Permission errors: Check IAM roles for your account
  142. 3. API errors: Verify that required APIs are enabled in your project
  143. ## Contributing
  144. Contributions are welcome! Please feel free to submit a Pull Request.
  145. ## License
  146. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.