mcp-server-google-logging

What is mcp-server-google-logging?

mcp-server-google-logging is an MCP server that wraps the gcloud CLI to let AI assistants query Google Cloud Logging. It provides a set of logging operations—such as reading, listing, and managing logs, buckets, sinks, and metrics—using natural language prompts. It requires the gcloud CLI, active authentication, and appropriate IAM permissions.

How to use mcp-server-google-logging?

Run the server with Node.js and specify your GCP project ID:
node -- /path/to/mcp-server-google-logging/dist/index.js --project=<project-id>
The server returns log entries in YAML format, containing the content, resource name, and timestamp by default. You can adjust the log query through the MCP client.

Key features of mcp-server-google-logging

• Read logs with timestamp, severity, and resource filters
• List all logs in a project (gcloud logging logs list)
• Manage log buckets (list, describe, update retention)
• Create, update, and delete log sinks for export
• Manage log-based metrics (list, create, update, delete)

Use cases of mcp-server-google-logging

• Troubleshoot OCPP charging sessions by querying status and transaction logs
• Monitor service activities like reservations and admin actions
• Analyze log-based metrics for monitoring and alert triggers
• Export logs to Cloud Storage, BigQuery, or Pub/Sub via sinks

FAQ from mcp-server-google-logging

What are the prerequisites to use this server?

You need the gcloud CLI installed and authenticated, and your account must have the necessary IAM roles to read logging data.

How does the server query logs?

It executes gcloud logging read with optional filters. The output is always in YAML format, and by default only the content, resource name, and timestamp are returned.

What are the limitations of this server?

It cannot filter logs like SQL SELECT; it uses gcloud's filter syntax. Real-time log tailing and log deletion are not supported.

How do I specify the Google Cloud project?

Pass the project ID using the --project=<project-id> parameter when starting the server.

Is authentication handled automatically?

Yes, as long as you are logged into gcloud (gcloud auth login) and have the required IAM permissions for the project.