Google Cloud Logging

★ 11

from swen128

An MCP server for accessing Google Cloud Logging data and services.

🔥🔥🔥✓ VerifiedFreeAdvanced setup

Google Cloud Logging MCP Server

A Model Context Protocol (MCP) server that provides access to Google Cloud Logging. This server allows AI assistants to query, search, and analyze logs from Google Cloud Platform projects.

Features

Query Logs: Search and filter logs across GCP projects
Get Log Details: Retrieve detailed information about specific log entries
List Projects: List available GCP projects

Common Filter Examples

By severity: severity>=ERROR
By time range: timestamp>="2024-01-01T00:00:00Z"
By resource: resource.type="cloud_run_revision"
By text search: textPayload:"connection timeout"
Combined: resource.type="k8s_container" AND severity=ERROR AND timestamp>="2024-01-01T00:00:00Z"

Development

# Run tests
bun test

# Type checking
bun run typecheck

# Linting
bun run lint

# Format code
bun run format

Architecture

The server follows a clean architecture pattern:

/adapter: External service integrations (Google Cloud APIs)
/domain: Core business logic and data models
/port: Interface definitions and MCP tool handlers
/util: Utility functions and helpers

License

MIT

Getting Started

Prerequisites

Bun runtime
Google Cloud credentials configured
Access to Google Cloud Logging API

Quick Start

Install dependencies:
```
bun install
```

Set up Google Cloud credentials:

# Option 1: Use gcloud CLI
gcloud auth application-default login

# Option 2: Use service account
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"

Set your project ID:

export GOOGLE_CLOUD_PROJECT="your-project-id"

Run the server:
```
bun run start
```

Using with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cloud-logging": {
      "command": "bun",
      "args": ["run", "/path/to/cloud-logging-mcp/src/main.ts"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "your-project-id"
      }
    }
  }
}

Example Tool Usage

Query Logs

Search and filter logs from Google Cloud Logging.

{
  "tool": "queryLogs",
  "input": {
    "projectId": "my-project",
    "filter": "resource.type=\"cloud_run_revision\" AND severity>=ERROR",
    "orderBy": {
      "timestamp": "desc"
    },
    "pageSize": 50
  }
}

Parameters:

projectId: GCP project ID
filter: Log filter query (follows GCP logging query syntax)
orderBy: Sort order for results
pageSize: Number of results per page
pageToken: Token for pagination
resourceNames: Specific log resources to query
summaryFields: Fields to include in the summary

Get Log Detail

Retrieve complete details for a specific log entry.

{
  "tool": "getLogDetail",
  "input": {
    "projectId": "my-project",
    "logId": "65f5a7b60000000001234567"
  }
}