local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables querying and management of Google Cloud Platform resources including Compute Engine, Cloud Storage, Cloud Functions, Cloud Run, BigQuery, Cloud SQL, GKE, Cloud Logging, Cloud Billing and Resource Manager using natural language.
Provides tools for listing and managing Google Kubernetes Engine (GKE) clusters across different regions.

GCP MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA como Claude interactuar con tu entorno de Google Cloud Platform. Esto permite realizar consultas en lenguaje natural y gestionar tus recursos de GCP durante las conversaciones.

Características

🔍 Consultar y modificar recursos de GCP usando lenguaje natural
☁️ Soporte para múltiples proyectos de GCP
🌐 Soporte multirregional
🔐 Manejo seguro de credenciales (ninguna credencial queda expuesta a servicios externos)
🏃‍♂️ Ejecución local con tus credenciales de GCP
🔄 Reintentos automáticos para una mayor confiabilidad

Prerrequisitos

Node.js
Escritorio/Cursor/Windsurf de Claude
Credenciales de GCP configuradas localmente (credenciales predeterminadas de la aplicación)

Instalación

Clonar el repositorio:

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

Instalar dependencias:

npm install

Configuración

Escritorio de Claude

Abra la aplicación de escritorio de Claude y vaya a Configuración -> Desarrollador -> Editar configuración
Agregue la siguiente entrada a su claude_desktop_config.json :

vía npm:

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

Si lo instaló desde la fuente:

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

Reemplace /path/to/gcp-mcp con la ruta real al directorio de su proyecto si usa la instalación de origen.

Cursor

Abra Cursor y vaya a Configuración (⌘,)
Vaya a IA -> Protocolo de contexto del modelo
Agregar una nueva configuración de MCP:

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

Windsurf

Abra ~/.windsurf/config.json (créelo si no existe)
Agregue la configuración de MCP:

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

Configuración de GCP

Configurar las credenciales de GCP:
- Configurar las credenciales predeterminadas de la aplicación usando gcloud auth application-default login
Actualiza tu asistente de IA (Claude Desktop/Cursor/Windsurf)

Uso

Comience seleccionando un proyecto o haciendo preguntas como:

"Enumerar todos los proyectos de GCP a los que tengo acceso"
"Muéstrame todas las instancias de Cloud SQL en el proyecto X"
"¿Cuál es mi estado de facturación actual?"
"Muéstrame los registros de mis servicios de Cloud Run"
"Enumerar todos los clústeres de GKE en us-central1"
"Muéstrame todos los depósitos de Cloud Storage en el proyecto X"
"¿Qué funciones de la nube están implementadas en us-central1?"
"Enumerar todos los servicios de Cloud Run"
"Muéstrame conjuntos de datos y tablas de BigQuery"

Herramientas disponibles

run-gcp-code : ejecuta llamadas a la API de GCP mediante código TypeScript
list-projects : enumera todos los proyectos de GCP accesibles
select-project : Seleccione un proyecto de GCP para operaciones posteriores
get-billing-info : obtener información de facturación para el proyecto actual
get-cost-forecast : obtener el pronóstico de costos para el proyecto actual
get-billing-budget : obtener presupuestos de facturación para el proyecto actual
list-gke-clusters : enumera todos los clústeres de GKE en el proyecto actual
list-sql-instances : enumera todas las instancias de Cloud SQL en el proyecto actual
get-logs : obtener entradas de Cloud Logging para el proyecto actual

Ejemplos de interacciones

Listado de proyectos disponibles:

List all GCP projects I have access to

Seleccione un proyecto:

Use project my-project-id

Comprobar el estado de facturación:

What's my current billing status?

Ver registros:

Show me the last 10 log entries from my project

Servicios soportados

Motor de cómputo de Google
Almacenamiento en la nube
Funciones en la nube
Carrera en la nube
BigQuery
SQL en la nube
Motor Google Kubernetes (GKE)
Registro en la nube
Facturación en la nube
Administrador de recursos
Próximamente habrá más...

Solución de problemas

Para ver los registros:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

Problemas comunes:

Errores de autenticación: asegúrese de haber ejecutado gcloud auth application-default login
Errores de permisos: Verifique los roles de IAM para su cuenta
Errores de API: Verifique que las API requeridas estén habilitadas en su proyecto

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA como Claude interactuar con los entornos de Google Cloud Platform a través del lenguaje natural, lo que permite a los usuarios consultar y administrar recursos de GCP durante las conversaciones.

Related Resources

Reddit Discussion about this server