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

Related MCP server: Kubectl MCP Tool

Prerrequisitos

• Node.js

• Escritorio/Cursor/Windsurf de Claude

• Credenciales de GCP configuradas localmente (credenciales predeterminadas de la aplicación)

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

Configuración

Escritorio de Claude

1. Abra la aplicación de escritorio de Claude y vaya a Configuración -> Desarrollador -> Editar configuración

2. 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

1. Abra Cursor y vaya a Configuración (⌘,)

2. Vaya a IA -> Protocolo de contexto del modelo

3. Agregar una nueva configuración de MCP:

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

Windsurf

1. Abra ~/.windsurf/config.json (créelo si no existe)

2. Agregue la configuración de MCP:

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

Configuración de GCP

1. Configurar las credenciales de GCP:

   • Configurar las credenciales predeterminadas de la aplicación usando gcloud auth application-default login

2. 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

1. run-gcp-code : ejecuta llamadas a la API de GCP mediante código TypeScript

2. list-projects : enumera todos los proyectos de GCP accesibles

3. select-project : Seleccione un proyecto de GCP para operaciones posteriores

4. get-billing-info : obtener información de facturación para el proyecto actual

5. get-cost-forecast : obtener el pronóstico de costos para el proyecto actual

6. get-billing-budget : obtener presupuestos de facturación para el proyecto actual

7. list-gke-clusters : enumera todos los clústeres de GKE en el proyecto actual

8. list-sql-instances : enumera todas las instancias de Cloud SQL en el proyecto actual

9. get-logs : obtener entradas de Cloud Logging para el proyecto actual

Ejemplos de interacciones

1. Listado de proyectos disponibles:

List all GCP projects I have access to

2. Seleccione un proyecto:

Use project my-project-id

3. Comprobar el estado de facturación:

What's my current billing status?

4. 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:

1. Errores de autenticación: asegúrese de haber ejecutado gcloud auth application-default login

2. Errores de permisos: Verifique los roles de IAM para su cuenta

3. 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)