Servidor MCP de Google Cloud

Un servidor de protocolo de contexto de modelo que se conecta a los servicios de Google Cloud para proporcionar contexto y herramientas para interactuar con sus recursos de Google Cloud.

Servicios

Servicios soportados:

[x] Registro de Google Cloud
[x] Monitoreo de Google Cloud
[x] Llave inglesa de Google Cloud

Servidores en desarrollo:

[ ] Rastreo de Google Cloud
[ ] Google IAM
[ ] Computación en la nube de Google
[ ] Google Cloud Run
[ ] Almacenamiento en la nube de Google

Registro de Google Cloud

Consultar y filtrar entradas de registro de Google Cloud Logging:

Consultar registros con filtros personalizados
Buscar registros dentro de rangos de tiempo específicos
Formatear y mostrar las entradas del registro en un formato legible

Llave inglesa de Google Cloud

Interactuar con las bases de datos de Google Cloud Spanner:

Ejecutar consultas SQL en bases de datos Spanner
Lista de bases de datos y tablas disponibles
Explorar el esquema de la base de datos

Monitoreo de Google Cloud

Recupere y analice métricas de Google Cloud Monitoring:

Métricas de consulta con filtros personalizados
Visualizar datos métricos a lo largo del tiempo
Lista de tipos de métricas disponibles

Rastreo de Google Cloud

Analizar seguimientos distribuidos desde Google Cloud Trace:

Recuperar rastros por ID
Lista de rastros recientes con opciones de filtrado
Encuentre rastros asociados con registros
Identificar rastros fallidos
Utilice lenguaje natural para consultar los seguimientos (por ejemplo, "Muéstrame los seguimientos fallidos de la última hora")

Autenticación

Este servidor admite dos métodos de autenticación con Google Cloud:

Archivo de clave de cuenta de servicio (recomendado): Establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS con la ruta del archivo de clave de su cuenta de servicio. Este es el método de autenticación estándar de Google Cloud.
Variables de entorno : Establezca directamente las variables de entorno GOOGLE_CLIENT_EMAIL y GOOGLE_PRIVATE_KEY . Esto resulta útil en entornos donde no es práctico almacenar un archivo de clave.

El servidor también utilizará la variable de entorno GOOGLE_CLOUD_PROJECT si está configurada; de lo contrario, intentará determinar el ID del proyecto a partir de las credenciales de autenticación.

Instalación

# Clone the repository
git clone https://github.com/krzko/google-cloud-mcp.git
cd google-cloud-mcp

# Install dependencies
pnpm install

# Build
pnpm build

Autenticarse en Google Cloud:

gcloud auth application-default login

Configure los mcpServers en su cliente:

{
  "mcpServers": {
      "google-cloud-mcp": {
          "command": "node",
          "args": [
              "/Users/foo/code/google-cloud-mcp/dist/index.js"
          ],
          "env": {
              "GOOGLE_APPLICATION_CREDENTIALS": "/Users/foo/.config/gcloud/application_default_credentials.json"
          }
      }
  }
}

Desarrollo

Iniciando el servidor

# Build the project
pnpm build

# Start the server
pnpm start

Modo de desarrollo

# Build the project
pnpm build

# Start the server and inspector
npx -y @modelcontextprotocol/inspector node dist/index.js

Uso con herrería (próximamente)

Este servidor se puede implementar y usar con Smithery. El servidor implementa la carga diferida de la autenticación, lo que significa que se iniciará inmediatamente y la pospondrá hasta que sea realmente necesaria. La autenticación sigue siendo necesaria para el funcionamiento, pero este enfoque evita tiempos de espera durante la inicialización del servidor.

NOTA: La compatibilidad con servidores locales de Smithery se encuentra actualmente en desarrollo y es posible que aún no esté disponible.

Solución de problemas

Problemas de tiempo de espera del servidor

Si encuentra problemas de tiempo de espera al ejecutar el servidor con Smithery, intente lo siguiente:

Habilite el registro de depuración configurando debug: true en su configuración
Asegúrese de que lazyAuth: true esté configurado para diferir la autenticación hasta que realmente sea necesaria
Asegúrese de que su archivo de credenciales sea accesible y válido
Revise los registros para ver si hay mensajes de error

Importante : aún se requiere autenticación para la operación, pero con la carga diferida habilitada, el servidor se iniciará inmediatamente y se autenticará cuando sea necesario en lugar de hacerlo durante la inicialización.

Problemas de autenticación

El servidor admite dos métodos de autenticación:

Archivo de clave de cuenta de servicio : establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de su archivo de clave de cuenta de servicio
Variables de entorno : Establezca las variables de entorno GOOGLE_CLIENT_EMAIL y GOOGLE_PRIVATE_KEY

Si tiene problemas de autenticación, asegúrese de:

Su cuenta de servicio tiene los permisos necesarios
El archivo de clave está correctamente formateado y es accesible
Las variables de entorno están configuradas correctamente

Google Cloud MCP Server

Integrations